搜索与趋势
/v1/search/advanced 支持与 X 网页版完全相同的操作符：from:elonmusk、to:binance、since:2026-01-01、min_faves:100、$SOL、#bitcoin、lang:zh、-filter:replies。结果是实时的、非缓存 —— 这正是它能用于事件监测与舆情分析的原因。
product 参数决定返回什么：Latest 按时间（默认）、Top 按热度、Media 只返回带图片或视频的推文。
有两个接口底层也是搜索，但因为回答的问题不同而单独开放：/v1/user/mentions（谁在 @ 某账号）与 /v1/tweet/quotes（谁引用了某条推文）。用它们，不必自己拼搜索语法。
热榜方面，/v1/trends 给全球趋势；/v1/trends/place 可细到具体国家或城市 —— 先调一次 /v1/trends/locations 拿到 467 个地区 ID，这份清单基本是静态的，建议缓存。
关于计费：查询完成即计费，即使结果为空 ——确认「这个账号不存在」同样是我们为你执行的一次查询。被直接拒绝的请求（参数缺失或非法，HTTP 400）不计费；我方原因导致的错误，也一律不计费。
本页 6 个接口
GET/v1/search/advanced
高级搜索
完整 X 搜索语法：from:、since:、min_faves、话题标签。
参数
querystring必填搜索语句
limitint可选默认 20
响应
200 OKhttps://socialapi.tech/v1/search/advanced
{ "status": "success", "data": [
{ "text": "bitcoin breaking out...",
"author": { "username": "..." } }
], "meta": { "count": 20 } }GET/v1/search/user
搜索用户
按关键词搜用户。
参数
querystring必填关键词
limitint可选默认 20
响应
200 OKhttps://socialapi.tech/v1/search/user
{ "status": "success", "data": [ ...users ] }GET/v1/trends
热搜趋势
当前热搜话题。
参数
limitint可选默认 20
响应
200 OKhttps://socialapi.tech/v1/trends
{ "status": "success", "data": [
{ "name": "Bitcoin", "domain": "Trending in Finance" }
] }GET/v1/explore
今日热点
带新闻标题的趋势 + 当下热门推文。
参数
trend_limitint可选默认 20
tweet_limitint可选默认 20
响应
200 OKhttps://socialapi.tech/v1/explore
{ "status": "success", "data": {
"trends": [ { "name": "..." } ],
"tweets": [ { "text": "..." } ] } }GET/v1/trends/place
分地区热榜
指定地区的热榜，覆盖 467 个地区 —— 两家竞品都没有。
参数
woeidint可选1 = 全球（默认）
响应
200 OKhttps://socialapi.tech/v1/trends/place
{ "status": "success", "data": {
"trends": [ { "name": "#Bitcoin", "tweet_volume": 125000 } ] },
"meta": { "count": 50, "woeid": 1 } }GET/v1/trends/locations
热榜地区字典
/v1/trends/place 接受的 467 个 WOEID。静态数据，建议缓存。
响应
200 OKhttps://socialapi.tech/v1/trends/locations
{ "status": "success", "data": [
{ "name": "Worldwide", "woeid": 1 } ], "meta": { "count": 467 } }