<!-- GENERATED BY scripts/gen_social_pages.py; DO NOT EDIT -->
# Social data API reference

- Canonical: https://chinaapi.ai/social-data-api/docs/
- Public catalog: https://dash.chinaapi.ai/api/social/catalog?lang=en&utm_source=chinaapi&utm_medium=social-catalog&utm_campaign=social-data-beta
- Captured: 2026-09-29T22:19:36Z
- Available pairs: 101; platforms: 20
- API origin: https://api.chinaapi.ai

## Beta terms and billing

A completed first top-up is required. Trial credits cannot be used for social-data requests. No SLA; coverage may change.
Comply with platform terms and applicable data rules. Personal profiling, login, contact extraction, engagement manipulation and private or paid-content access are excluded.
Use your existing ChinaAPI key and balance. Only HTTP 200 with data is charged. Empty or failed results are not charged. Daily beta budgets may return HTTP 429 and reset at UTC midnight; transient rate limits also apply.

[Create an account](https://dash.chinaapi.ai/register?lang=en&utm_source=chinaapi&utm_medium=md&utm_campaign=social-data-beta) · [Full reference](https://chinaapi.ai/social-data-api/docs/)

## Responses and errors

Send `Authorization: Bearer $CHINAAPI_API_KEY`. A success returns `{ "object": "social.result", "platform": ..., "capability": ..., "data": {...} }`; `data` retains platform-specific fields.
HTTP 403 `model_requires_topup` requires a first top-up. HTTP 429 requires stopping immediate retries. Each successful pagination request is another billable call. Keep keys server-side.

## Available endpoints

### Douyin — Search posts

- Endpoint: `GET /v1/social/douyin/search`
- Model ID: `social-douyin-search`
- Price: $0.02 USD / successful call
- Status: available
- `keyword` (string, required; example "猫咪"): Keyword
- `cursor` (integer, optional; example 0): Offset cursor for pagination, obtained from the last response
- `sort_type` (string, optional; example "0"): Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest
- `publish_time` (string, optional; example "0"): Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year
- `filter_duration` (string, optional; example "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, optional; example "0"): Content type: 0=All, 1=Video, 2=Picture, 3=Article
- `search_id` (string, optional; example ""): Search ID for pagination, obtained from the last response
- `backtrace` (string, optional; example ""): Backtrace for pagination, obtained from the last response

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

### Douyin — Post details

- Endpoint: `GET /v1/social/douyin/post`
- Model ID: `social-douyin-post`
- Price: $0.002 USD / successful call
- Status: available
- `share_url` (string, required; example "https://v.douyin.com/e3x2fjE/"): Share link

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

### Douyin — Profiles

- Endpoint: `GET /v1/social/douyin/user`
- Model ID: `social-douyin-user`
- Price: $0.006 USD / successful call
- Status: available
- `sec_user_id` (string, required; example "MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y"): User sec_user_id

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

### Douyin — Comments

- Endpoint: `GET /v1/social/douyin/comments`
- Model ID: `social-douyin-comments`
- Price: $0.002 USD / successful call
- Status: available
- `aweme_id` (string, required; example "7372484719365098803"): Video id
- `cursor` (integer, optional; example 0): Cursor
- `count` (integer, optional; example 20): Number

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

### Douyin — User posts

- Endpoint: `GET /v1/social/douyin/user-posts`
- Model ID: `social-douyin-user-posts`
- Price: $0.002 USD / successful call
- Status: available
- `sec_user_id` (string, required; example "MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE"): User sec_user_id
- `max_cursor` (string, optional; example "0"): Maximum cursor
- `count` (integer, optional; example 20): Number per page
- `filter_type` (string, optional; example "0"): Filter type

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

### Douyin — Trending

- Endpoint: `GET /v1/social/douyin/trending`
- Model ID: `social-douyin-trending`
- Price: $0.002 USD / successful call
- Status: available
- No query parameters.

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

### Xiaohongshu (RED) — Search posts

- Endpoint: `GET /v1/social/xiaohongshu/search`
- Model ID: `social-xiaohongshu-search`
- Price: $0.02 USD / successful call
- Status: available
- `keyword` (string, required; example "美食推荐"): Search keyword
- `page` (integer, optional; example 1): Page number, start from 1
- `sort_type` (string, optional; example "general"): Sort type
- `note_type` (string, optional; example "不限"): Note type: 不限 (all), 视频笔记 (video), 普通笔记 (standard), 直播笔记 (live). Send the literal Chinese value.
- `time_filter` (string, optional; example "不限"): Time filter: 不限 (all), 一天内 (one day), 一周内 (one week), 半年内 (half year). Send the literal Chinese value.
- `search_id` (string, optional; example ""): Search ID for pagination
- `search_session_id` (string, optional; example ""): Search session ID for pagination
- `source` (string, optional; example "explore_feed"): Source
- `ai_mode` (integer, optional; example 0): AI mode: 0=off, 1=on

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

### Xiaohongshu (RED) — Post details

- Endpoint: `GET /v1/social/xiaohongshu/post`
- Model ID: `social-xiaohongshu-post`
- Price: $0.02 USD / successful call
- Status: available
- Provide at least one of: note_id, share_text.
- `note_id` (string, optional; example "697c0eee000000000a03c308"): Note ID
- `share_text` (string, optional; example "http://xhslink.com/o/8GqargIxrko"): xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn

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

### Xiaohongshu (RED) — Profiles

- Endpoint: `GET /v1/social/xiaohongshu/user`
- Model ID: `social-xiaohongshu-user`
- Price: $0.02 USD / successful call
- Status: available
- Provide at least one of: user_id, share_text.
- `user_id` (string, optional; example "61b46d790000000010008153"): User ID
- `share_text` (string, optional; example "https://xhslink.com/m/3ZSCJZAMz0a"): xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn

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

### Xiaohongshu (RED) — Comments

- Endpoint: `GET /v1/social/xiaohongshu/comments`
- Model ID: `social-xiaohongshu-comments`
- Price: $0.02 USD / successful call
- Status: available
- Provide at least one of: note_id, share_text.
- `note_id` (string, optional; example "697c0eee000000000a03c308"): Note ID
- `share_text` (string, optional; example "http://xhslink.com/o/8GqargIxrko"): xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn
- `cursor` (string, optional; example ""): Pagination cursor, leave empty for first request
- `index` (integer, optional; example 0): Comment index, pass 0 for first request
- `pageArea` (string, optional; example "UNFOLDED"): Fold state: UNFOLDED (default), FOLDED.
- `sort_strategy` (string, optional; example "latest_v2"): Sort strategy: default, latest_v2, like_count

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

### Xiaohongshu (RED) — User posts

- Endpoint: `GET /v1/social/xiaohongshu/user-posts`
- Model ID: `social-xiaohongshu-user-posts`
- Price: $0.02 USD / successful call
- Status: available
- Provide at least one of: user_id, share_text.
- `user_id` (string, optional; example "61b46d790000000010008153"): User ID
- `share_text` (string, optional; example "http://xhslink.com/o/8GqargIxrko"): xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn
- `cursor` (string, optional; example ""): Pagination cursor, leave empty for first request

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

### Kuaishou — Search posts

- Endpoint: `GET /v1/social/kuaishou/search`
- Model ID: `social-kuaishou-search`
- Price: $0.02 USD / successful call
- Status: available
- `keyword` (string, required; example "人工智能"): Search keyword
- `pcursor` (string, optional; example ""): Empty for first page, pass pcursor from previous response

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

### Kuaishou — Post details

- Endpoint: `GET /v1/social/kuaishou/post`
- Model ID: `social-kuaishou-post`
- Price: $0.002 USD / successful call
- Status: available
- `share_text` (string, required; example "https://v.kuaishou.com/cNYP0Z"): Photo URL

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

### Kuaishou — Profiles

- Endpoint: `GET /v1/social/kuaishou/user`
- Model ID: `social-kuaishou-user`
- Price: $0.02 USD / successful call
- Status: available
- `user_id` (string, required; example "3xz63mn6fngqtiq"): User ID

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

### Kuaishou — Comments

- Endpoint: `GET /v1/social/kuaishou/comments`
- Model ID: `social-kuaishou-comments`
- Price: $0.002 USD / successful call
- Status: available
- `photo_id` (string, required; example "3x7gxp2zhgjv832"): Photo ID
- `pcursor` (string, optional): Comment cursor

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

### Kuaishou — User posts

- Endpoint: `GET /v1/social/kuaishou/user-posts`
- Model ID: `social-kuaishou-user-posts`
- Price: $0.02 USD / successful call
- Status: available
- `user_id` (string, required; example "903511772"): User ID
- `pcursor` (string, optional; example ""): Leave empty for the first request; then use pcursor from the previous response.
- `sort` (string, optional; example "latest"): latest (default, newest) / hot (popular)

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

### Kuaishou — Trending

- Endpoint: `GET /v1/social/kuaishou/trending`
- Model ID: `social-kuaishou-trending`
- Price: $0.002 USD / successful call
- Status: available
- No query parameters.

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

### Bilibili — Search posts

- Endpoint: `GET /v1/social/bilibili/search`
- Model ID: `social-bilibili-search`
- Price: $0.002 USD / successful call
- Status: available
- `keyword` (string, required; example "火影忍者"): Search keyword
- `order` (string, required; default "totalrank"; example "totalrank"): Order method
- `page` (integer, required; default 1; example 1): Page number
- `page_size` (integer, required; default 20; example 42): Number per page
- `duration` (integer, optional; example 0): Duration filter
- `pubtime_begin_s` (integer, optional; example 0): Start date (10-digit timestamp)
- `pubtime_end_s` (integer, optional; example 0): End date (10-digit timestamp)

```bash
curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/bilibili/search" \
  -H "Authorization: Bearer $CHINAAPI_API_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`
- Model ID: `social-bilibili-post`
- Price: $0.002 USD / successful call
- Status: available
- `url` (string, required; example "https://www.bilibili.com/video/BV1S5uKzzE4r"): Video URL

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

### Bilibili — Profiles

- Endpoint: `GET /v1/social/bilibili/user`
- Model ID: `social-bilibili-user`
- Price: $0.002 USD / successful call
- Status: available
- `uid` (string, required; example "178360345"): User UID

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

### Bilibili — Comments

- Endpoint: `GET /v1/social/bilibili/comments`
- Model ID: `social-bilibili-comments`
- Price: $0.002 USD / successful call
- Status: available
- `bv_id` (string, required; example "BV1M1421t7hT"): Video id
- `pn` (integer, optional; example 1): Page number

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

### Bilibili — User posts

- Endpoint: `GET /v1/social/bilibili/user-posts`
- Model ID: `social-bilibili-user-posts`
- Price: $0.002 USD / successful call
- Status: available
- `uid` (string, required; example "178360345"): User UID
- `pn` (integer, optional; example 1): Page number, max 100
- `ps` (integer, optional; example 25): Page size, max 50
- `order` (string, optional; example "pubdate"): Order method

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

### Bilibili — Trending

- Endpoint: `GET /v1/social/bilibili/trending`
- Model ID: `social-bilibili-trending`
- Price: $0.002 USD / successful call
- Status: available
- `pn` (integer, optional; example 1): Page number

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

### Weibo — Search posts

- Endpoint: `GET /v1/social/weibo/search`
- Model ID: `social-weibo-search`
- Price: $0.002 USD / successful call
- Status: available
- `query` (string, required; example "NVIDIA"): Search keyword
- `page` (integer, optional; example 1): Page number
- `search_type` (integer, optional; example 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 --fail-with-body --get "https://api.chinaapi.ai/v1/social/weibo/search" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'query=NVIDIA'
```

### Weibo — Post details

- Endpoint: `GET /v1/social/weibo/post`
- Model ID: `social-weibo-post`
- Price: $0.002 USD / successful call
- Status: available
- `status_id` (string, required; example "5016922058656962"): Weibo post ID

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

### Weibo — Profiles

- Endpoint: `GET /v1/social/weibo/user`
- Model ID: `social-weibo-user`
- Price: $0.002 USD / successful call
- Status: available
- `uid` (string, required; example "7648703289"): User ID

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

### Weibo — Comments

- Endpoint: `GET /v1/social/weibo/comments`
- Model ID: `social-weibo-comments`
- Price: $0.002 USD / successful call
- Status: available
- `status_id` (string, required; example "5258708168476831"): Weibo post ID
- `max_id` (string, optional): Pagination cursor
- `sort_type` (string, optional; example "0"): Sort type: 0=popularity, 1=time.

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

### Weibo — User posts

- Endpoint: `GET /v1/social/weibo/user-posts`
- Model ID: `social-weibo-user-posts`
- Price: $0.002 USD / successful call
- Status: available
- `uid` (string, required; example "7648703289"): User ID
- `page` (integer, optional; example 1): Page number
- `filter_type` (string, optional; example "all"): Filter type
- `month` (string, optional; example "20251010"): Time filter (YYYYMMDD).

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

### Weibo — Trending

- Endpoint: `GET /v1/social/weibo/trending`
- Model ID: `social-weibo-trending`
- Price: $0.003 USD / successful call
- Status: available
- No query parameters.

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

### Zhihu — Search posts

- Endpoint: `GET /v1/social/zhihu/search`
- Model ID: `social-zhihu-search`
- Price: $0.002 USD / successful call
- Status: available
- `keyword` (string, required): Search Keywords
- `offset` (string, optional; example "0"): Offset
- `limit` (string, optional; example "20"): Number of articles per page
- `show_all_topics` (integer, optional; example 0): Show all topics
- `search_source` (string, optional; example "Normal"): Search Source
- `search_hash_id` (string, optional; example ""): Search Hash ID
- `vertical` (string, optional; example ""): Vertical Type
- `sort` (string, optional; example ""): Sort
- `time_interval` (string, optional; example ""): Time Interval
- `vertical_info` (string, optional; example ""): Vertical Info

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

### Zhihu — Post details

- Endpoint: `GET /v1/social/zhihu/post`
- Model ID: `social-zhihu-post`
- Price: $0.002 USD / successful call
- Status: available
- `answer_id` (string, required): Answer ID

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

### Zhihu — Profiles

- Endpoint: `GET /v1/social/zhihu/user`
- Model ID: `social-zhihu-user`
- Price: $0.002 USD / successful call
- Status: available
- `user_url_token` (string, required): User ID

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

### Zhihu — Comments

- Endpoint: `GET /v1/social/zhihu/comments`
- Model ID: `social-zhihu-comments`
- Price: $0.002 USD / successful call
- Status: available
- `answer_id` (string, required): Answer ID
- `order_by` (string, optional; example "score"): Sort
- `limit` (string, optional; example "20"): Number of comments per page
- `offset` (string, optional; example ""): Offset

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

### Zhihu — Trending

- Endpoint: `GET /v1/social/zhihu/trending`
- Model ID: `social-zhihu-trending`
- Price: $0.002 USD / successful call
- Status: available
- `limit` (string, optional; example "50"): Number of articles per page
- `desktop` (string, optional; example "true"): Is it a desktop

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

### WeChat Channels — Search posts

- Endpoint: `GET /v1/social/wechat-channels/search`
- Model ID: `social-wechat-channels-search`
- Price: $0.02 USD / successful call
- Status: available
- `keyword` (string, required; example "美食"): Search keyword (1-100 chars)
- `duration` (integer, optional; example "short"): Duration tier (Channels video only): all/0 / short/1 (<5min) / medium/2 (5-10min) / long/3 (20min+); stri
- `sort` (integer, optional; example "hot"): Sort: default/0 (relevance) / latest/1 (newest) / hot/2 (most liked); string key or integer
- `publish_time` (integer, optional; example "week"): Publish time: all/0 / day/1 / week/2 / half_year/3; string key or integer
- `offset` (integer, optional; example 0): Pass 0 for the first page; use cursor to paginate (offset alone does not work)
- `cursor` (string, optional): Pagination cursor, same as universal search: leave empty for the first page; pass back the cursor from the previous response

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

### WeChat Channels — Post details

- Endpoint: `GET /v1/social/wechat-channels/post`
- Model ID: `social-wechat-channels-post`
- Price: $0.02 USD / successful call
- Status: available
- Provide at least one of: object_id, export_id, share_url.
- `object_id` (string, optional; example "14941130915890399732"): Video objectId (numeric, highest priority)
- `export_id` (string, optional; example ""): exportId from search results (starts with export/, expires soon)
- `object_nonce_id` (string, optional; example ""): Optional objectNonceId (numeric, improves hit rate)
- `share_url` (string, optional; example ""): Share URL (https://weixin.qq.com/sph/…), used only when object_id and export_id are empty
- `raw` (boolean, optional; example true): True=raw response; False=simplified parsed structure (recommended for media download)

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

### WeChat Channels — Profiles

- Endpoint: `GET /v1/social/wechat-channels/user`
- Model ID: `social-wechat-channels-user`
- Price: $0.02 USD / successful call
- Status: available
- `username` (string, required; example "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder"): WeChat Channels finder username (v2_…@finder format)
- `raw` (boolean, optional; example true): True=raw response; False=simplified parsed structure

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

### WeChat Channels — Comments

- Endpoint: `GET /v1/social/wechat-channels/comments`
- Model ID: `social-wechat-channels-comments`
- Price: $0.02 USD / successful call
- Status: available
- `object_id` (string, required; example "14941130915890399732"): Video objectId (numeric)
- `last_buffer` (string, optional; example ""): Pagination cursor (base64), leave empty for first page
- `comment_id` (string, optional; example ""): Pass a commentId (numeric) to expand its replies, leave empty for first-level comments
- `raw` (boolean, optional; example true): True=raw response; False=simplified parsed structure

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

### WeChat Channels — User posts

- Endpoint: `GET /v1/social/wechat-channels/user-posts`
- Model ID: `social-wechat-channels-user-posts`
- Price: $0.02 USD / successful call
- Status: available
- `username` (string, required; example "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder"): WeChat Channels finder username (v2_…@finder format)
- `last_buffer` (string, optional; example ""): Pagination cursor (base64), leave empty for first page
- `raw` (boolean, optional; example true): True=raw response; False=simplified parsed structure (recommended for media download)

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

### WeChat Official Accounts — Search posts

- Endpoint: `GET /v1/social/wechat-mp/search`
- Model ID: `social-wechat-mp-search`
- Price: $0.02 USD / successful call
- Status: available
- `keyword` (string, required; example "人民日报"): Search keyword (1-100 chars)
- `sort` (integer, optional; example "hot"): Sort (result page 'sort' dropdown, common to all verticals): default/0 (relevance) / latest/1 (newest) / hot/2
- `publish_time` (integer, optional; example "week"): Publish time (result page 'time' dropdown, common): all/0 / day/1 / week/2 / half_year/3; string key or integer
- `offset` (integer, optional; example 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, optional): Pagination cursor: leave empty for the first page; for the next page pass back the cursor returned in the previous response

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

### WeChat Official Accounts — Post details

- Endpoint: `GET /v1/social/wechat-mp/post`
- Model ID: `social-wechat-mp-post`
- Price: $0.02 USD / successful call
- Status: available
- `url` (string, required; example "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw"): WeChat MP article URL (https://mp.weixin.qq.com/s/… or long URL with __biz)
- `raw` (boolean, optional; example true): True=raw response; False=simplified parsed structure

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

### WeChat Official Accounts — Profiles

- Endpoint: `GET /v1/social/wechat-mp/user`
- Model ID: `social-wechat-mp-user`
- Price: $0.02 USD / successful call
- Status: available
- `username` (string, required; example "gh_363b924965e9"): Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-lin
- `raw` (boolean, optional; example true): True=raw response; False=simplified parsed structure

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

### WeChat Official Accounts — Comments

- Endpoint: `GET /v1/social/wechat-mp/comments`
- Model ID: `social-wechat-mp-comments`
- Price: $0.02 USD / successful call
- Status: available
- `url` (string, required; example "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw"): mp.weixin.qq.com/s/…）/WeChat MP article URL (https://mp.weixin.qq.com/s/…)
- `buffer` (string, optional; example ""): Pagination cursor, leave empty for first page; pass buffer from the previous response
- `comment_id` (string, optional): Optional article comment ID. Reuse data.content.comment_id from an article-details response when available to reduce retrieval work.
- `raw` (boolean, optional; example true): True=raw response; False=simplified parsed structure

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

### WeChat Official Accounts — User posts

- Endpoint: `GET /v1/social/wechat-mp/user-posts`
- Model ID: `social-wechat-mp-user-posts`
- Price: $0.02 USD / successful call
- Status: available
- `username` (string, required; example "gh_363b924965e9"): Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-lin
- `page_size` (integer, optional; example 20): next_offset/Articles per page (default 20). NOTE: WeChat currently ignores this parameter — the count is decided by the accou
- `offset` (string, optional; example ""): Pagination cursor (base64), leave empty for first page; for the next page pass next_offset from the previous response
- `item_show_type` (integer, optional): Content tab: empty/0=articles (default), 5=videos, 7=audios, 8=image-text posts
- `raw` (boolean, optional; example true): True=raw response; False=simplified parsed structure

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

### WeChat Search — Search posts

- Endpoint: `GET /v1/social/wechat-search/search`
- Model ID: `social-wechat-search-search`
- Price: $0.02 USD / successful call
- Status: available
- `keyword` (string, required; example "人民日报"): Search keyword (1-100 chars)
- `business_type` (string, optional; example "account"): Search category. Tested categories with results: all, account, article, video, sticker. Other categories may return no data.
- `sort` (integer, optional; example "hot"): Sort (result page 'sort' dropdown, common to all verticals): default/0 (relevance) / latest/1 (newest) / hot/2
- `publish_time` (integer, optional; example "week"): Publish time (result page 'time' dropdown, common): all/0 / day/1 / week/2 / half_year/3; string key or integer
- `offset` (integer, optional; example 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, optional): Pagination cursor: leave empty for the first page; for the next page pass back the cursor returned in the previous response
- `raw` (boolean, optional; example true): True=raw search response; False=simplified parsed structure

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

### Toutiao — Post details

- Endpoint: `GET /v1/social/toutiao/post`
- Model ID: `social-toutiao-post`
- Price: $0.002 USD / successful call
- Status: available
- `aweme_id` (string, required; example "7450114952884503059"): Post ID

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

### Toutiao — Profiles

- Endpoint: `GET /v1/social/toutiao/user`
- Model ID: `social-toutiao-user`
- Price: $0.002 USD / successful call
- Status: available
- `user_id` (string, required; example "1352838578180211"): User ID

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

### Toutiao — Comments

- Endpoint: `GET /v1/social/toutiao/comments`
- Model ID: `social-toutiao-comments`
- Price: $0.002 USD / successful call
- Status: available
- `group_id` (string, required; example "7453372680222523931"): Post ID
- `offset` (string, required; example "0"): Offset

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

### Xigua Video — Search posts

- Endpoint: `GET /v1/social/xigua/search`
- Model ID: `social-xigua-search`
- Price: $0.002 USD / successful call
- Status: available
- `keyword` (string, required; example "抖音"): Keyword
- `offset` (integer, optional; example 0): Offset
- `order_type` (string, optional): Order type
- `min_duration` (integer, optional): Minimum duration
- `max_duration` (integer, optional): Maximum duration

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

### Xigua Video — Post details

- Endpoint: `GET /v1/social/xigua/post`
- Model ID: `social-xigua-post`
- Price: $0.002 USD / successful call
- Status: available
- `item_id` (string, required; example "7354954305222377999"): Video id

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

### Xigua Video — Profiles

- Endpoint: `GET /v1/social/xigua/user`
- Model ID: `social-xigua-user`
- Price: $0.002 USD / successful call
- Status: available
- `user_id` (string, required; example "52712347586"): User id

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

### Xigua Video — Comments

- Endpoint: `GET /v1/social/xigua/comments`
- Model ID: `social-xigua-comments`
- Price: $0.002 USD / successful call
- Status: available
- `item_id` (string, required; example "7354954305222377999"): Video id
- `offset` (integer, optional; example 0): Offset
- `count` (integer, optional; example 20): Count

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

### Xigua Video — User posts

- Endpoint: `GET /v1/social/xigua/user-posts`
- Model ID: `social-xigua-user-posts`
- Price: $0.002 USD / successful call
- Status: available
- `user_id` (string, required; example "1922379661976311"): User id
- `max_behot_time` (string, optional): Maximum behavior time

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

### Pipixia — Search posts

- Endpoint: `GET /v1/social/pipixia/search`
- Model ID: `social-pipixia-search`
- Price: $0.002 USD / successful call
- Status: available
- `keyword` (string, required; example "皮皮虾"): Search keyword
- `offset` (string, optional; example "0"): Page cursor
- `search_type` (string, optional; example "1"): Search type

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

### Pipixia — Post details

- Endpoint: `GET /v1/social/pipixia/post`
- Model ID: `social-pipixia-post`
- Price: $0.002 USD / successful call
- Status: available
- `cell_id` (string, required; example "7411193113223371043"): Video id
- `cell_type` (integer, optional; example 1): Video type

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

### Pipixia — Profiles

- Endpoint: `GET /v1/social/pipixia/user`
- Model ID: `social-pipixia-user`
- Price: $0.002 USD / successful call
- Status: available
- `user_id` (string, required; example "1020401"): User id

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

### Pipixia — Comments

- Endpoint: `GET /v1/social/pipixia/comments`
- Model ID: `social-pipixia-comments`
- Price: $0.002 USD / successful call
- Status: available
- `cell_id` (string, required; example "7411193113223371043"): Video id
- `cell_type` (integer, optional; example 1): Video type
- `offset` (string, optional; example "0"): Page cursor

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

### Pipixia — User posts

- Endpoint: `GET /v1/social/pipixia/user-posts`
- Model ID: `social-pipixia-user-posts`
- Price: $0.002 USD / successful call
- Status: available
- `user_id` (string, required; example "1310254082831248"): User id
- `cursor` (string, optional; example "0"): Page cursor
- `feed_count` (string, optional; example "0"): Page count

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

### Pipixia — Trending

- Endpoint: `GET /v1/social/pipixia/trending`
- Model ID: `social-pipixia-trending`
- Price: $0.002 USD / successful call
- Status: available
- No query parameters.

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

### TikTok — Search posts

- Endpoint: `GET /v1/social/tiktok/search`
- Model ID: `social-tiktok-search`
- Price: $0.002 USD / successful call
- Status: available
- `keyword` (string, required; example "TikTok"): Search keyword
- `offset` (integer, optional; example 0): Page cursor
- `search_id` (string, optional; example ""): Search id, need to provide when paging

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

### TikTok — Post details

- Endpoint: `GET /v1/social/tiktok/post`
- Model ID: `social-tiktok-post`
- Price: $0.002 USD / successful call
- Status: available
- `itemId` (string, required; example "7339393672959757570"): Video id
- `region` (string, optional; example "US"): Region code, optional; affects content region, e.g. US/GB/JP/ID, default US.

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

### TikTok — Profiles

- Endpoint: `GET /v1/social/tiktok/user`
- Model ID: `social-tiktok-user`
- Price: $0.002 USD / successful call
- Status: available
- Provide at least one of: uniqueId, secUid.
- `uniqueId` (string, optional; example "tiktok"): User uniqueId
- `secUid` (string, optional; example ""): User secUid

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

### TikTok — Comments

- Endpoint: `GET /v1/social/tiktok/comments`
- Model ID: `social-tiktok-comments`
- Price: $0.002 USD / successful call
- Status: available
- `aweme_id` (string, required; example "7304809083817774382"): Video id
- `cursor` (integer, optional; example 0): Page cursor
- `count` (integer, optional; example 20): Number per page
- `current_region` (string, optional; example ""): Current region

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

### TikTok — User posts

- Endpoint: `GET /v1/social/tiktok/user-posts`
- Model ID: `social-tiktok-user-posts`
- Price: $0.002 USD / successful call
- Status: available
- `secUid` (string, required; example "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"): User secUid
- `cursor` (integer, optional; example 0): Page cursor
- `count` (integer, optional; example 15): Number per page, max 15
- `coverFormat` (integer, optional; example 2): Cover format
- `post_item_list_request_type` (integer, optional; example 0): Sort type (deprecated, no longer effective)

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

### TikTok — Trending

- Endpoint: `GET /v1/social/tiktok/trending`
- Model ID: `social-tiktok-trending`
- Price: $0.002 USD / successful call
- Status: available
- `count` (integer, optional; example 15): Number per page
- `region` (string, optional; example "US"): Region code, optional, affects the region of recommended content, e.g. US/GB/JP/KR/SG, default US.

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

### Instagram — Search posts

- Endpoint: `GET /v1/social/instagram/search`
- Model ID: `social-instagram-search`
- Price: $0.004 USD / successful call
- Status: available
- `keyword` (string, required; example "cat"): Search keyword
- `pagination_token` (string, optional): Pagination token

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

### Instagram — Post details

- Endpoint: `GET /v1/social/instagram/post`
- Model ID: `social-instagram-post`
- Price: $0.002 USD / successful call
- Status: available
- `post_url` (string, required; example "https://www.instagram.com/p/DPwhVB-jo9k/"): Post URL

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

### Instagram — Profiles

- Endpoint: `GET /v1/social/instagram/user`
- Model ID: `social-instagram-user`
- Price: $0.002 USD / successful call
- Status: available
- `username` (string, required; example "instagram"): Instagram username

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

### Instagram — Comments

- Endpoint: `GET /v1/social/instagram/comments`
- Model ID: `social-instagram-comments`
- Price: $0.004 USD / successful call
- Status: available
- `code_or_url` (string, required; example "DRhvwVLAHAG"): Post shortcode or URL
- `sort_by` (string, optional; example "recent"): Sort by: recent or popular
- `pagination_token` (string, optional; example ""): Pagination token

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

### Instagram — User posts

- Endpoint: `GET /v1/social/instagram/user-posts`
- Model ID: `social-instagram-user-posts`
- Price: $0.004 USD / successful call
- Status: available
- Provide at least one of: username, user_id.
- `username` (string, optional; example "instagram"): Username
- `user_id` (string, optional; example "18527"): User ID
- `pagination_token` (string, optional): Pagination token

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

### Instagram — Trending

- Endpoint: `GET /v1/social/instagram/trending`
- Model ID: `social-instagram-trending`
- Price: $0.016 USD / successful call
- Status: available
- `max_id` (string, optional): Pagination cursor, omit for first request, get from previous response next_max_id

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

### YouTube — Search posts

- Endpoint: `GET /v1/social/youtube/search`
- Model ID: `social-youtube-search`
- Price: $0.004 USD / successful call
- Status: available
- Provide at least one of: keyword, continuation_token.
- `keyword` (string, optional; example "Python tutorial"): Search keyword (required for first request)
- `continuation_token` (string, optional): Continuation token for next page
- `upload_date` (string, optional): Upload date filter
- `type` (string, optional): Type filter
- `duration` (string, optional): Duration filter: short (<4min), medium (4-20min), long (>20min)
- `features` (string, optional): Feature filter (comma separated): live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr
- `sort_by` (string, optional): Sort by

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

### YouTube — Post details

- Endpoint: `GET /v1/social/youtube/post`
- Model ID: `social-youtube-post`
- Price: $0.002 USD / successful call
- Status: available
- Provide at least one of: video_id, video_url.
- `video_id` (string, optional; example "dQw4w9WgXcQ"): Video ID
- `video_url` (string, optional; example "https://www.youtube.com/watch?v=dQw4w9WgXcQ"): Video URL (ignored when video_id is provided).
- `need_format` (boolean, optional; example true): Whether to return cleaned payload

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

### YouTube — Profiles

- Endpoint: `GET /v1/social/youtube/user`
- Model ID: `social-youtube-user`
- Price: $0.002 USD / successful call
- Status: available
- `channel_id` (string, required; example "UCXuqSBlHAE6Xw-yeJA0Tunw"): Channel ID

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

### YouTube — Comments

- Endpoint: `GET /v1/social/youtube/comments`
- Model ID: `social-youtube-comments`
- Price: $0.002 USD / successful call
- Status: available
- `video_id` (string, required; example "LuIL5JATZsc"): Video ID
- `language_code` (string, optional; example "zh-CN"): Language code
- `country_code` (string, optional; example "US"): Country code
- `sort_by` (string, optional; example "top"): Sort by
- `continuation_token` (string, optional): Pagination token
- `need_format` (boolean, optional; example true): Whether to clean and format the data

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

### YouTube — User posts

- Endpoint: `GET /v1/social/youtube/user-posts`
- Model ID: `social-youtube-user-posts`
- Price: $0.002 USD / successful call
- Status: available
- `channel_id` (string, required; example "UCJHBJ7F-nAIlMGolm0Hu4vg"): Channel ID
- `language_code` (string, optional; example "zh-CN"): Language code
- `country_code` (string, optional; example "US"): Country code
- `continuation_token` (string, optional): Pagination token for next page
- `need_format` (boolean, optional; example true): Whether to clean and format the data

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

### X (Twitter) — Search posts

- Endpoint: `GET /v1/social/twitter/search`
- Model ID: `social-twitter-search`
- Price: $0.002 USD / successful call
- Status: available
- `keyword` (string, required; example "Elon Musk"): Search Keyword
- `search_type` (string, optional; example "Top"): Search Type
- `cursor` (string, optional): Cursor

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

### X (Twitter) — Post details

- Endpoint: `GET /v1/social/twitter/post`
- Model ID: `social-twitter-post`
- Price: $0.002 USD / successful call
- Status: available
- `tweet_id` (string, required; example "1808168603721650364"): Tweet ID

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

### X (Twitter) — Profiles

- Endpoint: `GET /v1/social/twitter/user`
- Model ID: `social-twitter-user`
- Price: $0.002 USD / successful call
- Status: available
- Provide at least one of: screen_name, rest_id.
- `screen_name` (string, optional; example "elonmusk"): Screen Name
- `rest_id` (integer, optional; example "44196397"): User ID (If the user ID is used, the user name will be ignored)

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

### X (Twitter) — Comments

- Endpoint: `GET /v1/social/twitter/comments`
- Model ID: `social-twitter-comments`
- Price: $0.002 USD / successful call
- Status: available
- `tweet_id` (string, required; example "1835124037934367098"): Tweet ID
- `cursor` (string, optional): Cursor

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

### X (Twitter) — User posts

- Endpoint: `GET /v1/social/twitter/user-posts`
- Model ID: `social-twitter-user-posts`
- Price: $0.002 USD / successful call
- Status: available
- Provide at least one of: screen_name, rest_id.
- `screen_name` (string, optional; example "elonmusk"): Screen Name
- `rest_id` (integer, optional; example "44196397"): User ID
- `cursor` (string, optional): Cursor

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

### X (Twitter) — Trending

- Endpoint: `GET /v1/social/twitter/trending`
- Model ID: `social-twitter-trending`
- Price: $0.002 USD / successful call
- Status: available
- `country` (string, optional; example "UnitedStates"): Country

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

### Reddit — Search posts

- Endpoint: `GET /v1/social/reddit/search`
- Model ID: `social-reddit-search`
- Price: $0.002 USD / successful call
- Status: available
- `language` (string, optional; example "en-US"): Preferred response language as an IETF language tag; default: en-US
- `query` (string, required; example "python programming"): Search query
- `search_type` (string, optional; example "post"): Search type: post, community, comment, media, people.
- `sort` (string, optional; example "RELEVANCE"): Sort method (post/comment/media only): RELEVANCE, HOT, TOP, NEW, COMMENTS (post only).
- `time_range` (string, optional; example "all"): Time range (post/media only): all, year, month, week, day, hour.
- `safe_search` (string, optional; example "unset"): Safe search setting: unset, strict
- `allow_nsfw` (string, optional; example "0"): Allow NSFW content: 0, 1
- `after` (string, optional; example ""): Pagination parameter
- `need_format` (boolean, optional; example false): Whether to clean and format the data

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

### Reddit — Post details

- Endpoint: `GET /v1/social/reddit/post`
- Model ID: `social-reddit-post`
- Price: $0.002 USD / successful call
- Status: available
- `language` (string, optional; example "en-US"): Preferred response language as an IETF language tag; default: en-US
- `post_id` (string, required; example "t3_1ojnh50"): Post ID
- `include_comment_id` (boolean, optional; example false): Include specific comment ID
- `comment_id` (string, optional; example ""): Comment ID (when include_comment_id is True)
- `need_format` (boolean, optional; example false): Whether to clean and format the data

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

### Reddit — Profiles

- Endpoint: `GET /v1/social/reddit/user`
- Model ID: `social-reddit-user`
- Price: $0.002 USD / successful call
- Status: available
- `language` (string, optional; example "en-US"): Preferred response language as an IETF language tag; default: en-US
- `username` (string, required; example "spez"): Username
- `need_format` (boolean, optional; example false): Whether to clean and format the data

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

### Reddit — Comments

- Endpoint: `GET /v1/social/reddit/comments`
- Model ID: `social-reddit-comments`
- Price: $0.002 USD / successful call
- Status: available
- `language` (string, optional; example "en-US"): Preferred response language as an IETF language tag; default: en-US
- `post_id` (string, required; example "t3_1ojnvca"): Post ID
- `sort_type` (string, optional; example "CONFIDENCE"): Sort method: CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM
- `after` (string, optional; example ""): Pagination parameter for fetching next page
- `need_format` (boolean, optional; example false): Whether to clean and format the data

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

### Reddit — User posts

- Endpoint: `GET /v1/social/reddit/user-posts`
- Model ID: `social-reddit-user-posts`
- Price: $0.002 USD / successful call
- Status: available
- `language` (string, optional; example "en-US"): Preferred response language as an IETF language tag; default: en-US
- `username` (string, required; example "spez"): Username
- `sort` (string, optional; example "NEW"): Sort method: NEW, TOP, HOT, CONTROVERSIAL
- `after` (string, optional; example ""): Pagination parameter
- `need_format` (boolean, optional; example false): Whether to clean and format the data

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

### Reddit — Trending

- Endpoint: `GET /v1/social/reddit/trending`
- Model ID: `social-reddit-trending`
- Price: $0.002 USD / successful call
- Status: available
- `language` (string, optional; example "en-US"): Preferred response language as an IETF language tag; default: en-US
- `need_format` (boolean, optional; example false): Whether to clean and format the data

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

### LinkedIn — Post details

- Endpoint: `GET /v1/social/linkedin/post`
- Model ID: `social-linkedin-post`
- Price: $0.002 USD / successful call
- Status: available
- `url` (string, required; example "https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"): Post or article URL

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

### LinkedIn — Profiles

- Endpoint: `GET /v1/social/linkedin/user`
- Model ID: `social-linkedin-user`
- Price: $0.016 USD / successful call
- Status: available
- `url` (string, required; example "https://www.linkedin.com/in/williamhgates/"): Full profile URL

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

### LinkedIn — Comments

- Endpoint: `GET /v1/social/linkedin/comments`
- Model ID: `social-linkedin-comments`
- Price: $0.1 USD / successful call
- Status: available
- `urn` (string, required; example "7267273010393358336"): Post activity urn
- `sort_by` (string, optional): Most relevant (default) | Most recent
- `page` (integer, optional): Page number, starts at 1
- `pagination_token` (string, optional): Pagination token
- `share_urn` (string, optional): Share urn (optional)

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

### LinkedIn — User posts

- Endpoint: `GET /v1/social/linkedin/user-posts`
- Model ID: `social-linkedin-user-posts`
- Price: $0.1 USD / successful call
- Status: available
- `url` (string, required; example "https://www.linkedin.com/in/williamhgates/"): Profile URL
- `type` (string, optional; example "posts"): posts (posts/reposts) | comments (commented posts) | reactions (liked posts)
- `start` (integer, optional): Pagination offset
- `pagination_token` (string, optional): Pagination token

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

### Threads — Search posts

- Endpoint: `GET /v1/social/threads/search`
- Model ID: `social-threads-search`
- Price: $0.004 USD / successful call
- Status: available
- `query` (string, required; example "bitcoin"): Search query

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

### Threads — Post details

- Endpoint: `GET /v1/social/threads/post`
- Model ID: `social-threads-post`
- Price: $0.004 USD / successful call
- Status: available
- `post_id` (string, required; example "3349029093483693129"): Post ID

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

### Threads — Profiles

- Endpoint: `GET /v1/social/threads/user`
- Model ID: `social-threads-user`
- Price: $0.004 USD / successful call
- Status: available
- `username` (string, required; example "jlo"): Username

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

### Threads — User posts

- Endpoint: `GET /v1/social/threads/user-posts`
- Model ID: `social-threads-user-posts`
- Price: $0.004 USD / successful call
- Status: available
- `user_id` (string, required; example "63625256886"): User ID
- `end_cursor` (string, optional): Pagination cursor (no pagination, has no effect)

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

### Lemon8 — Search posts

- Endpoint: `GET /v1/social/lemon8/search`
- Model ID: `social-lemon8-search`
- Price: $0.002 USD / successful call
- Status: available
- `query` (string, required; example "lemon8"): Search keyword
- `max_cursor` (string, optional; example ""): Pagination parameter
- `filter_type` (string, optional; example ""): Search filter type
- `order_by` (string, optional; example ""): Search sort type
- `search_tab` (string, optional; example "main"): Search type

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

### Lemon8 — Post details

- Endpoint: `GET /v1/social/lemon8/post`
- Model ID: `social-lemon8-post`
- Price: $0.002 USD / successful call
- Status: available
- `item_id` (string, required; example "7361926875709129222"): Post ID

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

### Lemon8 — Profiles

- Endpoint: `GET /v1/social/lemon8/user`
- Model ID: `social-lemon8-user`
- Price: $0.002 USD / successful call
- Status: available
- `user_id` (string, required; example "7217844966059656197"): User ID

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

### Lemon8 — Comments

- Endpoint: `GET /v1/social/lemon8/comments`
- Model ID: `social-lemon8-comments`
- Price: $0.002 USD / successful call
- Status: available
- `group_id` (string, required; example "7361926875709129222"): Post's group_id
- `item_id` (string, required; example "7361926875709129222"): Post's item_id
- `media_id` (string, required; example "7428056850216862763"): Post's media_id
- `offset` (string, optional; example "0"): Pagination parameter

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

### Lemon8 — Trending

- Endpoint: `GET /v1/social/lemon8/trending`
- Model ID: `social-lemon8-trending`
- Price: $0.002 USD / successful call
- Status: available
- No query parameters.

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