# Social data (beta)

> Part of the ChinaAPI documentation. HTML: https://dash.chinaapi.ai/docs/api/social-data/

`GET /v1/social/{platform}/{capability}` returns public data from Douyin, Xiaohongshu, TikTok, YouTube and other social platforms, with the same API key and balance as your model calls. Each platform and capability is priced per successful call, and `data` is the platform's own response — fields are not normalized across platforms.

**GET /v1/social/{platform}/{capability}**

```
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'

# HTTP 200
# {"object": "social.result", "platform": "tiktok", "capability": "search", "data": {...}}
```

> [!NOTE]
> Beta: paid accounts only
>
> Complete your first top-up before calling. Trial credit cannot be spent on these endpoints; an account that has never topped up gets HTTP 403 `model_requires_topup`. The beta has no SLA, and its platforms, endpoints and prices may change.

## Authentication and billing

Send your ChinaAPI key as a bearer token to `https://api.chinaapi.ai`, as for any model call. A call is charged once, at the price listed for its endpoint, only when it returns HTTP 200 with data; an empty result, a rejected parameter or a failed upstream costs nothing. Every page you fetch is a separate call. Your usage log lists each call under the name shown with its endpoint, such as `social-douyin-search`.

## Responses and errors

A successful response wraps the platform's data in a small envelope. Everything inside `data` — field names, pagination cursors, IDs — is the platform's own; pass cursors back exactly as you received them.

```json
{
  "object": "social.result",
  "platform": "douyin",
  "capability": "search",
  "data": { "...": "the platform's own fields" }
}
```

- **400** — a parameter is unknown, repeated, too long, of the wrong type or missing, including when no member of an "at least one of" group is given. The error `code` says which, such as `unknown_parameter` or `missing_parameter`.
- **403** `model_requires_topup` — the account has not completed its first top-up.
- **404** — the platform and capability pair does not exist, or the platform found nothing for these parameters (`social_data_no_result`).
- **429** `social_data_capacity_reached` — the beta's capacity for the day is used up and resets at 00:00 UTC, or the platform is busy and a retry a few seconds later will do. Do not retry in a tight loop.
- **502** — the data source did not answer, or answered without data.
- **503** `social_data_unavailable` — this endpoint is paused right now; the live catalog lists it as `paused`.

None of these responses is charged.

## Acceptable use

Follow each platform's terms and the data-protection rules that apply to you. Do not use this API to build profiles of individuals. Logging in, extracting contact details, manipulating engagement and reaching private or paid content are outside this beta.

## Platforms and prices

USD per successful call. Each price links to its endpoint below, and a dash means the platform does not offer that capability. The live catalog — `GET https://dash.chinaapi.ai/api/social/catalog`, no key needed — is the authority on what is on sale right now, including any endpoint that is paused.

| Platform | Search posts | Post details | Profiles | Comments | User posts | Trending |
|---|---|---|---|---|---|---|
| Douyin | $0.02 | $0.002 | $0.006 | $0.002 | $0.002 | $0.002 |
| Xiaohongshu (RED) | $0.02 | $0.02 | $0.02 | $0.02 | $0.02 | — |
| Kuaishou | $0.02 | $0.002 | $0.02 | $0.002 | $0.02 | $0.002 |
| Bilibili | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 |
| Weibo | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 | $0.003 |
| Zhihu | $0.002 | $0.002 | $0.002 | $0.002 | — | $0.002 |
| WeChat Channels | $0.02 | $0.02 | $0.02 | $0.02 | $0.02 | — |
| WeChat Official Accounts | $0.02 | $0.02 | $0.02 | $0.02 | $0.02 | — |
| WeChat Search | $0.02 | — | — | — | — | — |
| Toutiao | — | $0.002 | $0.002 | $0.002 | — | — |
| Xigua Video | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 | — |
| Pipixia | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 |
| TikTok | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 |
| Instagram | $0.004 | $0.002 | $0.002 | $0.004 | $0.004 | $0.016 |
| YouTube | $0.004 | $0.002 | $0.002 | $0.002 | $0.002 | — |
| X (Twitter) | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 |
| Reddit | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 | $0.002 |
| LinkedIn | — | $0.002 | $0.016 | $0.1 | $0.1 | — |
| Threads | $0.004 | $0.004 | $0.004 | — | $0.004 | — |
| Lemon8 | $0.002 | $0.002 | $0.002 | $0.002 | — | $0.002 |

## Endpoints

Parameters go in the query string under the platform's own names. Examples come from the catalog; replace identifiers with the content you want to retrieve.

### Douyin

#### Douyin · Search posts

- **Endpoint**: `GET /v1/social/douyin/search`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-douyin-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"猫咪"` | Keyword |
| `cursor` | integer | No | — | `0` | Offset cursor for pagination, obtained from the last response |
| `sort_type` | string | No | — | `"0"` | Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest |
| `publish_time` | string | No | — | `"0"` | Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year |
| `filter_duration` | string | No | — | `"0"` | Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes |
| `content_type` | string | No | — | `"0"` | Content type: 0=All, 1=Video, 2=Picture, 3=Article |
| `search_id` | string | No | — | `""` | Search ID for pagination, obtained from the last response |
| `backtrace` | string | No | — | `""` | Backtrace for pagination, obtained from the last response |

```bash
curl --get "https://api.chinaapi.ai/v1/social/douyin/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=猫咪'
```

#### Douyin · Post details

- **Endpoint**: `GET /v1/social/douyin/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-douyin-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `share_url` | string | Yes | — | `"https://v.douyin.com/e3x2fjE/"` | Share link |

```bash
curl --get "https://api.chinaapi.ai/v1/social/douyin/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'share_url=https://v.douyin.com/e3x2fjE/'
```

#### Douyin · Profiles

- **Endpoint**: `GET /v1/social/douyin/user`
- **Price**: $0.006 per successful call
- **Usage log name**: `social-douyin-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `sec_user_id` | string | Yes | — | `"MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y"` | User sec_user_id |

```bash
curl --get "https://api.chinaapi.ai/v1/social/douyin/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'sec_user_id=MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y'
```

#### Douyin · Comments

- **Endpoint**: `GET /v1/social/douyin/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-douyin-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `aweme_id` | string | Yes | — | `"7372484719365098803"` | Video id |
| `cursor` | integer | No | — | `0` | Cursor |
| `count` | integer | No | — | `20` | Number |

```bash
curl --get "https://api.chinaapi.ai/v1/social/douyin/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'aweme_id=7372484719365098803'
```

#### Douyin · User posts

- **Endpoint**: `GET /v1/social/douyin/user-posts`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-douyin-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `sec_user_id` | string | Yes | — | `"MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE"` | User sec_user_id |
| `max_cursor` | string | No | — | `"0"` | Maximum cursor |
| `count` | integer | No | — | `20` | Number per page |
| `filter_type` | string | No | — | `"0"` | Filter type |

```bash
curl --get "https://api.chinaapi.ai/v1/social/douyin/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'sec_user_id=MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE'
```

#### Douyin · Trending

- **Endpoint**: `GET /v1/social/douyin/trending`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-douyin-trending`

This endpoint takes no parameters.

```bash
curl --get "https://api.chinaapi.ai/v1/social/douyin/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### Xiaohongshu (RED)

#### Xiaohongshu (RED) · Search posts

- **Endpoint**: `GET /v1/social/xiaohongshu/search`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-xiaohongshu-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"美食推荐"` | Search keyword |
| `page` | integer | No | — | `1` | Page number, start from 1 |
| `sort_type` | string | No | — | `"general"` | Sort type |
| `note_type` | string | No | — | `"不限"` | Note type: 不限 (all), 视频笔记 (video), 普通笔记 (standard), 直播笔记 (live). Send the literal Chinese value. |
| `time_filter` | string | No | — | `"不限"` | Time filter: 不限 (all), 一天内 (one day), 一周内 (one week), 半年内 (half year). Send the literal Chinese value. |
| `search_id` | string | No | — | `""` | Search ID for pagination |
| `search_session_id` | string | No | — | `""` | Search session ID for pagination |
| `source` | string | No | — | `"explore_feed"` | Source |
| `ai_mode` | integer | No | — | `0` | AI mode: 0=off, 1=on |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xiaohongshu/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=美食推荐'
```

#### Xiaohongshu (RED) · Post details

- **Endpoint**: `GET /v1/social/xiaohongshu/post`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-xiaohongshu-post`
- **At least one of**: `note_id`, `share_text`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `note_id` | string | No | — | `"697c0eee000000000a03c308"` | Note ID |
| `share_text` | string | No | — | `"http://xhslink.com/o/8GqargIxrko"` | xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xiaohongshu/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'note_id=697c0eee000000000a03c308'
```

#### Xiaohongshu (RED) · Profiles

- **Endpoint**: `GET /v1/social/xiaohongshu/user`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-xiaohongshu-user`
- **At least one of**: `user_id`, `share_text`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | No | — | `"61b46d790000000010008153"` | User ID |
| `share_text` | string | No | — | `"https://xhslink.com/m/3ZSCJZAMz0a"` | xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xiaohongshu/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=61b46d790000000010008153'
```

#### Xiaohongshu (RED) · Comments

- **Endpoint**: `GET /v1/social/xiaohongshu/comments`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-xiaohongshu-comments`
- **At least one of**: `note_id`, `share_text`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `note_id` | string | No | — | `"697c0eee000000000a03c308"` | Note ID |
| `share_text` | string | No | — | `"http://xhslink.com/o/8GqargIxrko"` | xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn |
| `cursor` | string | No | — | `""` | Pagination cursor, leave empty for first request |
| `index` | integer | No | — | `0` | Comment index, pass 0 for first request |
| `pageArea` | string | No | — | `"UNFOLDED"` | Fold state: UNFOLDED (default), FOLDED. |
| `sort_strategy` | string | No | — | `"latest_v2"` | Sort strategy: default, latest_v2, like_count |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xiaohongshu/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'note_id=697c0eee000000000a03c308'
```

#### Xiaohongshu (RED) · User posts

- **Endpoint**: `GET /v1/social/xiaohongshu/user-posts`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-xiaohongshu-user-posts`
- **At least one of**: `user_id`, `share_text`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | No | — | `"61b46d790000000010008153"` | User ID |
| `share_text` | string | No | — | `"http://xhslink.com/o/8GqargIxrko"` | xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn |
| `cursor` | string | No | — | `""` | Pagination cursor, leave empty for first request |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xiaohongshu/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=61b46d790000000010008153'
```

### Kuaishou

#### Kuaishou · Search posts

- **Endpoint**: `GET /v1/social/kuaishou/search`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-kuaishou-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"人工智能"` | Search keyword |
| `pcursor` | string | No | — | `""` | Empty for first page, pass pcursor from previous response |

```bash
curl --get "https://api.chinaapi.ai/v1/social/kuaishou/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=人工智能'
```

#### Kuaishou · Post details

- **Endpoint**: `GET /v1/social/kuaishou/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-kuaishou-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `share_text` | string | Yes | — | `"https://v.kuaishou.com/cNYP0Z"` | Photo URL |

```bash
curl --get "https://api.chinaapi.ai/v1/social/kuaishou/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'share_text=https://v.kuaishou.com/cNYP0Z'
```

#### Kuaishou · Profiles

- **Endpoint**: `GET /v1/social/kuaishou/user`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-kuaishou-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | Yes | — | `"3xz63mn6fngqtiq"` | User ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/kuaishou/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=3xz63mn6fngqtiq'
```

#### Kuaishou · Comments

- **Endpoint**: `GET /v1/social/kuaishou/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-kuaishou-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `photo_id` | string | Yes | — | `"3x7gxp2zhgjv832"` | Photo ID |
| `pcursor` | string | No | — | — | Comment cursor |

```bash
curl --get "https://api.chinaapi.ai/v1/social/kuaishou/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'photo_id=3x7gxp2zhgjv832'
```

#### Kuaishou · User posts

- **Endpoint**: `GET /v1/social/kuaishou/user-posts`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-kuaishou-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | Yes | — | `"903511772"` | User ID |
| `pcursor` | string | No | — | `""` | Leave empty for the first request; then use pcursor from the previous response. |
| `sort` | string | No | — | `"latest"` | latest (default, newest) / hot (popular) |

```bash
curl --get "https://api.chinaapi.ai/v1/social/kuaishou/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=903511772'
```

#### Kuaishou · Trending

- **Endpoint**: `GET /v1/social/kuaishou/trending`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-kuaishou-trending`

This endpoint takes no parameters.

```bash
curl --get "https://api.chinaapi.ai/v1/social/kuaishou/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### Bilibili

#### Bilibili · Search posts

- **Endpoint**: `GET /v1/social/bilibili/search`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-bilibili-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"火影忍者"` | Search keyword |
| `order` | string | Yes | `"totalrank"` | `"totalrank"` | Order method |
| `page` | integer | Yes | `1` | `1` | Page number |
| `page_size` | integer | Yes | `20` | `42` | Number per page |
| `duration` | integer | No | — | `0` | Duration filter |
| `pubtime_begin_s` | integer | No | — | `0` | Start date (10-digit timestamp) |
| `pubtime_end_s` | integer | No | — | `0` | End date (10-digit timestamp) |

```bash
curl --get "https://api.chinaapi.ai/v1/social/bilibili/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=火影忍者' \
  --data-urlencode 'order=totalrank' \
  --data-urlencode 'page=1' \
  --data-urlencode 'page_size=42'
```

#### Bilibili · Post details

- **Endpoint**: `GET /v1/social/bilibili/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-bilibili-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `url` | string | Yes | — | `"https://www.bilibili.com/video/BV1S5uKzzE4r"` | Video URL |

```bash
curl --get "https://api.chinaapi.ai/v1/social/bilibili/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'url=https://www.bilibili.com/video/BV1S5uKzzE4r'
```

#### Bilibili · Profiles

- **Endpoint**: `GET /v1/social/bilibili/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-bilibili-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `uid` | string | Yes | — | `"178360345"` | User UID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/bilibili/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'uid=178360345'
```

#### Bilibili · Comments

- **Endpoint**: `GET /v1/social/bilibili/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-bilibili-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `bv_id` | string | Yes | — | `"BV1M1421t7hT"` | Video id |
| `pn` | integer | No | — | `1` | Page number |

```bash
curl --get "https://api.chinaapi.ai/v1/social/bilibili/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'bv_id=BV1M1421t7hT'
```

#### Bilibili · User posts

- **Endpoint**: `GET /v1/social/bilibili/user-posts`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-bilibili-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `uid` | string | Yes | — | `"178360345"` | User UID |
| `pn` | integer | No | — | `1` | Page number, max 100 |
| `ps` | integer | No | — | `25` | Page size, max 50 |
| `order` | string | No | — | `"pubdate"` | Order method |

```bash
curl --get "https://api.chinaapi.ai/v1/social/bilibili/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'uid=178360345'
```

#### Bilibili · Trending

- **Endpoint**: `GET /v1/social/bilibili/trending`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-bilibili-trending`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `pn` | integer | No | — | `1` | Page number |

```bash
curl --get "https://api.chinaapi.ai/v1/social/bilibili/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### Weibo

#### Weibo · Search posts

- **Endpoint**: `GET /v1/social/weibo/search`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-weibo-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `query` | string | Yes | — | `"NVIDIA"` | Search keyword |
| `page` | integer | No | — | `1` | Page number |
| `search_type` | integer | No | — | `1` | Search type: 1=general, 61=real-time, 3=users, 64=videos, 63=images, 62=following, 60=popular, 21=web-wide, 38=topics, 98=super topics, 92=places, 97=products. |

```bash
curl --get "https://api.chinaapi.ai/v1/social/weibo/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'query=NVIDIA'
```

#### Weibo · Post details

- **Endpoint**: `GET /v1/social/weibo/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-weibo-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `status_id` | string | Yes | — | `"5016922058656962"` | Weibo post ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/weibo/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'status_id=5016922058656962'
```

#### Weibo · Profiles

- **Endpoint**: `GET /v1/social/weibo/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-weibo-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `uid` | string | Yes | — | `"7648703289"` | User ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/weibo/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'uid=7648703289'
```

#### Weibo · Comments

- **Endpoint**: `GET /v1/social/weibo/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-weibo-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `status_id` | string | Yes | — | `"5258708168476831"` | Weibo post ID |
| `max_id` | string | No | — | — | Pagination cursor |
| `sort_type` | string | No | — | `"0"` | Sort type: 0=popularity, 1=time. |

```bash
curl --get "https://api.chinaapi.ai/v1/social/weibo/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'status_id=5258708168476831'
```

#### Weibo · User posts

- **Endpoint**: `GET /v1/social/weibo/user-posts`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-weibo-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `uid` | string | Yes | — | `"7648703289"` | User ID |
| `page` | integer | No | — | `1` | Page number |
| `filter_type` | string | No | — | `"all"` | Filter type |
| `month` | string | No | — | `"20251010"` | Time filter (YYYYMMDD). |

```bash
curl --get "https://api.chinaapi.ai/v1/social/weibo/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'uid=7648703289'
```

#### Weibo · Trending

- **Endpoint**: `GET /v1/social/weibo/trending`
- **Price**: $0.003 per successful call
- **Usage log name**: `social-weibo-trending`

This endpoint takes no parameters.

```bash
curl --get "https://api.chinaapi.ai/v1/social/weibo/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### Zhihu

#### Zhihu · Search posts

- **Endpoint**: `GET /v1/social/zhihu/search`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-zhihu-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | — | Search Keywords |
| `offset` | string | No | — | `"0"` | Offset |
| `limit` | string | No | — | `"20"` | Number of articles per page |
| `show_all_topics` | integer | No | — | `0` | Show all topics |
| `search_source` | string | No | — | `"Normal"` | Search Source |
| `search_hash_id` | string | No | — | `""` | Search Hash ID |
| `vertical` | string | No | — | `""` | Vertical Type |
| `sort` | string | No | — | `""` | Sort |
| `time_interval` | string | No | — | `""` | Time Interval |
| `vertical_info` | string | No | — | `""` | Vertical Info |

```bash
curl --get "https://api.chinaapi.ai/v1/social/zhihu/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=YOUR_KEYWORD'
```

#### Zhihu · Post details

- **Endpoint**: `GET /v1/social/zhihu/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-zhihu-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `answer_id` | string | Yes | — | — | Answer ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/zhihu/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'answer_id=YOUR_ANSWER_ID'
```

#### Zhihu · Profiles

- **Endpoint**: `GET /v1/social/zhihu/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-zhihu-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_url_token` | string | Yes | — | — | User ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/zhihu/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_url_token=YOUR_USER_URL_TOKEN'
```

#### Zhihu · Comments

- **Endpoint**: `GET /v1/social/zhihu/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-zhihu-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `answer_id` | string | Yes | — | — | Answer ID |
| `order_by` | string | No | — | `"score"` | Sort |
| `limit` | string | No | — | `"20"` | Number of comments per page |
| `offset` | string | No | — | `""` | Offset |

```bash
curl --get "https://api.chinaapi.ai/v1/social/zhihu/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'answer_id=YOUR_ANSWER_ID'
```

#### Zhihu · Trending

- **Endpoint**: `GET /v1/social/zhihu/trending`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-zhihu-trending`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `limit` | string | No | — | `"50"` | Number of articles per page |
| `desktop` | string | No | — | `"true"` | Is it a desktop |

```bash
curl --get "https://api.chinaapi.ai/v1/social/zhihu/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### WeChat Channels

#### WeChat Channels · Search posts

- **Endpoint**: `GET /v1/social/wechat-channels/search`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-channels-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"美食"` | Search keyword (1-100 chars) |
| `duration` | integer | No | — | `"short"` | Duration tier (Channels video only): all/0 / short/1 (<5min) / medium/2 (5-10min) / long/3 (20min+); a string key or an integer. |
| `sort` | integer | No | — | `"hot"` | Sort: default/0 (relevance) / latest/1 (newest) / hot/2 (most liked); string key or integer |
| `publish_time` | integer | No | — | `"week"` | Publish time: all/0 / day/1 / week/2 / half_year/3; string key or integer |
| `offset` | integer | No | — | `0` | Pass 0 for the first page; use cursor to paginate (offset alone does not work) |
| `cursor` | string | No | — | — | Pagination cursor, same as universal search: leave empty for the first page; pass back the cursor from the previous response |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-channels/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=美食'
```

#### WeChat Channels · Post details

- **Endpoint**: `GET /v1/social/wechat-channels/post`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-channels-post`
- **At least one of**: `object_id`, `export_id`, `share_url`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `object_id` | string | No | — | `"14941130915890399732"` | Video objectId (numeric, highest priority) |
| `export_id` | string | No | — | `""` | exportId from search results (starts with export/, expires soon) |
| `object_nonce_id` | string | No | — | `""` | Optional objectNonceId (numeric, improves hit rate) |
| `share_url` | string | No | — | `""` | Share URL (https://weixin.qq.com/sph/…), used only when object_id and export_id are empty |
| `raw` | boolean | No | — | `true` | True=raw response; False=simplified parsed structure (recommended for media download) |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-channels/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'object_id=14941130915890399732'
```

#### WeChat Channels · Profiles

- **Endpoint**: `GET /v1/social/wechat-channels/user`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-channels-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `username` | string | Yes | — | `"v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder"` | WeChat Channels finder username (v2_…@finder format) |
| `raw` | boolean | No | — | `true` | True=raw response; False=simplified parsed structure |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-channels/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'username=v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder'
```

#### WeChat Channels · Comments

- **Endpoint**: `GET /v1/social/wechat-channels/comments`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-channels-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `object_id` | string | Yes | — | `"14941130915890399732"` | Video objectId (numeric) |
| `last_buffer` | string | No | — | `""` | Pagination cursor (base64), leave empty for first page |
| `comment_id` | string | No | — | `""` | Pass a commentId (numeric) to expand its replies, leave empty for first-level comments |
| `raw` | boolean | No | — | `true` | True=raw response; False=simplified parsed structure |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-channels/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'object_id=14941130915890399732'
```

#### WeChat Channels · User posts

- **Endpoint**: `GET /v1/social/wechat-channels/user-posts`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-channels-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `username` | string | Yes | — | `"v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder"` | WeChat Channels finder username (v2_…@finder format) |
| `last_buffer` | string | No | — | `""` | Pagination cursor (base64), leave empty for first page |
| `raw` | boolean | No | — | `true` | True=raw response; False=simplified parsed structure (recommended for media download) |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-channels/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'username=v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder'
```

### WeChat Official Accounts

#### WeChat Official Accounts · Search posts

- **Endpoint**: `GET /v1/social/wechat-mp/search`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-mp-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"人民日报"` | Search keyword (1-100 chars) |
| `sort` | integer | No | — | `"hot"` | Sort (result page 'sort' dropdown, common to all verticals): default/0 (relevance) / latest/1 (newest) / hot/2 |
| `publish_time` | integer | No | — | `"week"` | Publish time (result page 'time' dropdown, common): all/0 / day/1 / week/2 / half_year/3; string key or integer |
| `offset` | integer | No | — | `0` | Pass 0 for the first page; use cursor to paginate (offset alone does not work — it returns the first page every time) |
| `cursor` | string | No | — | — | Pagination cursor: leave empty for the first page; for the next page pass back the cursor returned in the previous response |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-mp/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=人民日报'
```

#### WeChat Official Accounts · Post details

- **Endpoint**: `GET /v1/social/wechat-mp/post`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-mp-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `url` | string | Yes | — | `"https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw"` | WeChat MP article URL (https://mp.weixin.qq.com/s/… or long URL with __biz) |
| `raw` | boolean | No | — | `true` | True=raw response; False=simplified parsed structure |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-mp/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'url=https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw'
```

#### WeChat Official Accounts · Profiles

- **Endpoint**: `GET /v1/social/wechat-mp/user`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-mp-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `username` | string | Yes | — | `"gh_363b924965e9"` | Official account username. Three forms are supported: `gh_…`, `gh_…@app` (an account linked to a mini program), and a custom WeChat ID such as `nikejdi`. Take it from `$.data.content.user_name` in an article-details response. |
| `raw` | boolean | No | — | `true` | True=raw response; False=simplified parsed structure |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-mp/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'username=gh_363b924965e9'
```

#### WeChat Official Accounts · Comments

- **Endpoint**: `GET /v1/social/wechat-mp/comments`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-mp-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `url` | string | Yes | — | `"https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw"` | mp.weixin.qq.com/s/…）/WeChat MP article URL (https://mp.weixin.qq.com/s/…) |
| `buffer` | string | No | — | `""` | Pagination cursor, leave empty for first page; pass buffer from the previous response |
| `comment_id` | string | No | — | — | Optional article comment ID. Reuse data.content.comment_id from an article-details response when available to reduce retrieval work. |
| `raw` | boolean | No | — | `true` | True=raw response; False=simplified parsed structure |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-mp/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'url=https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw'
```

#### WeChat Official Accounts · User posts

- **Endpoint**: `GET /v1/social/wechat-mp/user-posts`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-mp-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `username` | string | Yes | — | `"gh_363b924965e9"` | Official account username. Three forms are supported: `gh_…`, `gh_…@app` (an account linked to a mini program), and a custom WeChat ID such as `nikejdi`. Take it from `$.data.content.user_name` in an article-details response. |
| `page_size` | integer | No | — | `20` | Articles per page (default 20). WeChat currently ignores this parameter: the account decides how many articles come back, and 1 and 40 returned the same result in testing. Paginate with offset / next_offset. |
| `offset` | string | No | — | `""` | Pagination cursor (base64), leave empty for first page; for the next page pass next_offset from the previous response |
| `item_show_type` | integer | No | — | — | Content tab: empty/0=articles (default), 5=videos, 7=audios, 8=image-text posts |
| `raw` | boolean | No | — | `true` | True=raw response; False=simplified parsed structure |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-mp/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'username=gh_363b924965e9'
```

### WeChat Search

#### WeChat Search · Search posts

- **Endpoint**: `GET /v1/social/wechat-search/search`
- **Price**: $0.02 per successful call
- **Usage log name**: `social-wechat-search-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"人民日报"` | Search keyword (1-100 chars) |
| `business_type` | string | No | — | `"account"` | Search category. Tested categories with results: all, account, article, video, sticker. Other categories may return no data. |
| `sort` | integer | No | — | `"hot"` | Sort (result page 'sort' dropdown, common to all verticals): default/0 (relevance) / latest/1 (newest) / hot/2 |
| `publish_time` | integer | No | — | `"week"` | Publish time (result page 'time' dropdown, common): all/0 / day/1 / week/2 / half_year/3; string key or integer |
| `offset` | integer | No | — | `0` | Pass 0 for the first page; use cursor to paginate (offset alone does not work — it returns the first page every time) |
| `cursor` | string | No | — | — | Pagination cursor: leave empty for the first page; for the next page pass back the cursor returned in the previous response |
| `raw` | boolean | No | — | `true` | True=raw search response; False=simplified parsed structure |

```bash
curl --get "https://api.chinaapi.ai/v1/social/wechat-search/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=人民日报'
```

### Toutiao

#### Toutiao · Post details

- **Endpoint**: `GET /v1/social/toutiao/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-toutiao-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `aweme_id` | string | Yes | — | `"7450114952884503059"` | Post ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/toutiao/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'aweme_id=7450114952884503059'
```

#### Toutiao · Profiles

- **Endpoint**: `GET /v1/social/toutiao/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-toutiao-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | Yes | — | `"1352838578180211"` | User ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/toutiao/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=1352838578180211'
```

#### Toutiao · Comments

- **Endpoint**: `GET /v1/social/toutiao/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-toutiao-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `group_id` | string | Yes | — | `"7453372680222523931"` | Post ID |
| `offset` | string | Yes | — | `"0"` | Offset |

```bash
curl --get "https://api.chinaapi.ai/v1/social/toutiao/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'group_id=7453372680222523931' \
  --data-urlencode 'offset=0'
```

### Xigua Video

#### Xigua Video · Search posts

- **Endpoint**: `GET /v1/social/xigua/search`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-xigua-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"抖音"` | Keyword |
| `offset` | integer | No | — | `0` | Offset |
| `order_type` | string | No | — | — | Order type |
| `min_duration` | integer | No | — | — | Minimum duration |
| `max_duration` | integer | No | — | — | Maximum duration |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xigua/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=抖音'
```

#### Xigua Video · Post details

- **Endpoint**: `GET /v1/social/xigua/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-xigua-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `item_id` | string | Yes | — | `"7354954305222377999"` | Video id |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xigua/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'item_id=7354954305222377999'
```

#### Xigua Video · Profiles

- **Endpoint**: `GET /v1/social/xigua/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-xigua-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | Yes | — | `"52712347586"` | User id |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xigua/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=52712347586'
```

#### Xigua Video · Comments

- **Endpoint**: `GET /v1/social/xigua/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-xigua-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `item_id` | string | Yes | — | `"7354954305222377999"` | Video id |
| `offset` | integer | No | — | `0` | Offset |
| `count` | integer | No | — | `20` | Count |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xigua/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'item_id=7354954305222377999'
```

#### Xigua Video · User posts

- **Endpoint**: `GET /v1/social/xigua/user-posts`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-xigua-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | Yes | — | `"1922379661976311"` | User id |
| `max_behot_time` | string | No | — | — | Maximum behavior time |

```bash
curl --get "https://api.chinaapi.ai/v1/social/xigua/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=1922379661976311'
```

### Pipixia

#### Pipixia · Search posts

- **Endpoint**: `GET /v1/social/pipixia/search`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-pipixia-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"皮皮虾"` | Search keyword |
| `offset` | string | No | — | `"0"` | Page cursor |
| `search_type` | string | No | — | `"1"` | Search type |

```bash
curl --get "https://api.chinaapi.ai/v1/social/pipixia/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=皮皮虾'
```

#### Pipixia · Post details

- **Endpoint**: `GET /v1/social/pipixia/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-pipixia-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `cell_id` | string | Yes | — | `"7411193113223371043"` | Video id |
| `cell_type` | integer | No | — | `1` | Video type |

```bash
curl --get "https://api.chinaapi.ai/v1/social/pipixia/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'cell_id=7411193113223371043'
```

#### Pipixia · Profiles

- **Endpoint**: `GET /v1/social/pipixia/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-pipixia-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | Yes | — | `"1020401"` | User id |

```bash
curl --get "https://api.chinaapi.ai/v1/social/pipixia/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=1020401'
```

#### Pipixia · Comments

- **Endpoint**: `GET /v1/social/pipixia/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-pipixia-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `cell_id` | string | Yes | — | `"7411193113223371043"` | Video id |
| `cell_type` | integer | No | — | `1` | Video type |
| `offset` | string | No | — | `"0"` | Page cursor |

```bash
curl --get "https://api.chinaapi.ai/v1/social/pipixia/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'cell_id=7411193113223371043'
```

#### Pipixia · User posts

- **Endpoint**: `GET /v1/social/pipixia/user-posts`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-pipixia-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | Yes | — | `"1310254082831248"` | User id |
| `cursor` | string | No | — | `"0"` | Page cursor |
| `feed_count` | string | No | — | `"0"` | Page count |

```bash
curl --get "https://api.chinaapi.ai/v1/social/pipixia/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=1310254082831248'
```

#### Pipixia · Trending

- **Endpoint**: `GET /v1/social/pipixia/trending`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-pipixia-trending`

This endpoint takes no parameters.

```bash
curl --get "https://api.chinaapi.ai/v1/social/pipixia/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### TikTok

#### TikTok · Search posts

- **Endpoint**: `GET /v1/social/tiktok/search`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-tiktok-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"TikTok"` | Search keyword |
| `offset` | integer | No | — | `0` | Page cursor |
| `search_id` | string | No | — | `""` | Search id, need to provide when paging |

```bash
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'
```

#### TikTok · Post details

- **Endpoint**: `GET /v1/social/tiktok/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-tiktok-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `itemId` | string | Yes | — | `"7339393672959757570"` | Video id |
| `region` | string | No | — | `"US"` | Region code, optional; affects content region, e.g. US/GB/JP/ID, default US. |

```bash
curl --get "https://api.chinaapi.ai/v1/social/tiktok/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'itemId=7339393672959757570'
```

#### TikTok · Profiles

- **Endpoint**: `GET /v1/social/tiktok/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-tiktok-user`
- **At least one of**: `uniqueId`, `secUid`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `uniqueId` | string | No | — | `"tiktok"` | User uniqueId |
| `secUid` | string | No | — | `""` | User secUid |

```bash
curl --get "https://api.chinaapi.ai/v1/social/tiktok/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'uniqueId=tiktok'
```

#### TikTok · Comments

- **Endpoint**: `GET /v1/social/tiktok/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-tiktok-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `aweme_id` | string | Yes | — | `"7304809083817774382"` | Video id |
| `cursor` | integer | No | — | `0` | Page cursor |
| `count` | integer | No | — | `20` | Number per page |
| `current_region` | string | No | — | `""` | Current region |

```bash
curl --get "https://api.chinaapi.ai/v1/social/tiktok/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'aweme_id=7304809083817774382'
```

#### TikTok · User posts

- **Endpoint**: `GET /v1/social/tiktok/user-posts`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-tiktok-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `secUid` | string | Yes | — | `"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"` | User secUid |
| `cursor` | integer | No | — | `0` | Page cursor |
| `count` | integer | No | — | `15` | Number per page, max 15 |
| `coverFormat` | integer | No | — | `2` | Cover format |
| `post_item_list_request_type` | integer | No | — | `0` | Sort type (deprecated, no longer effective) |

```bash
curl --get "https://api.chinaapi.ai/v1/social/tiktok/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'secUid=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM'
```

#### TikTok · Trending

- **Endpoint**: `GET /v1/social/tiktok/trending`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-tiktok-trending`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `count` | integer | No | — | `15` | Number per page |
| `region` | string | No | — | `"US"` | Region code, optional, affects the region of recommended content, e.g. US/GB/JP/KR/SG, default US. |

```bash
curl --get "https://api.chinaapi.ai/v1/social/tiktok/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### Instagram

#### Instagram · Search posts

- **Endpoint**: `GET /v1/social/instagram/search`
- **Price**: $0.004 per successful call
- **Usage log name**: `social-instagram-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"cat"` | Search keyword |
| `pagination_token` | string | No | — | — | Pagination token |

```bash
curl --get "https://api.chinaapi.ai/v1/social/instagram/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=cat'
```

#### Instagram · Post details

- **Endpoint**: `GET /v1/social/instagram/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-instagram-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `post_url` | string | Yes | — | `"https://www.instagram.com/p/DPwhVB-jo9k/"` | Post URL |

```bash
curl --get "https://api.chinaapi.ai/v1/social/instagram/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'post_url=https://www.instagram.com/p/DPwhVB-jo9k/'
```

#### Instagram · Profiles

- **Endpoint**: `GET /v1/social/instagram/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-instagram-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `username` | string | Yes | — | `"instagram"` | Instagram username |

```bash
curl --get "https://api.chinaapi.ai/v1/social/instagram/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'username=instagram'
```

#### Instagram · Comments

- **Endpoint**: `GET /v1/social/instagram/comments`
- **Price**: $0.004 per successful call
- **Usage log name**: `social-instagram-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `code_or_url` | string | Yes | — | `"DRhvwVLAHAG"` | Post shortcode or URL |
| `sort_by` | string | No | — | `"recent"` | Sort by: recent or popular |
| `pagination_token` | string | No | — | `""` | Pagination token |

```bash
curl --get "https://api.chinaapi.ai/v1/social/instagram/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'code_or_url=DRhvwVLAHAG'
```

#### Instagram · User posts

- **Endpoint**: `GET /v1/social/instagram/user-posts`
- **Price**: $0.004 per successful call
- **Usage log name**: `social-instagram-user-posts`
- **At least one of**: `username`, `user_id`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `username` | string | No | — | `"instagram"` | Username |
| `user_id` | string | No | — | `"18527"` | User ID |
| `pagination_token` | string | No | — | — | Pagination token |

```bash
curl --get "https://api.chinaapi.ai/v1/social/instagram/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'username=instagram'
```

#### Instagram · Trending

- **Endpoint**: `GET /v1/social/instagram/trending`
- **Price**: $0.016 per successful call
- **Usage log name**: `social-instagram-trending`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `max_id` | string | No | — | — | Pagination cursor, omit for first request, get from previous response next_max_id |

```bash
curl --get "https://api.chinaapi.ai/v1/social/instagram/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### YouTube

#### YouTube · Search posts

- **Endpoint**: `GET /v1/social/youtube/search`
- **Price**: $0.004 per successful call
- **Usage log name**: `social-youtube-search`
- **At least one of**: `keyword`, `continuation_token`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | No | — | `"Python tutorial"` | Search keyword (required for first request) |
| `continuation_token` | string | No | — | — | Continuation token for next page |
| `upload_date` | string | No | — | — | Upload date filter |
| `type` | string | No | — | — | Type filter |
| `duration` | string | No | — | — | Duration filter: short (<4min), medium (4-20min), long (>20min) |
| `features` | string | No | — | — | Feature filter (comma separated): live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr |
| `sort_by` | string | No | — | — | Sort by |

```bash
curl --get "https://api.chinaapi.ai/v1/social/youtube/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=Python tutorial'
```

#### YouTube · Post details

- **Endpoint**: `GET /v1/social/youtube/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-youtube-post`
- **At least one of**: `video_id`, `video_url`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `video_id` | string | No | — | `"dQw4w9WgXcQ"` | Video ID |
| `video_url` | string | No | — | `"https://www.youtube.com/watch?v=dQw4w9WgXcQ"` | Video URL (ignored when video_id is provided). |
| `need_format` | boolean | No | — | `true` | Whether to return cleaned payload |

```bash
curl --get "https://api.chinaapi.ai/v1/social/youtube/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'video_id=dQw4w9WgXcQ'
```

#### YouTube · Profiles

- **Endpoint**: `GET /v1/social/youtube/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-youtube-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `channel_id` | string | Yes | — | `"UCXuqSBlHAE6Xw-yeJA0Tunw"` | Channel ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/youtube/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw'
```

#### YouTube · Comments

- **Endpoint**: `GET /v1/social/youtube/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-youtube-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `video_id` | string | Yes | — | `"LuIL5JATZsc"` | Video ID |
| `language_code` | string | No | — | `"zh-CN"` | Language code |
| `country_code` | string | No | — | `"US"` | Country code |
| `sort_by` | string | No | — | `"top"` | Sort by |
| `continuation_token` | string | No | — | — | Pagination token |
| `need_format` | boolean | No | — | `true` | Whether to clean and format the data |

```bash
curl --get "https://api.chinaapi.ai/v1/social/youtube/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'video_id=LuIL5JATZsc'
```

#### YouTube · User posts

- **Endpoint**: `GET /v1/social/youtube/user-posts`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-youtube-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `channel_id` | string | Yes | — | `"UCJHBJ7F-nAIlMGolm0Hu4vg"` | Channel ID |
| `language_code` | string | No | — | `"zh-CN"` | Language code |
| `country_code` | string | No | — | `"US"` | Country code |
| `continuation_token` | string | No | — | — | Pagination token for next page |
| `need_format` | boolean | No | — | `true` | Whether to clean and format the data |

```bash
curl --get "https://api.chinaapi.ai/v1/social/youtube/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg'
```

### X (Twitter)

#### X (Twitter) · Search posts

- **Endpoint**: `GET /v1/social/twitter/search`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-twitter-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `keyword` | string | Yes | — | `"Elon Musk"` | Search Keyword |
| `search_type` | string | No | — | `"Top"` | Search Type |
| `cursor` | string | No | — | — | Cursor |

```bash
curl --get "https://api.chinaapi.ai/v1/social/twitter/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=Elon Musk'
```

#### X (Twitter) · Post details

- **Endpoint**: `GET /v1/social/twitter/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-twitter-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `tweet_id` | string | Yes | — | `"1808168603721650364"` | Tweet ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/twitter/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'tweet_id=1808168603721650364'
```

#### X (Twitter) · Profiles

- **Endpoint**: `GET /v1/social/twitter/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-twitter-user`
- **At least one of**: `screen_name`, `rest_id`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `screen_name` | string | No | — | `"elonmusk"` | Screen Name |
| `rest_id` | integer | No | — | `"44196397"` | User ID (If the user ID is used, the user name will be ignored) |

```bash
curl --get "https://api.chinaapi.ai/v1/social/twitter/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'screen_name=elonmusk'
```

#### X (Twitter) · Comments

- **Endpoint**: `GET /v1/social/twitter/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-twitter-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `tweet_id` | string | Yes | — | `"1835124037934367098"` | Tweet ID |
| `cursor` | string | No | — | — | Cursor |

```bash
curl --get "https://api.chinaapi.ai/v1/social/twitter/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'tweet_id=1835124037934367098'
```

#### X (Twitter) · User posts

- **Endpoint**: `GET /v1/social/twitter/user-posts`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-twitter-user-posts`
- **At least one of**: `screen_name`, `rest_id`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `screen_name` | string | No | — | `"elonmusk"` | Screen Name |
| `rest_id` | integer | No | — | `"44196397"` | User ID |
| `cursor` | string | No | — | — | Cursor |

```bash
curl --get "https://api.chinaapi.ai/v1/social/twitter/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'screen_name=elonmusk'
```

#### X (Twitter) · Trending

- **Endpoint**: `GET /v1/social/twitter/trending`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-twitter-trending`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `country` | string | No | — | `"UnitedStates"` | Country |

```bash
curl --get "https://api.chinaapi.ai/v1/social/twitter/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### Reddit

#### Reddit · Search posts

- **Endpoint**: `GET /v1/social/reddit/search`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-reddit-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `language` | string | No | — | `"en-US"` | Preferred response language as an IETF language tag; default: en-US |
| `query` | string | Yes | — | `"python programming"` | Search query |
| `search_type` | string | No | — | `"post"` | Search type: post, community, comment, media, people. |
| `sort` | string | No | — | `"RELEVANCE"` | Sort method (post/comment/media only): RELEVANCE, HOT, TOP, NEW, COMMENTS (post only). |
| `time_range` | string | No | — | `"all"` | Time range (post/media only): all, year, month, week, day, hour. |
| `safe_search` | string | No | — | `"unset"` | Safe search setting: unset, strict |
| `allow_nsfw` | string | No | — | `"0"` | Allow NSFW content: 0, 1 |
| `after` | string | No | — | `""` | Pagination parameter |
| `need_format` | boolean | No | — | `false` | Whether to clean and format the data |

```bash
curl --get "https://api.chinaapi.ai/v1/social/reddit/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'query=python programming'
```

#### Reddit · Post details

- **Endpoint**: `GET /v1/social/reddit/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-reddit-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `language` | string | No | — | `"en-US"` | Preferred response language as an IETF language tag; default: en-US |
| `post_id` | string | Yes | — | `"t3_1ojnh50"` | Post ID |
| `include_comment_id` | boolean | No | — | `false` | Include specific comment ID |
| `comment_id` | string | No | — | `""` | Comment ID (when include_comment_id is True) |
| `need_format` | boolean | No | — | `false` | Whether to clean and format the data |

```bash
curl --get "https://api.chinaapi.ai/v1/social/reddit/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'post_id=t3_1ojnh50'
```

#### Reddit · Profiles

- **Endpoint**: `GET /v1/social/reddit/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-reddit-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `language` | string | No | — | `"en-US"` | Preferred response language as an IETF language tag; default: en-US |
| `username` | string | Yes | — | `"spez"` | Username |
| `need_format` | boolean | No | — | `false` | Whether to clean and format the data |

```bash
curl --get "https://api.chinaapi.ai/v1/social/reddit/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'username=spez'
```

#### Reddit · Comments

- **Endpoint**: `GET /v1/social/reddit/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-reddit-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `language` | string | No | — | `"en-US"` | Preferred response language as an IETF language tag; default: en-US |
| `post_id` | string | Yes | — | `"t3_1ojnvca"` | Post ID |
| `sort_type` | string | No | — | `"CONFIDENCE"` | Sort method: CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM |
| `after` | string | No | — | `""` | Pagination parameter for fetching next page |
| `need_format` | boolean | No | — | `false` | Whether to clean and format the data |

```bash
curl --get "https://api.chinaapi.ai/v1/social/reddit/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'post_id=t3_1ojnvca'
```

#### Reddit · User posts

- **Endpoint**: `GET /v1/social/reddit/user-posts`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-reddit-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `language` | string | No | — | `"en-US"` | Preferred response language as an IETF language tag; default: en-US |
| `username` | string | Yes | — | `"spez"` | Username |
| `sort` | string | No | — | `"NEW"` | Sort method: NEW, TOP, HOT, CONTROVERSIAL |
| `after` | string | No | — | `""` | Pagination parameter |
| `need_format` | boolean | No | — | `false` | Whether to clean and format the data |

```bash
curl --get "https://api.chinaapi.ai/v1/social/reddit/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'username=spez'
```

#### Reddit · Trending

- **Endpoint**: `GET /v1/social/reddit/trending`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-reddit-trending`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `language` | string | No | — | `"en-US"` | Preferred response language as an IETF language tag; default: en-US |
| `need_format` | boolean | No | — | `false` | Whether to clean and format the data |

```bash
curl --get "https://api.chinaapi.ai/v1/social/reddit/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```

### LinkedIn

#### LinkedIn · Post details

- **Endpoint**: `GET /v1/social/linkedin/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-linkedin-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `url` | string | Yes | — | `"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"` | Post or article URL |

```bash
curl --get "https://api.chinaapi.ai/v1/social/linkedin/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'url=https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN'
```

#### LinkedIn · Profiles

- **Endpoint**: `GET /v1/social/linkedin/user`
- **Price**: $0.016 per successful call
- **Usage log name**: `social-linkedin-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `url` | string | Yes | — | `"https://www.linkedin.com/in/williamhgates/"` | Full profile URL |

```bash
curl --get "https://api.chinaapi.ai/v1/social/linkedin/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'url=https://www.linkedin.com/in/williamhgates/'
```

#### LinkedIn · Comments

- **Endpoint**: `GET /v1/social/linkedin/comments`
- **Price**: $0.1 per successful call
- **Usage log name**: `social-linkedin-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `urn` | string | Yes | — | `"7267273010393358336"` | Post activity urn |
| `sort_by` | string | No | — | — | Most relevant (default) \| Most recent |
| `page` | integer | No | — | — | Page number, starts at 1 |
| `pagination_token` | string | No | — | — | Pagination token |
| `share_urn` | string | No | — | — | Share urn (optional) |

```bash
curl --get "https://api.chinaapi.ai/v1/social/linkedin/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'urn=7267273010393358336'
```

#### LinkedIn · User posts

- **Endpoint**: `GET /v1/social/linkedin/user-posts`
- **Price**: $0.1 per successful call
- **Usage log name**: `social-linkedin-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `url` | string | Yes | — | `"https://www.linkedin.com/in/williamhgates/"` | Profile URL |
| `type` | string | No | — | `"posts"` | posts (posts/reposts) \| comments (commented posts) \| reactions (liked posts) |
| `start` | integer | No | — | — | Pagination offset |
| `pagination_token` | string | No | — | — | Pagination token |

```bash
curl --get "https://api.chinaapi.ai/v1/social/linkedin/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'url=https://www.linkedin.com/in/williamhgates/'
```

### Threads

#### Threads · Search posts

- **Endpoint**: `GET /v1/social/threads/search`
- **Price**: $0.004 per successful call
- **Usage log name**: `social-threads-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `query` | string | Yes | — | `"bitcoin"` | Search query |

```bash
curl --get "https://api.chinaapi.ai/v1/social/threads/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'query=bitcoin'
```

#### Threads · Post details

- **Endpoint**: `GET /v1/social/threads/post`
- **Price**: $0.004 per successful call
- **Usage log name**: `social-threads-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `post_id` | string | Yes | — | `"3349029093483693129"` | Post ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/threads/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'post_id=3349029093483693129'
```

#### Threads · Profiles

- **Endpoint**: `GET /v1/social/threads/user`
- **Price**: $0.004 per successful call
- **Usage log name**: `social-threads-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `username` | string | Yes | — | `"jlo"` | Username |

```bash
curl --get "https://api.chinaapi.ai/v1/social/threads/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'username=jlo'
```

#### Threads · User posts

- **Endpoint**: `GET /v1/social/threads/user-posts`
- **Price**: $0.004 per successful call
- **Usage log name**: `social-threads-user-posts`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | Yes | — | `"63625256886"` | User ID |
| `end_cursor` | string | No | — | — | Pagination cursor (no pagination, has no effect) |

```bash
curl --get "https://api.chinaapi.ai/v1/social/threads/user-posts" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=63625256886'
```

### Lemon8

#### Lemon8 · Search posts

- **Endpoint**: `GET /v1/social/lemon8/search`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-lemon8-search`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `query` | string | Yes | — | `"lemon8"` | Search keyword |
| `max_cursor` | string | No | — | `""` | Pagination parameter |
| `filter_type` | string | No | — | `""` | Search filter type |
| `order_by` | string | No | — | `""` | Search sort type |
| `search_tab` | string | No | — | `"main"` | Search type |

```bash
curl --get "https://api.chinaapi.ai/v1/social/lemon8/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'query=lemon8'
```

#### Lemon8 · Post details

- **Endpoint**: `GET /v1/social/lemon8/post`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-lemon8-post`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `item_id` | string | Yes | — | `"7361926875709129222"` | Post ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/lemon8/post" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'item_id=7361926875709129222'
```

#### Lemon8 · Profiles

- **Endpoint**: `GET /v1/social/lemon8/user`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-lemon8-user`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `user_id` | string | Yes | — | `"7217844966059656197"` | User ID |

```bash
curl --get "https://api.chinaapi.ai/v1/social/lemon8/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=7217844966059656197'
```

#### Lemon8 · Comments

- **Endpoint**: `GET /v1/social/lemon8/comments`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-lemon8-comments`

| Parameter | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `group_id` | string | Yes | — | `"7361926875709129222"` | Post's group_id |
| `item_id` | string | Yes | — | `"7361926875709129222"` | Post's item_id |
| `media_id` | string | Yes | — | `"7428056850216862763"` | Post's media_id |
| `offset` | string | No | — | `"0"` | Pagination parameter |

```bash
curl --get "https://api.chinaapi.ai/v1/social/lemon8/comments" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'group_id=7361926875709129222' \
  --data-urlencode 'item_id=7361926875709129222' \
  --data-urlencode 'media_id=7428056850216862763'
```

#### Lemon8 · Trending

- **Endpoint**: `GET /v1/social/lemon8/trending`
- **Price**: $0.002 per successful call
- **Usage log name**: `social-lemon8-trending`

This endpoint takes no parameters.

```bash
curl --get "https://api.chinaapi.ai/v1/social/lemon8/trending" \
  -H "Authorization: Bearer $CHINAAPI_KEY"
```