API reference · beta

Social data API reference

101 available GET endpoints. Platform-specific parameters, required alternatives and USD prices come from one public catalog snapshot.

Coverage and beta terms Create an account

Authentication and eligibility

Base URL: https://api.chinaapi.ai. Send Authorization: Bearer $CHINAAPI_API_KEY. A completed first top-up is required; this API shares your model key and balance.

Public social catalog (no authentication). Snapshot: 2026-09-29T22:19:36Z. Recheck the live catalog before integration because beta coverage and rates may change.

Beta: paid accounts only. Complete your first top-up before calling this API. Trial credits cannot be used for social-data requests. This beta has no SLA and platform coverage may change.

You must comply with each platform's terms and applicable data rules. Do not use this API to build personal profiles. Login, contact extraction, engagement manipulation, and private or paid-content access are outside this beta.

Calls use your existing ChinaAPI key and balance. Only a successful HTTP 200 response with data is charged. Empty or failed results are not charged. A daily beta budget may return HTTP 429; retry after the UTC day resets. Repeating a successful request creates another billable call.

Responses, billing and errors

A successful response has this envelope. data contains the platform's original response structure; pagination fields are platform-specific.

{
  "object": "social.result",
  "platform": "PLATFORM",
  "capability": "CAPABILITY",
  "data": {
    "platform_specific_fields": "..."
  }
}

HTTP 200 with non-empty data: one per-call charge at the catalog price.
HTTP 403 with model_requires_topup: complete your first top-up.
HTTP 429: stop immediate retries. Daily beta budgets reset at UTC midnight; transient rate limits may also apply.
Invalid parameters, empty data or other failures: no successful-call charge. Check the returned error before retrying.

Use cursor, page and identifier fields exactly as listed below. Each successful page request is a separate billable call. Keep your key on the server; do not put it in browser code or public repositories.

Platform and capability reference

Expand an endpoint for all parameters and a curl example. Resource identifiers in examples must refer to the content you intend to retrieve.

Douyin · Search posts — $0.02 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/douyin/post

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

curl request

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 — $0.006 / successful call

GET /v1/social/douyin/user

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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/douyin/trending

No query parameters.

curl request

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

Xiaohongshu (RED) · Search posts — $0.02 / successful call

GET /v1/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

curl request

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 — $0.02 / successful call

GET /v1/social/xiaohongshu/post

Provide 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

curl request

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 — $0.02 / successful call

GET /v1/social/xiaohongshu/user

Provide 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

curl request

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 — $0.02 / successful call

GET /v1/social/xiaohongshu/comments

Provide 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

curl request

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 — $0.02 / successful call

GET /v1/social/xiaohongshu/user-posts

Provide 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

curl request

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 — $0.02 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/kuaishou/post

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

curl request

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 — $0.02 / successful call

GET /v1/social/kuaishou/user

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

curl request

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 — $0.002 / successful call

GET /v1/social/kuaishou/comments

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

curl request

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 — $0.02 / successful call

GET /v1/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)

curl request

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 — $0.002 / successful call

GET /v1/social/kuaishou/trending

No query parameters.

curl request

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

Bilibili · Search posts — $0.002 / successful call

GET /v1/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)

curl request

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 — $0.002 / successful call

GET /v1/social/bilibili/post

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

curl request

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 — $0.002 / successful call

GET /v1/social/bilibili/user

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

curl request

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 — $0.002 / successful call

GET /v1/social/bilibili/comments

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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/bilibili/trending

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

curl request

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

Weibo · Search posts — $0.002 / successful call

GET /v1/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.

curl request

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 — $0.002 / successful call

GET /v1/social/weibo/post

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

curl request

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 — $0.002 / successful call

GET /v1/social/weibo/user

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

curl request

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 — $0.002 / successful call

GET /v1/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.

curl request

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 — $0.002 / successful call

GET /v1/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).

curl request

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 — $0.003 / successful call

GET /v1/social/weibo/trending

No query parameters.

curl request

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

Zhihu · Search posts — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/zhihu/post

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

curl request

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 — $0.002 / successful call

GET /v1/social/zhihu/user

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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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

WeChat Channels · Search posts — $0.02 / successful call

GET /v1/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+); stri
`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

curl request

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 — $0.02 / successful call

GET /v1/social/wechat-channels/post

Provide 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)

curl request

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 — $0.02 / successful call

GET /v1/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

curl request

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 — $0.02 / successful call

GET /v1/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

curl request

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 — $0.02 / successful call

GET /v1/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)

curl request

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 — $0.02 / successful call

GET /v1/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

curl request

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 — $0.02 / successful call

GET /v1/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

curl request

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 — $0.02 / successful call

GET /v1/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` (mini-program-lin
`raw`	boolean	No	—	true	True=raw response; False=simplified parsed structure

curl request

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 — $0.02 / successful call

GET /v1/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

curl request

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 — $0.02 / successful call

GET /v1/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` (mini-program-lin
`page_size`	integer	No	—	20	next_offset/Articles per page (default 20). NOTE: WeChat currently ignores this parameter — the count is decided by the accou
`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

curl request

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 — $0.02 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/toutiao/post

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

curl request

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 — $0.002 / successful call

GET /v1/social/toutiao/user

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

curl request

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 — $0.002 / successful call

GET /v1/social/toutiao/comments

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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/xigua/post

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

curl request

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 — $0.002 / successful call

GET /v1/social/xigua/user

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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/pipixia/post

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

curl request

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 — $0.002 / successful call

GET /v1/social/pipixia/user

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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/pipixia/trending

No query parameters.

curl request

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

TikTok · Search posts — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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.

curl request

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 — $0.002 / successful call

GET /v1/social/tiktok/user

Provide at least one of: uniqueId, secUid.

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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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)

curl request

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 — $0.002 / successful call

GET /v1/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.

curl request

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

Instagram · Search posts — $0.004 / successful call

GET /v1/social/instagram/search

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

curl request

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 — $0.002 / successful call

GET /v1/social/instagram/post

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

curl request

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 — $0.002 / successful call

GET /v1/social/instagram/user

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

curl request

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 — $0.004 / successful call

GET /v1/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

curl request

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 — $0.004 / successful call

GET /v1/social/instagram/user-posts

Provide 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

curl request

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 — $0.016 / successful call

GET /v1/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

curl request

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

YouTube · Search posts — $0.004 / successful call

GET /v1/social/youtube/search

Provide 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

curl request

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 — $0.002 / successful call

GET /v1/social/youtube/post

Provide 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

curl request

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 — $0.002 / successful call

GET /v1/social/youtube/user

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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/twitter/post

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

curl request

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 — $0.002 / successful call

GET /v1/social/twitter/user

Provide 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)

curl request

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 — $0.002 / successful call

GET /v1/social/twitter/comments

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

curl request

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 — $0.002 / successful call

GET /v1/social/twitter/user-posts

Provide 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

curl request

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 — $0.002 / successful call

GET /v1/social/twitter/trending

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

curl request

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

Reddit · Search posts — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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

LinkedIn · Post details — $0.002 / successful call

GET /v1/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

curl request

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 — $0.016 / successful call

GET /v1/social/linkedin/user

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

curl request

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 — $0.1 / successful call

GET /v1/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)

curl request

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 — $0.1 / successful call

GET /v1/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

curl request

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 — $0.004 / successful call

GET /v1/social/threads/search

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

curl request

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 — $0.004 / successful call

GET /v1/social/threads/post

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

curl request

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 — $0.004 / successful call

GET /v1/social/threads/user

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

curl request

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 — $0.004 / successful call

GET /v1/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)

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/lemon8/post

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

curl request

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 — $0.002 / successful call

GET /v1/social/lemon8/user

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

curl request

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 — $0.002 / successful call

GET /v1/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

curl request

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 — $0.002 / successful call

GET /v1/social/lemon8/trending

No query parameters.

curl request

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