# QQ.com — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access the latest news, articles, stock indices, and sports schedules from QQ.com's homepage, and search across multiple news categories to stay informed on hot topics and evening reports. Get real-time data including homepage content, images, links, and live sports schedules all from one unified service.

**Category:** News & Media | **Website:** [qq.com/](https://qq.com/) | **Docs:** [parse.bot/marketplace/ead1c658-3f87-4675-a996-3fc1b56641e3/qq-com-api](https://parse.bot/marketplace/ead1c658-3f87-4675-a996-3fc1b56641e3/qq-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get article

Fetches the full content of a QQ News article given its URL. Extracts the article title, body text content, and embedded image URLs. Works with articles on view.inews.qq.com. Content extraction uses embedded page data when available, falling back to HTML parsing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the article to extract, typically in the format https://view.inews.qq.com/a/<article_id>. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-article \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get category news

Fetches news articles for a specific category channel from QQ News. Returns hot_module (trending articles) and collection_article (curated videos/articles) arrays with titles, URLs, thumbnails, publish times, and interaction counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Channel ID for the news category. Known values: news_news_tech (technology), news_news_sports (sports), news_news_finance (finance), news_news_ent (entertainment), news_news_mil (military). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-category-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### Get evening report

Filters homepage links for items containing '晚报' (evening report). Returns matching links with text and URL. May return an empty array if no evening report links are present at the time of request.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-evening-report \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get homepage

Extracts structured content from the qq.com homepage including navigation links, images, and text elements. Returns all anchor-tag links with their text and URL, all images with source URLs, alt text, and parent context, and text strings from link elements. Headlines and sections arrays may be empty depending on current page structure.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-homepage \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get homepage images

Extracts all images from the qq.com homepage. Each image includes its source URL, alt text, and context text from its parent element. Useful for discovering visual content and thumbnails displayed on the main page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-homepage-images \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get homepage links

Extracts all article links from the qq.com homepage. Each link includes its visible text and full URL. Covers navigation links, article headlines, and footer links.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-homepage-links \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get homepage text

Extracts all text elements from the qq.com homepage, gathered from anchor tags. Useful for getting a quick overview of all navigation and content labels visible on the page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-homepage-text \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get hot topics

Fetches the hot topics ranking list from QQ News. Returns trending news articles ranked by popularity with hot scores, read counts, and comment counts. Each item includes hotEvent metadata with ranking position and score.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offset` | integer | No | Offset for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-hot-topics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"offset":"<integer>"}'
```

### Get sports schedule

Fetches sports match schedules from QQ Sports. Returns upcoming and recent matches with team names, scores, start times, competition info, and live streaming details. Supports filtering by competition ID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition_id` | string | No | Competition ID. Known values: 100000 (NBA). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-sports-schedule \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"competition_id":"<string>"}'
```

### Get stock indices

Fetches major stock market indices including Shanghai Composite (000001), Shenzhen Component (399001), ChiNext (399006), STAR 50 (000688), CSI 300 (000300), Hang Seng, Dow Jones, Nasdaq, and S&P 500. Returns current price, change amount, and percent change for each index.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-stock-indices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get today hot broadcast

Fetches today's top 10 hot broadcast items from the QQ News hot ranking. Each item includes a title, article URL, and hotEvent metadata with ranking position, hot score, and search keywords.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/get-today-hot-broadcast \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search news

Searches QQ News articles by keyword. Returns paginated results including article titles, URLs, abstracts, thumbnails, source info, and comment counts. Results are grouped into sections (secList) by type (articles, video, accounts). Supports pagination via page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting from 0. |
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/qq-com/search-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.