# QQ.com — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_category_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_evening_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_homepage_images \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_homepage_links \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_homepage_text \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_hot_topics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_sports_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_stock_indices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/get_today_hot_broadcast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-qq-com-api-ead1c658/search_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```