Social Media Cross Platform Search

10.52 credits per call with results; no results are free
ae_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.

SocialSearchNews
10.52 credits per call with results; no results are free

Pricing

10.52 credits per call with results; no results are free
Result statusCharge
Results found10.52 credits/call
No results0 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.

ParameterTypeRequiredDescriptionDefault
pageintegerNoPage number, from 1, at most 501
limitenum (10 | 20)NoResults per page: 10 or 2020
matcharrayNoWhere 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"]
querystringYesWhat to search for. Separate terms with spaces to require all of them, as in 人工智能 教育; put words to leave out in exclude_words—
sincestringNoFirst day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until—
typesarrayNoContent types, all by default: original, repost, comment["original","repost","comment"]
untilstringNoLast day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days—
authorstringNoOnly content published by this author (account name)—
platformsarrayNoOnly 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"]
sentimentarrayNoSentiment, all by default: negative, neutral, positive["negative","neutral","positive"]
exclude_wordsstringNoFilter words; results that contain them are left out—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_social_media_cross_platform_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "exclude_words": "小说 故事 股票 行情分析 进博会 海外",
    "limit": 20,
    "page": 1,
    "platforms": [
      "weibo"
    ],
    "query": "济南 卷烟箱 招标",
    "since": "2026-11-05",
    "until": "2026-11-12"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": {
    "by_platform": {
      "weibo": 0
    },
    "has_more": false,
    "items": [],
    "limit": 20,
    "page": 1,
    "prov": {
      "hash": "0x64bd3a529957fcdc",
      "source": "live",
      "ts": "2026-11-12T10:02:42+08:00"
    }
  }
}

This example shows part of the response. Copied content is valid JSON.