X (Twitter) · Post details
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 |
|---|---|---|---|---|
tweet_id | string | Yes | "1808168603721650364" | Tweet ID |
Request example
curl --get "https://api.chinaapi.ai/v1/social/twitter/post" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'tweet_id=1808168603721650364'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": "twitter",
"capability": "post",
"data": { … }
}Pagination
This endpoint has no paging parameters.
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.