Cross-platform · Search posts
Beta
Public data from social platforms, billed per call, on the same API key and balance as your model calls.
Paid accounts only: a first top-up is required and there is no free trial · A call is charged only when it returns HTTP 200 with a non-empty data; empty results, rejected parameters and upstream failures are free.
Request parameters
Parameters go in the query string under the platform's own names. Examples come from the catalog; replace identifiers with the content you want to retrieve.
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
query | string | Yes | "人工智能" | Search terms; separate terms with spaces to require all of them. Put excluded words in exclude_words. |
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. |
since | string | No | — | First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until |
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 |
types | array | No | ["original","repost","comment"] | Content types, all by default: original, repost, comment Pass a JSON array in this query parameter. |
sentiment | array | No | ["negative","neutral","positive"] | Sentiment, all by default: negative, neutral, positive Pass a JSON array in this query parameter. |
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. |
exclude_words | string | No | — | Filter words; results that contain them are left out |
author | string | No | — | Only content published by this author (account name) |
page | integer | No | 1 | Page number, from 1, at most 50 |
limit | integer | No | 20 | Results per page: 10 or 20 |
Request example
curl --get "https://api.chinaapi.ai/v1/social/cross-platform/search" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'query=人工智能'Response shape
A successful response wraps the platform's data in a small envelope. Everything inside data — field names, pagination cursors, IDs — is the platform's own; pass cursors back exactly as you received them.
{
"object": "social.result",
"platform": "cross-platform",
"capability": "search",
"data": { … }
}Pagination
Paging parameters: page. Every page is a separately billed call; take cursor values from the previous response exactly as returned.
Errors and what is not charged
| Status Code | Error code | Meaning |
|---|---|---|
| 400 | — | A parameter is unknown, repeated, too long, of the wrong type or missing, including when no member of an "at least one of" group is given. The error code says which, such as unknown_parameter or missing_parameter. |
| 403 | model_requires_topup | The account has not completed its first top-up. |
| 404 | social_data_no_result | The platform and capability pair does not exist, or the platform found nothing for these parameters (social_data_no_result). |
| 429 | social_data_capacity_reached | The beta's capacity for the day is used up and resets at 00:00 UTC, or the platform is busy and a retry a few seconds later will do. Do not retry in a tight loop. |
| 502 | social_data_no_result | The data source did not answer, or answered without data. |
| 503 | social_data_unavailable | This endpoint is paused right now; the live catalog lists it as paused. |
None of these responses is charged.
Every response carries an X-Oneapi-Request-Id header; include it when you contact support and we can find that exact call.
Beta terms
Complete your first top-up before calling. Trial credit cannot be spent on these endpoints; an account that has never topped up gets HTTP 403 model_requires_topup. The beta has no SLA, and its platforms, endpoints and prices may change.
Follow each platform's terms and the data-protection rules that apply to you. Do not use this API to build profiles of individuals. Logging in, extracting contact details, manipulating engagement and reaching private or paid content are outside this beta.
Data API rate benefits
Data API rate benefits
Paid accounts start at 10 requests/second and automatically increase with cumulative net spending, up to 100 requests/second.
| Cumulative net spending | Requests per second |
|---|---|
| Paid default | 10/s |
| Over USD 50 | 20/s |
| Over USD 500 | 50/s |
| Over USD 1500 | 100/s |
Spending basis: settled Data API charges minus API refunds. Top-ups and model API spending do not count.
All API keys in an account share this rate. It measures requests per second, not simultaneous requests.
Supplier endpoints have separate capacity limits that also affect the available throughput.