Social Media Cross Platform Search
Search Chinese social media and public content sources by keyword across one or multiple platform categories in a single request, including Weibo, Douyin, Toutiao, Xiaohongshu, short-video sources, WeChat official accounts, news, forums, long-video sources, and news apps. Select matching fields such as title, body, author name, image/video-frame text, or audio, and specify exclusion words. You can also filter by author, content type, and sentiment. Space-separated keywords use AND matching; OR, parentheses, and quoted-phrase syntax are unverified. Dates use inclusive Beijing-time days in YYYY-MM-DD format, default to the last seven days, and support a range of at most 90 days ending no later than today. Returns unified content details, total hits, counts by platform, and pagination information, with 10 or 20 results per page and up to page 50. Complete coverage of platforms or content is not guaranteed. Successful searches with results are billed at 10.52 credits per request. Empty results are free.
Pricing
| Result status | Charge |
|---|---|
| Results found | 10.52 credits/call |
| No results | 0 credits/call |
(Results found): 10.52 AE credits per call. (No results): 0 AE credits per call.
The rate for calls with results applies to successful requests that return search results, with a fixed fee per call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Page number, from 1, at most 50 | 1 |
limit | enum (10 | 20) | No | Results per page: 10 or 20 | 20 |
match | array | No | Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio | ["title","content","author"] |
query | string | Yes | What to search for. Separate terms with spaces to require all of them, as in 人工智能 教育; put words to leave out in exclude_words | — |
since | string | No | First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until | — |
types | array | No | Content types, all by default: original, repost, comment | ["original","repost","comment"] |
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 | — |
author | string | No | Only content published by this author (account name) | — |
platforms | array | No | 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 (forums, Tieba and Q&A sites), long_video (Bilibili and other long-video sites), app (news apps) | ["weibo","douyin","toutiao","xiaohongshu","short_video","wechat","news","forum","long_video","app"] |
sentiment | array | No | Sentiment, all by default: negative, neutral, positive | ["negative","neutral","positive"] |
exclude_words | string | No | Filter words; results that contain them are left out | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-KeyThis example shows part of the response. Copied content is valid JSON.






