API reference · beta

Social data API reference

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

Coverage and beta terms Create account and check balance

Authentication and eligibility

Base URL: https://api.chinaapi.ai. Send Authorization: Bearer $CHINAAPI_API_KEY. Unpaid accounts have 50 calls per UTC day; paid accounts have no daily call limit. This API shares your model key and balance.

Public social catalog (no authentication). Snapshot: 2026-11-11T17:49:11Z. Recheck the live catalog before integration because beta coverage and rates may change.

Beta: daily call limits. Unpaid accounts can make up to 50 calls per UTC day across all API keys; paid accounts have no daily call limit. Daily allowances reset at 00:00 UTC. 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. Synchronous calls charge only for HTTP 200 with data. Async POST creation reserves the price; failed or empty tasks are refunded, and GET task reads are free. Empty or failed results are not charged. Unpaid accounts that exhaust the 50-call daily allowance receive HTTP 429 until 00:00 UTC or until they top up. Paid accounts have no daily call limit; per-second rate limits and upstream capacity still apply. Repeating a successful synchronous request creates another billable call. Retry async creation with the same Idempotency-Key to avoid duplicate submissions.

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": "..."
  }
}

Synchronous HTTP 200 with non-empty data: one per-call charge at the catalog price.
HTTP 403: check API key permissions.
HTTP 429 data_api_daily_limit_exceeded: the unpaid account has used its 50 daily calls; wait until 00:00 UTC or top up to remove the daily call limit. Other 429 responses may indicate transient capacity limits; stop immediate retries.
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.

LinkedIn asynchronous tasks

POST creation uses query parameters, an empty body and an Idempotency-Key of 8–128 characters. HTTP 202 returns a task ID and a Location. Retry a lost submission with the same key and parameters; changing parameters returns 409. Creation reserves the catalog price; failed or empty tasks refund it.

Read GET /v1/social-tasks/TASK_ID with a key from the same account. Status and result reads are free. Poll no faster than every five seconds; results remain available for 30 days. A submission_pending response needs the same key, never a new paid submission. Async capabilities are REST-only; the data MCP tool lists synchronous endpoints.

Telegram public channels

Telegram profiles refer to public channels, not personal accounts or private chats. Use user for channel metadata, post for one post and user-posts for channel history. Comments remain unavailable.

Read posts from data.messages. Pass data.pagination.before_cursor as before for older posts or after_cursor as after for newer posts. Choose one direction, deduplicate post IDs and stop on an empty page, repeated cursor, no new IDs or your page/spending limit. has_more_before=false ends backward collection. Each successful nonempty page is billed separately; missing content and unavailable previews are not charged.

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

Check live Douyin · Search posts price and parameters in Dash

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

Check live Douyin · Post details price and parameters in Dash

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

Check live Douyin · Profiles price and parameters in Dash

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

Check live Douyin · Comments price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`aweme_id`	string	Yes	—	"7448118827402972455"	Video id
`cursor`	integer	No	0	0	Cursor Constraints: {"minimum": 0}
`count`	integer	No	20	20	Number Constraints: {"enum": [20]}

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=7448118827402972455'

Douyin · Comment replies — $0.002 / successful call

GET /v1/social/douyin/comment-replies

Check live Douyin · Comment replies price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`item_id`	string	Yes	—	"7354666303006723354"	Video id
`comment_id`	string	Yes	—	"7354669356632638218"	Comment id
`cursor`	integer	No	0	0	Cursor Constraints: {"minimum": 0}
`count`	integer	No	20	20	Number Constraints: {"enum": [20]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/douyin/comment-replies" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'item_id=7354666303006723354' \
  --data-urlencode 'comment_id=7354669356632638218'

Douyin · User posts — $0.002 / successful call

GET /v1/social/douyin/user-posts

Check live Douyin · User posts price and parameters in Dash

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

Check live Douyin · Trending price and parameters in Dash

No query parameters.

curl request

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

Douyin · Product reviews — $0.001 / successful call

GET /v1/social/douyin/product-reviews

Check live Douyin · Product reviews price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`goods_id`	string	Yes	—	"3827812353530004447"	Douyin shop product ID (product_id) Constraints: {"pattern": "^[1-9][0-9]{14,19}$"}
`cursor`	integer	No	—	0	Page number, from 0; the cursor from the previous page's response Constraints: {"minimum": 0, "maximum": 500}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/douyin/product-reviews" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'goods_id=3827812353530004447'

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

GET /v1/social/xiaohongshu/search

Check live Xiaohongshu (RED) · Search posts price and parameters in Dash

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

Check live Xiaohongshu (RED) · Post details price and parameters in Dash

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

Check live Xiaohongshu (RED) · Profiles price and parameters in Dash

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

Check live Xiaohongshu (RED) · Comments price and parameters in Dash

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

Check live Xiaohongshu (RED) · User posts price and parameters in Dash

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'

Xiaohongshu (RED) · Creator hot topics — $0.02 / successful call

GET /v1/social/xiaohongshu/creator-hot-topics

Check live Xiaohongshu (RED) · Creator hot topics price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`cursor`	string	No	""	""	Pagination cursor, leave empty for first request Constraints: {"maxLength": 256}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/xiaohongshu/creator-hot-topics" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY"

Kuaishou · Search posts — $0.02 / successful call

GET /v1/social/kuaishou/search

Check live Kuaishou · Search posts price and parameters in Dash

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

Check live Kuaishou · Post details price and parameters in Dash

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

Check live Kuaishou · Profiles price and parameters in Dash

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

Check live Kuaishou · Comments price and parameters in Dash

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

Check live Kuaishou · User posts price and parameters in Dash

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) Constraints: {"enum": ["latest", "hot"]}

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

Check live Kuaishou · Trending price and parameters in Dash

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

Check live Bilibili · Search posts price and parameters in Dash

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

Check live Bilibili · Post details price and parameters in Dash

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

Check live Bilibili · Profiles price and parameters in Dash

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

Check live Bilibili · Comments price and parameters in Dash

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

Check live Bilibili · User posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`uid`	string	Yes	—	"178360345"	User UID
`pn`	integer	No	—	1	Page number, max 100 Constraints: {"minimum": 1, "maximum": 100}
`ps`	integer	No	—	25	Page size, max 50 Constraints: {"minimum": 1, "maximum": 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

Check live Bilibili · Trending price and parameters in Dash

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

Check live Weibo · Search posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`query`	string	Yes	—	"NVIDIA"	Search keyword
`page`	integer	No	—	1	Page number Constraints: {"minimum": 1}
`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

Check live Weibo · Post details price and parameters in Dash

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

Check live Weibo · Profiles price and parameters in Dash

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

Check live Weibo · Comments price and parameters in Dash

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

Check live Weibo · User posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`uid`	string	Yes	—	"7648703289"	User ID
`page`	integer	No	—	1	Page number Constraints: {"minimum": 1}
`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

Check live Weibo · Trending price and parameters in Dash

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

Check live Zhihu · Search posts price and parameters in Dash

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

Check live Zhihu · Post details price and parameters in Dash

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

Check live Zhihu · Profiles price and parameters in Dash

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

Check live Zhihu · Comments price and parameters in Dash

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

Check live Zhihu · Trending price and parameters in Dash

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

Check live WeChat Channels · Search posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`keyword`	string	Yes	—	"美食"	Search keyword (1-100 chars) Constraints: {"minLength": 1, "maxLength": 100}
`duration`	string	No	—	"short"	Duration tier (Channels video only): all/0 / short/1 (<5min) / medium/2 (5-10min) / long/3 (20min+); stri
`sort`	string	No	—	"hot"	Sort: default/0 (relevance) / latest/1 (newest) / hot/2 (most liked); string key or integer
`publish_time`	string	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) Constraints: {"minimum": 0}
`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

Check live WeChat Channels · Post details price and parameters in Dash

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) Constraints: {"maxLength": 32, "pattern": "^[0-9]*$"}
`export_id`	string	No	—	""	exportId from search results (starts with export/, expires soon) Constraints: {"maxLength": 2048, "pattern": "^(export/.+)?$"}
`object_nonce_id`	string	No	—	""	Optional objectNonceId (numeric, improves hit rate) Constraints: {"maxLength": 32, "pattern": "^[0-9]*$"}
`share_url`	string	No	—	""	Share URL (https://weixin.qq.com/sph/…), used only when object_id and export_id are empty Constraints: {"maxLength": 256, "pattern": "^(https?://weixin\\.qq\\.com/sph/[A-Za-z0-9]+/?)?$"}
`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

Check live WeChat Channels · Profiles price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`username`	string	Yes	—	"v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder"	WeChat Channels finder username (v2_…@finder format) Constraints: {"minLength": 10, "maxLength": 256, "pattern": "^v2_[0-9a-fA-F]+@finder$"}
`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

Check live WeChat Channels · Comments price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`object_id`	string	Yes	—	"14941130915890399732"	Video objectId (numeric) Constraints: {"maxLength": 32, "pattern": "^[0-9]+$"}
`last_buffer`	string	No	—	""	Pagination cursor (base64), leave empty for first page Constraints: {"pattern": "^[A-Za-z0-9+/=_-]*$"}
`comment_id`	string	No	—	""	Pass a commentId (numeric) to expand its replies, leave empty for first-level comments Constraints: {"maxLength": 32, "pattern": "^[0-9]*$"}
`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

Check live WeChat Channels · User posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`username`	string	Yes	—	"v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder"	WeChat Channels finder username (v2_…@finder format) Constraints: {"minLength": 10, "maxLength": 256, "pattern": "^v2_[0-9a-fA-F]+@finder$"}
`last_buffer`	string	No	—	""	Pagination cursor (base64), leave empty for first page Constraints: {"pattern": "^[A-Za-z0-9+/=_-]*$"}
`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

Check live WeChat Official Accounts · Search posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`keyword`	string	Yes	—	"人民日报"	Search keyword (1-100 chars) Constraints: {"minLength": 1, "maxLength": 100}
`sort`	string	No	—	"hot"	Sort (result page 'sort' dropdown, common to all verticals): default/0 (relevance) / latest/1 (newest) / hot/2
`publish_time`	string	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) Constraints: {"minimum": 0}
`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

Check live WeChat Official Accounts · Post details price and parameters in Dash

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) Constraints: {"maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$"}
`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

Check live WeChat Official Accounts · Profiles price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`username`	string	Yes	—	"gh_363b924965e9"	Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-lin Constraints: {"maxLength": 80, "pattern": "^[0-9A-Za-z][-_0-9A-Za-z]{1,63}(@[0-9A-Za-z]{1,16})?$"}
`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

Check live WeChat Official Accounts · Comments price and parameters in Dash

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/…) Constraints: {"maxLength": 2048, "pattern": "^https?://mp\\.weixin\\.qq\\.com/s([/?].+)?$"}
`buffer`	string	No	—	""	Pagination cursor, leave empty for first page; pass buffer from the previous response Constraints: {"maxLength": 8192}
`comment_id`	string	No	—	—	Optional article comment ID. Reuse data.content.comment_id from an article-details response when available to reduce retrieval work. Constraints: {"maxLength": 32, "pattern": "^[0-9]*$"}
`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

Check live WeChat Official Accounts · User posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`username`	string	Yes	—	"gh_363b924965e9"	Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-lin Constraints: {"maxLength": 80, "pattern": "^[0-9A-Za-z][-_0-9A-Za-z]{1,63}(@[0-9A-Za-z]{1,16})?$"}
`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 Constraints: {"minimum": 1, "maximum": 100}
`offset`	string	No	—	""	Pagination cursor (base64), leave empty for first page; for the next page pass next_offset from the previous response Constraints: {"maxLength": 8192, "pattern": "^[A-Za-z0-9+/=_-]*$"}
`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

Check live WeChat Search · Search posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`keyword`	string	Yes	—	"人民日报"	Search keyword (1-100 chars) Constraints: {"minLength": 1, "maxLength": 100}
`business_type`	string	No	—	"account"	Search category. Tested categories with results: all, account, article, video, sticker. Other categories may return no data. Constraints: {"enum": ["all", "account", "article", "video", "sticker", "underline", "encyclopedia", "live_stream", "comment", "listen", "news", "photos", "book", "moments", "image", "mini_game", "weixin_index", "ai_search"]}
`sort`	string	No	—	"hot"	Sort (result page 'sort' dropdown, common to all verticals): default/0 (relevance) / latest/1 (newest) / hot/2
`publish_time`	string	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) Constraints: {"minimum": 0}
`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

Check live Toutiao · Post details price and parameters in Dash

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

Check live Toutiao · Profiles price and parameters in Dash

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

Check live Toutiao · Comments price and parameters in Dash

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

Check live Xigua Video · Search posts price and parameters in Dash

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

Check live Xigua Video · Post details price and parameters in Dash

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

Check live Xigua Video · Profiles price and parameters in Dash

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

Check live Xigua Video · Comments price and parameters in Dash

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

Check live Xigua Video · User posts price and parameters in Dash

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

Check live Pipixia · Search posts price and parameters in Dash

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

Check live Pipixia · Post details price and parameters in Dash

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

Check live Pipixia · Profiles price and parameters in Dash

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

Check live Pipixia · Comments price and parameters in Dash

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

Check live Pipixia · User posts price and parameters in Dash

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

Check live Pipixia · Trending price and parameters in Dash

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

Check live TikTok · Search posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`keyword`	string	Yes	—	"中华娘"	Keyword
`offset`	integer	No	0	0	Offset Constraints: {"minimum": 0}
`count`	integer	No	20	20	Number Constraints: {"minimum": 1, "maximum": 20}
`sort_type`	integer	No	0	0	Sort type Constraints: {"enum": [0, 1]}
`publish_time`	integer	No	0	0	Publish time Constraints: {"enum": [0, 1, 7, 30, 90, 180]}

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

GET /v1/social/tiktok/post

Check live TikTok · Post details price and parameters in Dash

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

Check live TikTok · Profiles price and parameters in Dash

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

Check live TikTok · Comments price and parameters in Dash

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

Check live TikTok · User posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`secUid`	string	Yes	—	"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"	User secUid
`cursor`	integer	No	—	0	Page cursor Constraints: {"minimum": 0}
`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

Check live TikTok · Trending price and parameters in Dash

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

Check live Instagram · Search posts price and parameters in Dash

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

Check live Instagram · Post details price and parameters in Dash

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

Check live Instagram · Profiles price and parameters in Dash

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

Check live Instagram · Comments price and parameters in Dash

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

Check live Instagram · User posts price and parameters in Dash

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

Check live Instagram · Trending price and parameters in Dash

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

Check live YouTube · Search posts price and parameters in Dash

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) Constraints: {"maxLength": 200}
`continuation_token`	string	No	—	—	Continuation token for next page
`upload_date`	string	No	—	—	Upload date filter Constraints: {"enum": ["last_hour", "today", "this_week", "this_month", "this_year"]}
`type`	string	No	—	—	Type filter Constraints: {"enum": ["video", "channel", "playlist", "movie"]}
`duration`	string	No	—	—	Duration filter: short (<4min), medium (4-20min), long (>20min) Constraints: {"enum": ["short", "medium", "long"]}
`features`	string	No	—	—	Feature filter (comma separated): live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr
`sort_by`	string	No	—	—	Sort by Constraints: {"enum": ["relevance", "upload_date", "view_count", "rating"]}

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

Check live YouTube · Post details price and parameters in Dash

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

Check live YouTube · Profiles price and parameters in Dash

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

Check live YouTube · Comments price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`video_id`	string	Yes	—	"LuIL5JATZsc"	Video ID Constraints: {"minLength": 11, "maxLength": 11}
`language_code`	string	No	—	"zh-CN"	Language code
`country_code`	string	No	—	"US"	Country code
`sort_by`	string	No	—	"top"	Sort by Constraints: {"enum": ["top", "newest"]}
`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

Check live YouTube · User posts price and parameters in Dash

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

Check live X (Twitter) · Search posts price and parameters in Dash

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

Check live X (Twitter) · Post details price and parameters in Dash

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

Check live X (Twitter) · Profiles price and parameters in Dash

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

Check live X (Twitter) · Comments price and parameters in Dash

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

Check live X (Twitter) · User posts price and parameters in Dash

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

Check live X (Twitter) · Trending price and parameters in Dash

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

Check live Reddit · Search posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`language`	string	No	—	"en-US"	Preferred response language as an IETF language tag; default: en-US Constraints: {"minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"}
`query`	string	Yes	—	"rust borrow checker"	Search keywords or expression; post searches may match only some keywords. Supports AND, OR, NOT, grouping, quoted phrases and field filters Constraints: {"minLength": 1, "maxLength": 512}
`search_type`	string	No	—	"post"	Search type: post, community, comment, media, people. Constraints: {"enum": ["post", "community", "comment", "media", "people"]}
`sort`	string	No	—	"RELEVANCE"	Sort method (post/comment/media only): RELEVANCE, HOT, TOP, NEW, COMMENTS (post only). Constraints: {"enum": ["RELEVANCE", "HOT", "TOP", "NEW", "COMMENTS"]}
`time_range`	string	No	—	"all"	Time range (post/media only): all, year, month, week, day, hour. Constraints: {"enum": ["all", "year", "month", "week", "day", "hour"]}
`safe_search`	string	No	—	"unset"	Safe search setting: unset, strict Constraints: {"enum": ["unset", "strict"]}
`allow_nsfw`	string	No	—	"0"	Allow NSFW content: 0, 1 Constraints: {"enum": ["0", "1"]}
`after`	string	No	—	""	Pagination cursor; use pageInfo.endCursor when need_format=true Constraints: {"maxLength": 4096}
`need_format`	boolean	No	—	false	When true, data contains only children and pageInfo with redundant result fields removed; false preserves the original search structure

curl request

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

Reddit · Post details — $0.002 / successful call

GET /v1/social/reddit/post

Check live Reddit · Post details price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`language`	string	No	—	"en-US"	Preferred response language as an IETF language tag; default: en-US Constraints: {"minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"}
`post_id`	string	Yes	—	"t3_1ojnh50"	Post ID Constraints: {"minLength": 4, "maxLength": 20, "pattern": "^t3_[a-z0-9]{1,17}$"}
`include_comment_id`	boolean	No	—	false	Include specific comment ID
`comment_id`	string	No	—	""	Comment ID (when include_comment_id is True) Constraints: {"maxLength": 20, "pattern": "^(?:\|t1_[a-z0-9]{1,17})$"}
`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

Check live Reddit · Profiles price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`language`	string	No	—	"en-US"	Preferred response language as an IETF language tag; default: en-US Constraints: {"minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"}
`username`	string	Yes	—	"spez"	Username Constraints: {"minLength": 1, "maxLength": 20, "pattern": "^[A-Za-z0-9_-]+$"}
`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

Check live Reddit · Comments price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`language`	string	No	—	"en-US"	Preferred response language as an IETF language tag; default: en-US Constraints: {"minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"}
`post_id`	string	Yes	—	"t3_1ojnvca"	Post ID Constraints: {"minLength": 4, "maxLength": 20, "pattern": "^t3_[a-z0-9]{1,17}$"}
`sort_type`	string	No	—	"CONFIDENCE"	Sort method: CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM Constraints: {"enum": ["CONFIDENCE", "NEW", "TOP", "HOT", "CONTROVERSIAL", "OLD", "RANDOM"]}
`after`	string	No	—	""	Pagination parameter for fetching next page Constraints: {"maxLength": 4096}
`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

Check live Reddit · User posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`language`	string	No	—	"en-US"	Preferred response language as an IETF language tag; default: en-US Constraints: {"minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"}
`username`	string	Yes	—	"spez"	Username Constraints: {"minLength": 1, "maxLength": 20, "pattern": "^[A-Za-z0-9_-]+$"}
`sort`	string	No	—	"NEW"	Sort method: NEW, TOP, HOT, CONTROVERSIAL Constraints: {"enum": ["NEW", "TOP", "HOT", "CONTROVERSIAL"]}
`after`	string	No	—	""	Pagination parameter Constraints: {"maxLength": 4096}
`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

Check live Reddit · Trending price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`language`	string	No	—	"en-US"	Preferred response language as an IETF language tag; default: en-US Constraints: {"minLength": 2, "maxLength": 16, "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"}
`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.016 / successful call

GET /v1/social/linkedin/post

Check live LinkedIn · Post details price and parameters in Dash

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

Check live LinkedIn · Profiles price and parameters in Dash

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

Check live LinkedIn · Comments price and parameters in Dash

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 Constraints: {"minimum": 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

Check live LinkedIn · User posts price and parameters in Dash

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	—	—	Not supported, has no effect Constraints: {"minimum": 0}
`pagination_token`	string	No	—	—	Not supported, has no effect

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/'

LinkedIn · Async post details — $0.016 / successful call

POST /v1/social/linkedin/post-async

Check live LinkedIn · Async post details price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`url`	string	Yes	—	"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"	Post or article URL Constraints: {"maxLength": 2048, "pattern": "^https://(www\\.)?linkedin\\.com/(posts\|pulse)/[^\\s]+$"}

curl request

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

LinkedIn · Async profiles — $0.016 / successful call

POST /v1/social/linkedin/user-async

Check live LinkedIn · Async profiles price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`url`	string	Yes	—	"https://www.linkedin.com/in/williamhgates/"	Full profile URL Constraints: {"maxLength": 2048, "pattern": "^https://(www\\.)?linkedin\\.com/in/[^\\s]+$"}

curl request

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

LinkedIn · Async company profiles — $0.016 / successful call

POST /v1/social/linkedin/company-async

Check live LinkedIn · Async company profiles price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`url`	string	Yes	—	"https://www.linkedin.com/company/microsoft/"	Full company URL Constraints: {"maxLength": 2048, "pattern": "^https://(www\\.)?linkedin\\.com/company/[^\\s]+$"}

curl request

curl --fail-with-body --get -X POST "https://api.chinaapi.ai/v1/social/linkedin/company-async" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_OPERATION_KEY" \
  --data-urlencode 'url=https://www.linkedin.com/company/microsoft/'

Threads · Search posts — $0.004 / successful call

GET /v1/social/threads/search

Check live Threads · Search posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`query`	string	Yes	—	"bitcoin"	Search query
`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/search" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'query=bitcoin'

Threads · Post details — $0.004 / successful call

GET /v1/social/threads/post

Check live Threads · Post details price and parameters in Dash

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

Check live Threads · Profiles price and parameters in Dash

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

GET /v1/social/threads/comments

Check live Threads · Comments price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`post_id`	string	Yes	—	"3390920896561588969"	Post 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/comments" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'post_id=3390920896561588969'

Threads · User posts — $0.004 / successful call

GET /v1/social/threads/user-posts

Check live Threads · User posts price and parameters in Dash

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

Check live Lemon8 · Search posts price and parameters in Dash

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

Check live Lemon8 · Post details price and parameters in Dash

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

Check live Lemon8 · Profiles price and parameters in Dash

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

Check live Lemon8 · Comments price and parameters in Dash

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

Check live Lemon8 · Trending price and parameters in Dash

No query parameters.

curl request

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

Telegram · Post details — $0.002 / successful call

GET /v1/social/telegram/post

Check live Telegram · Post details price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`channel`	string	Yes	—	"durov"	Channel username
`post_id`	integer	Yes	—	510	Post ID

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/telegram/post" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'channel=durov' \
  --data-urlencode 'post_id=510'

Telegram · Profiles — $0.002 / successful call

GET /v1/social/telegram/user

Check live Telegram · Profiles price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`channel`	string	Yes	—	"durov"	Channel username

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/telegram/user" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'channel=durov'

Telegram · User posts — $0.002 / successful call

GET /v1/social/telegram/user-posts

Check live Telegram · User posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`channel`	string	Yes	—	"durov"	Channel username
`limit`	integer	No	—	20	Number of posts Constraints: {"minimum": 1, "maximum": 100}
`before`	integer	No	—	0	Older than this id
`after`	integer	No	—	0	Newer than this id

curl request

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

Cross-platform · Search posts — $0.01 / successful call

GET /v1/social/cross-platform/search

Check live Cross-platform · Search posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`query`	string	Yes	—	"人工智能"	Search terms; separate terms with spaces to require all of them. Put excluded words in exclude_words. Constraints: {"minLength": 1, "maxLength": 200, "pattern": "\\S"}
`platforms`	array	No	—	["weibo", "douyin", "toutiao", "xiaohongshu", "short_video", "wechat", "news", "forum", "long_video", "app"]	Only these platforms, all by default: weibo, douyin, toutiao, xiaohongshu, short_video (Kuaishou and other short-video apps), wechat (official accounts), news (news sites and newspapers), forum (forum Pass a JSON array in this query parameter. Constraints: {"items": {"enum": ["weibo", "douyin", "toutiao", "xiaohongshu", "short_video", "wechat", "news", "forum", "long_video", "app"]}, "minItems": 1, "maxItems": 10, "uniqueItems": true}
`since`	string	No	—	—	First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until Constraints: {"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"}
`until`	string	No	—	—	Last day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days Constraints: {"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"}
`types`	array	No	—	["original", "repost", "comment"]	Content types, all by default: original, repost, comment Pass a JSON array in this query parameter. Constraints: {"items": {"enum": ["original", "repost", "comment"]}, "minItems": 1, "maxItems": 3, "uniqueItems": true}
`sentiment`	array	No	—	["negative", "neutral", "positive"]	Sentiment, all by default: negative, neutral, positive Pass a JSON array in this query parameter. Constraints: {"items": {"enum": ["negative", "neutral", "positive"]}, "minItems": 1, "maxItems": 3, "uniqueItems": true}
`match`	array	No	—	["title", "content", "author"]	Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio Pass a JSON array in this query parameter. Constraints: {"items": {"enum": ["title", "content", "author", "media_text", "audio"]}, "minItems": 1, "maxItems": 5, "uniqueItems": true}
`exclude_words`	string	No	—	—	Filter words; results that contain them are left out Constraints: {"maxLength": 100}
`author`	string	No	—	—	Only content published by this author (account name) Constraints: {"maxLength": 50}
`page`	integer	No	—	1	Page number, from 1, at most 50 Constraints: {"minimum": 1, "maximum": 50}
`limit`	integer	No	—	20	Results per page: 10 or 20 Constraints: {"enum": [10, 20]}

curl request

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

JD.com · Product reviews — $0.039 / successful call

GET /v1/social/jd/product-reviews

Check live JD.com · Product reviews price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`sku_id`	string	Yes	—	"100006271091"	JD.com SKU ID (the number in item.jd.com/<SKU>.html) Constraints: {"pattern": "^[1-9][0-9]{3,19}$"}
`page`	integer	No	—	1	Page number, from 1, up to the max_page of the previous answer; stop when has_more is false Constraints: {"minimum": 1, "maximum": 100}
`only_this_sku`	boolean	No	—	true	true (default) returns this SKU's reviews only; false returns the reviews of every variant (colour, size, ...) of the product

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/jd/product-reviews" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'sku_id=100006271091'

Fliggy · Comments — $0.003 / successful call

GET /v1/social/fliggy/comments

Check live Fliggy · Comments price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`hotel_id`	string	Yes	—	"10052156"	Fliggy hotel ID (shid, 5–15 digits), e.g. 10052156 Constraints: {"pattern": "^[1-9][0-9]{4,14}$"}
`cursor`	integer	No	—	1	Page number, from 1 Constraints: {"minimum": 1, "maximum": 200}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/fliggy/comments" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'hotel_id=10052156'

Fliggy · Hotel rating — $0.003 / successful call

GET /v1/social/fliggy/hotel

Check live Fliggy · Hotel rating price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`hotel_id`	string	Yes	—	"10052156"	Fliggy hotel ID (shid, 5–15 digits), e.g. 10052156 Constraints: {"pattern": "^[1-9][0-9]{4,14}$"}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/fliggy/hotel" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'hotel_id=10052156'

Kuaishou Cili Juxing · Profiles — $0.003 / successful call

GET /v1/social/cljx/user

Check live Kuaishou Cili Juxing · Profiles price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`star_id`	string	Yes	—	"4857086"	Cili Juxing creator ID (starId) Constraints: {"pattern": "^[0-9]{1,20}$"}
`star_type`	integer	No	—	1	1 short-video creators, 4 live-stream creators Constraints: {"enum": [1, 4]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/user" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'star_id=4857086'

Kuaishou Cili Juxing · Trending — $0.003 / successful call

GET /v1/social/cljx/trending

Check live Kuaishou Cili Juxing · Trending price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`board`	integer	No	—	105	Chart: 105 reach, 104 rising stars, 5 value for money, 106 top picks (short-video creators); 7 sales power, 8 popular hosts (live-stream creators, needs star_type=4) Constraints: {"enum": [105, 104, 5, 106, 7, 8]}
`star_type`	integer	No	—	1	1 short-video creators, 4 live-stream creators (charts 7 and 8) Constraints: {"enum": [1, 4]}
`tag_id`	integer	No	—	—	Top-level content category ID, such as 670 beauty; leave out for all Constraints: {"minimum": 1, "maximum": 9999}

curl request

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

Kuaishou Cili Juxing · Creator basics — $0.003 / successful call

GET /v1/social/cljx/creator-base

Check live Kuaishou Cili Juxing · Creator basics price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`star_id`	string	Yes	—	"8646245"	Cili Juxing creator ID (starId) Constraints: {"pattern": "^[0-9]{1,20}$"}
`star_type`	integer	No	—	1	1 short-video creators, 4 live-stream creators Constraints: {"enum": [1, 4]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/creator-base" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'star_id=8646245'

Kuaishou Cili Juxing · Creator indices — $0.003 / successful call

GET /v1/social/cljx/creator-indices

Check live Kuaishou Cili Juxing · Creator indices price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`user_id`	string	Yes	—	"5188613547"	Kuaishou user ID (userId; the user_id in star_search results) Constraints: {"pattern": "^[0-9]{1,20}$"}
`star_type`	integer	No	—	1	1 short-video creators, 4 live-stream creators Constraints: {"enum": [1, 4]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/creator-indices" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'user_id=5188613547'

Kuaishou Cili Juxing · Creator audience — $0.003 / successful call

GET /v1/social/cljx/creator-audience

Check live Kuaishou Cili Juxing · Creator audience price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`star_id`	string	Yes	—	"8646245"	Cili Juxing creator ID (starId) Constraints: {"pattern": "^[0-9]{1,20}$"}
`star_type`	integer	No	—	1	1 short-video creators, 4 live-stream creators Constraints: {"enum": [1, 4]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/creator-audience" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'star_id=8646245'

Kuaishou Cili Juxing · Creator content performance — $0.003 / successful call

GET /v1/social/cljx/creator-performance

Check live Kuaishou Cili Juxing · Creator content performance price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`star_id`	string	Yes	—	"8646245"	Cili Juxing creator ID (starId) Constraints: {"pattern": "^[0-9]{1,20}$"}
`star_type`	integer	No	—	1	1 short-video creators, 4 live-stream creators Constraints: {"enum": [1, 4]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/creator-performance" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'star_id=8646245'

Kuaishou Cili Juxing · Creator commerce — $0.003 / successful call

GET /v1/social/cljx/creator-commerce

Check live Kuaishou Cili Juxing · Creator commerce price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`star_id`	string	Yes	—	"34907"	Cili Juxing creator ID (starId) Constraints: {"pattern": "^[0-9]{1,20}$"}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/creator-commerce" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'star_id=34907'

Kuaishou Cili Juxing · Creator top posts — $0.003 / successful call

GET /v1/social/cljx/creator-top-posts

Check live Kuaishou Cili Juxing · Creator top posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`star_id`	string	Yes	—	"8646245"	Cili Juxing creator ID (starId) Constraints: {"pattern": "^[0-9]{1,20}$"}
`organic_only`	boolean	No	—	false	When true, count organic traffic only (paid promotion excluded)

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/creator-top-posts" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'star_id=8646245'

Kuaishou Cili Juxing · Creator content statistics — $0.003 / successful call

GET /v1/social/cljx/creator-stats

Check live Kuaishou Cili Juxing · Creator content statistics price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`star_id`	string	Yes	—	"8646245"	Cili Juxing creator ID (starId) Constraints: {"pattern": "^[0-9]{1,20}$"}
`organic_only`	boolean	No	—	false	When true, count organic traffic only (paid promotion excluded)
`window_days`	integer	No	—	30	Period in days Constraints: {"enum": [30, 90]}
`traffic_days`	integer	No	—	7	Traffic period in days Constraints: {"enum": [7, 15, 30]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/creator-stats" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'star_id=8646245'

Kuaishou Cili Juxing · Creator brand deals — $0.003 / successful call

GET /v1/social/cljx/creator-orders

Check live Kuaishou Cili Juxing · Creator brand deals price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`star_id`	string	Yes	—	"8646245"	Cili Juxing creator ID (starId) Constraints: {"pattern": "^[0-9]{1,20}$"}
`window_days`	integer	No	—	30	Period in days Constraints: {"enum": [30, 90]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/creator-orders" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'star_id=8646245'

Kuaishou Cili Juxing · Creator follower trend — $0.003 / successful call

GET /v1/social/cljx/creator-follower-trend

Check live Kuaishou Cili Juxing · Creator follower trend price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`star_id`	string	Yes	—	"8646245"	Cili Juxing creator ID (starId) Constraints: {"pattern": "^[0-9]{1,20}$"}
`window_days`	integer	No	—	30	Period in days Constraints: {"enum": [30, 90]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/cljx/creator-follower-trend" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'star_id=8646245'

Douyin · Keyword trends — $0.006 / successful call

GET /v1/social/douyin/keyword-trend

Check live Douyin · Keyword trends price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`keyword_list`	string	Yes	—	"美食"	Keyword list, comma separated
`start_date`	string	Yes	—	"20261026"	Start date, YYYYMMDD
`end_date`	string	Yes	—	"20261101"	End date, YYYYMMDD
`region`	string	No	""	""	Region list, comma separated

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/douyin/keyword-trend" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'keyword_list=美食' \
  --data-urlencode 'start_date=20261026' \
  --data-urlencode 'end_date=20261101'

Douyin · Keyword audience insights — $0.002 / successful call

GET /v1/social/douyin/keyword-audience

Check live Douyin · Keyword audience insights price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`keyword`	string	Yes	—	"美食"	Keyword
`start_date`	string	Yes	—	"20261026"	Start date YYYYMMDD
`end_date`	string	Yes	—	"20261101"	End date YYYYMMDD

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/douyin/keyword-audience" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'keyword=美食' \
  --data-urlencode 'start_date=20261026' \
  --data-urlencode 'end_date=20261101'

Douyin · Topic search — $0.002 / successful call

GET /v1/social/douyin/topic-search

Check live Douyin · Topic search price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`keyword`	string	Yes	—	"美食"	Topic keyword
`start_date`	string	Yes	—	"20261026"	Start date YYYYMMDD
`end_date`	string	Yes	—	"20261101"	End date YYYYMMDD

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/douyin/topic-search" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'keyword=美食' \
  --data-urlencode 'start_date=20261026' \
  --data-urlencode 'end_date=20261101'

Douyin · Hot keywords — $0.002 / successful call

GET /v1/social/douyin/hot-keywords

Check live Douyin · Hot keywords price and parameters in Dash

No query parameters.

curl request

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

Bilibili · Similar creators — $0.012 / successful call

GET /v1/social/bilibili/creator-similar

Check live Bilibili · Similar creators price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`upper_mid`	integer	Yes	—	546195	Bilibili creator UID

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/bilibili/creator-similar" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'upper_mid=546195'

Bilibili · Creator highlights — $0.012 / successful call

GET /v1/social/bilibili/creator-highlights

Check live Bilibili · Creator highlights price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`upper_mid`	integer	Yes	—	546195	Bilibili creator UID
`day_range`	integer	No	3	3	Statistics period

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/bilibili/creator-highlights" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'upper_mid=546195'

Bilibili · Creator schedule — $0.012 / successful call

GET /v1/social/bilibili/creator-schedule

Check live Bilibili · Creator schedule price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`mid`	integer	Yes	—	546195	Bilibili creator UID

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/bilibili/creator-schedule" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'mid=546195'

Bilibili · Creator basics — $0.012 / successful call

GET /v1/social/bilibili/creator-base

Check live Bilibili · Creator basics price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`upper_mid`	integer	Yes	—	546195	Bilibili creator UID

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/bilibili/creator-base" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'upper_mid=546195'

Bilibili · Creator content performance — $0.012 / successful call

GET /v1/social/bilibili/creator-performance

Check live Bilibili · Creator content performance price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`upper_mid`	integer	Yes	—	546195	Bilibili creator UID
`day_range`	integer	No	3	3	Statistics period

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/bilibili/creator-performance" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'upper_mid=546195'

Bilibili · Creator top posts — $0.012 / successful call

GET /v1/social/bilibili/creator-top-posts

Check live Bilibili · Creator top posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`upper_mid`	integer	Yes	—	546195	Bilibili creator UID
`type`	integer	No	2	2	Work type

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/bilibili/creator-top-posts" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'upper_mid=546195'

Bilibili · Creator follower trend — $0.012 / successful call

GET /v1/social/bilibili/creator-follower-trend

Check live Bilibili · Creator follower trend price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`upper_mid`	integer	Yes	—	546195	Bilibili creator UID
`query_type`	integer	No	1	1	Trend window

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/bilibili/creator-follower-trend" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'upper_mid=546195'

TikTok · Ad search — $0.002 / successful call

GET /v1/social/tiktok/ad-search

Check live TikTok · Ad search price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`objective`	integer	No	—	—	Ad objective (optional): 1 traffic, 2 app installs, 3 conversions, 4 video views, 5 reach, 6 leads, 7 product sales
`like`	integer	No	—	—	Performance percentile (optional): 1 top 1-20%, 2 top 21-40%, 3 top 41-60%, 4 top 61-80%, 5 top 81-100%
`period`	integer	No	180	180	Time period (days)
`industry`	string	No	—	—	Industry ID
`keyword`	string	No	—	"美食"	Search keyword
`page`	integer	No	1	1	Page number
`limit`	integer	No	20	20	Items per page
`order_by`	string	No	"for_you"	"for_you"	Sort by (for_you, likes)
`country_code`	string	No	"US"	"US"	Country code
`ad_format`	integer	No	—	—	Ad format (optional; 1:Spark Ads 2:Non-Spark Ads)
`ad_language`	string	No	—	—	Ad language (optional)
`duration`	integer	No	—	—	Video duration filter value (optional)
`pattern_label`	string	No	—	—	Creative pattern label (optional)
`search_id`	string	No	—	—	Search ID (optional)

curl request

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

TikTok · Ad details — $0.002 / successful call

GET /v1/social/tiktok/ad-detail

Check live TikTok · Ad details price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`ads_id`	string	Yes	—	"7640335403741331474"	Ad ID

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/tiktok/ad-detail" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'ads_id=7640335403741331474'

TikTok · Ad keyframes — $0.002 / successful call

GET /v1/social/tiktok/ad-keyframes

Check live TikTok · Ad keyframes price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`material_id`	string	Yes	—	"7640335403741331474"	Ad material ID
`metric`	string	No	"retain_ctr"	"retain_ctr"	Analysis metric (retain_ctr, retain_cvr, click_cnt, convert_cnt, play_retain_cnt)

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/tiktok/ad-keyframes" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'material_id=7640335403741331474'

TikTok · Ad engagement — $0.002 / successful call

GET /v1/social/tiktok/ad-engagement

Check live TikTok · Ad engagement price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`material_id`	string	Yes	—	"7640335403741331474"	Ad material ID
`metric_type`	string	No	"remain"	"remain"	Analysis type (ctr, cvr, clicks, conversion, remain)
`period_type`	integer	No	180	180	Period type (days)

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/tiktok/ad-engagement" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'material_id=7640335403741331474'

TikTok · Hashtag trends — $0.002 / successful call

GET /v1/social/tiktok/hashtag-trends

Check live TikTok · Hashtag trends price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`time_range`	integer	No	7	7	Time range in days
`country_code`	string	No	"US"	"US"	Country code
`page`	integer	No	1	1	Page number
`limit`	integer	No	20	20	Items per page
`industry_id`	integer	No	—	—	First-level industry ID (optional)

curl request

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

TikTok · Video trends — $0.002 / successful call

GET /v1/social/tiktok/video-trends

Check live TikTok · Video trends price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`period_end_timestamp`	integer	Yes	—	1794182400	Ranking period end
`period_dimension`	integer	No	3	3	Ranking period: 1 weekly, 3 daily (default), 5 long-period; selects the ranking type for period_end_timestamp, not the last 1/3/5
`country_code`	string	No	"US"	"US"	Country code
`content_label_ids`	string	No	""	""	Content label IDs, comma separated
`order_by_metric`	integer	No	1	1	Order by metric
`organic_only`	boolean	No	false	false	Organic content only
`page`	integer	No	1	1	Page number
`limit`	integer	No	20	20	Items per page, max 100

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/tiktok/video-trends" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'period_end_timestamp=1794182400'

TikTok · Product details — $0.002 / successful call

GET /v1/social/tiktok/product

Check live TikTok · Product details price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`product_id`	string	Yes	—	"1729702569456010647"	Product ID
`seller_id`	string	No	—	"8647665302234432919"	Seller ID (optional)
`region`	string	No	"SG"	"SG"	GB and BR are unavailable.

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/tiktok/product" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'product_id=1729702569456010647'

TikTok · Shop products — $0.002 / successful call

GET /v1/social/tiktok/shop-products

Check live TikTok · Shop products price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`seller_id`	string	Yes	—	"7495378171960002980"	US seller ID
`searchParams`	string	No	""	""	Search params
`region`	string	No	"US"	"US"	Region code; only US is supported.

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/tiktok/shop-products" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'seller_id=7495378171960002980'

TikTok · Product categories — $0.002 / successful call

GET /v1/social/tiktok/product-categories

Check live TikTok · Product categories price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`region`	string	No	"US"	"US"	GB and BR are unavailable.

curl request

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

TikTok · Hot products — $0.002 / successful call

GET /v1/social/tiktok/hot-products

Check live TikTok · Hot products price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`region`	string	No	"MY"	"SG"	US, GB and BR are temporarily unavailable.
`count`	integer	No	20	20	Maximum products to return, 1 to 100, default 20 Constraints: {"minimum": 1, "maximum": 100}
`exclude_product_ids`	string	No	""	""	Previously retrieved product IDs separated by commas, used for paging

curl request

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

TikTok · Product reviews — $0.002 / successful call

GET /v1/social/tiktok/product-reviews

Check live TikTok · Product reviews price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`product_id`	string	Yes	—	"1730629802597257636"	Product ID
`page_start`	integer	No	1	1	Page start
`sort_rule`	integer	No	2	2	Most recent
`filter_type`	integer	No	1	1	Verified purchase
`filter_value`	integer	No	6	6	For filter_type=1, 6=all and 5-1=star rating; use 1 for filter_type=2 or 3
`region`	string	No	"US"	"US"	GB and BR are unavailable.

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/tiktok/product-reviews" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'product_id=1730629802597257636'

TikTok · Product search — $0.002 / successful call

GET /v1/social/tiktok/product-search

Check live TikTok · Product search price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`search_word`	string	Yes	—	"headphones"	Search keyword
`offset`	integer	No	0	0	Offset
`page_token`	string	No	""	""	Page token
`region`	string	No	"US"	"US"	Region code; only US is supported.

curl request

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

Xiaohongshu (RED) · Creator basics — $0.04 / successful call

GET /v1/social/xiaohongshu/creator-base

Check live Xiaohongshu (RED) · Creator basics price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`user_id`	string	Yes	—	"5c668b3e0000000012021605"	Blogger user ID

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/xiaohongshu/creator-base" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'user_id=5c668b3e0000000012021605'

Xiaohongshu (RED) · Creator audience — $0.04 / successful call

GET /v1/social/xiaohongshu/creator-audience

Check live Xiaohongshu (RED) · Creator audience price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`user_id`	string	Yes	—	"5c668b3e0000000012021605"	Blogger user ID

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/xiaohongshu/creator-audience" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'user_id=5c668b3e0000000012021605'

Xiaohongshu (RED) · Creator top posts — $0.04 / successful call

GET /v1/social/xiaohongshu/creator-top-posts

Check live Xiaohongshu (RED) · Creator top posts price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`user_id`	string	Yes	—	"5c668b3e0000000012021605"	Blogger user ID
`page_number`	integer	No	1	1	Page number, from 1 Constraints: {"minimum": 1, "maximum": 1000}
`page_size`	integer	No	8	8	Page size, 1-8 (fixed at 8 on PGY web) Constraints: {"minimum": 1, "maximum": 8}
`note_type`	integer	No	0	0	Note type Constraints: {"enum": [0, 1, 2]}
`order_type`	integer	No	1	1	Sort Constraints: {"enum": [1, 2, 3]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/xiaohongshu/creator-top-posts" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'user_id=5c668b3e0000000012021605'

Xiaohongshu (RED) · Creator content statistics — $0.04 / successful call

GET /v1/social/xiaohongshu/creator-stats

Check live Xiaohongshu (RED) · Creator content statistics price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`user_id`	string	Yes	—	"5c668b3e0000000012021605"	Blogger user ID
`business`	integer	No	0	0	Note scope Constraints: {"enum": [0, 1]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/xiaohongshu/creator-stats" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'user_id=5c668b3e0000000012021605'

Xiaohongshu (RED) · Creator follower trend — $0.04 / successful call

GET /v1/social/xiaohongshu/creator-follower-trend

Check live Xiaohongshu (RED) · Creator follower trend price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`user_id`	string	Yes	—	"5c668b3e0000000012021605"	Blogger user ID
`increase_type`	integer	No	1	1	Curve: 1=total, 2=daily increment Constraints: {"enum": [1, 2]}
`date_type`	integer	No	1	1	Date range: 1=last 30d, 2=last 60d Constraints: {"enum": [1, 2]}

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/xiaohongshu/creator-follower-trend" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'user_id=5c668b3e0000000012021605'

Bilibili · Video danmaku comments — $0.002 / successful call

GET /v1/social/bilibili/danmaku

Check live Bilibili · Video danmaku comments price and parameters in Dash

Parameter	Type	Required	Default	Example	Description
`cid`	string	Yes	—	"1639235405"	Video cid

curl request

curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/bilibili/danmaku" \
  -H "Authorization: Bearer $CHINAAPI_API_KEY" \
  --data-urlencode 'cid=1639235405'