Twitter / X 趋势推文 API
按语言、地区和可选话题查询公开趋势推文时间线。
按语言、地区和可选话题查询公开趋势推文时间线。
打开产品页与 API Tester接口与鉴权
POST https://api.goanyapi.com/api/v1/twitter/trending同步返回结果,无任务或轮询。使用 Authorization: Bearer YOUR_API_KEY;参数放在 JSON 请求体。没有 Path 或 Query 参数。
输入参数
每次最多返回 20 条,实际返回可能更少。不支持分页,不接受 count、page_size 或 cursor 参数。
| 参数 | 位置 | 类型 | 必填 | 默认值 | 范围与说明 |
|---|---|---|---|---|---|
| Authorization | Header | string | 是 | — | Bearer YOUR_API_KEY |
| Content-Type | Header | string | 是 | application/json | application/json |
| language | JSON body | string | 否 | "en" | 见下方完整枚举 |
| placeId | JSON body | string | 否 | "" | 见下方完整枚举 |
| topicId | JSON body | string | 否 | — | 数字话题 ID 或 https://x.com/i/topics/123 形式的完整链接,不是地区 ID,不设枚举。 maxLength=2048 |
topicId 接受数字话题 ID 或 https://x.com/i/topics/123 链接,不是枚举。placeId 是地区标识,不能替代 topicId 或 woeid。
language
| 值 | 名称 |
|---|---|
| "en" | English (en) |
| "ja" | 日本語 (ja) |
| "zh" | 中文 (zh) |
| "ko" | 한국어 (ko) |
| "es" | Español (es) |
| "fr" | Français (fr) |
| "de" | Deutsch (de) |
| "pt" | Português (pt) |
| "ru" | Русский (ru) |
| "ar" | العربية (ar) |
| "hi" | हिन्दी (hi) |
| "id" | Bahasa Indonesia (id) |
| "th" | ไทย (th) |
| "tr" | Türkçe (tr) |
| "vi" | Tiếng Việt (vi) |
placeId
| 值 | 名称 |
|---|---|
| "" | 全球 |
| "-7608764736147602991" | 🇺🇸 United States |
| "-2938771511404889033" | 🇩🇿 Algeria |
| "5565096121164180265" | 🇦🇷 Argentina |
| "4545484598816818534" | 🇦🇺 Australia |
| "3477066258611901349" | 🇦🇹 Austria |
| "-6967522436594057822" | 🇧🇩 Bangladesh |
| "8700865690535483778" | 🇧🇪 Belgium |
| "1950197124717128353" | 🇧🇷 Brazil |
| "3708319748991051719" | 🇨🇦 Canada |
| "5162197366559151326" | 🇨🇱 Chile |
| "448449062339483107" | 🇨🇴 Colombia |
| "7736400604048538601" | 🇨🇿 Czech Republic |
| "-4424729568631920893" | 🇩🇰 Denmark |
| "5639574119361710880" | 🇪🇨 Ecuador |
| "-4154065666575264154" | 🇪🇬 Egypt |
| "-4343619646806415630" | 🇪🇹 Ethiopia |
| "-1744726079396219878" | 🇫🇮 Finland |
| "-882767250859714689" | 🇫🇷 France |
| "-158432913530051802" | 🇩🇪 Germany |
| "-4571337146556827642" | 🇬🇭 Ghana |
| "3379932461505701466" | 🇬🇷 Greece |
| "-9099280338087611406" | 🇭🇺 Hungary |
| "-5165415742961667872" | 🇮🇳 India |
| "-3568670787064367969" | 🇮🇩 Indonesia |
| "2820826012199272570" | 🇮🇷 Iran |
| "-5319640165985647807" | 🇮🇶 Iraq |
| "-1556106695608941113" | 🇮🇪 Ireland |
| "3376413446669583689" | 🇮🇱 Israel |
| "-4063967790046936818" | 🇮🇹 Italy |
| "-2995833801110313328" | 🇯🇲 Jamaica |
| "499763682993518708" | 🇯🇵 Japan |
| "-260501929978120120" | 🇯🇴 Jordan |
| "1706136829559624331" | 🇰🇪 Kenya |
| "-3241657007340602969" | 🇰🇼 Kuwait |
| "6357909739404339665" | 🇱🇧 Lebanon |
| "-8776409192903084900" | 🇲🇾 Malaysia |
| "2689506185291075782" | 🇲🇽 Mexico |
| "-5333313881682429798" | 🇲🇦 Morocco |
| "-8674639883747605872" | 🇳🇱 Netherlands |
| "793650451909123257" | 🇳🇿 New Zealand |
| "6463355099376608651" | 🇳🇬 Nigeria |
| "930197452956643198" | 🇳🇴 Norway |
| "-1432840641003940880" | 🇴🇲 Oman |
| "7250935481943878042" | 🇵🇰 Pakistan |
| "3313135070624720100" | 🇵🇪 Peru |
| "-354342964243026931" | 🇵🇭 Philippines |
| "-2808195226817565729" | 🇵🇱 Poland |
| "-9108274811673285316" | 🇵🇹 Portugal |
| "-6535811615842162329" | 🇶🇦 Qatar |
| "-625131485298729454" | 🇷🇴 Romania |
| "6274701892295617822" | 🇷🇺 Russia |
| "626799985901619848" | 🇸🇦 Saudi Arabia |
| "2668868410128916434" | 🇸🇬 Singapore |
| "-2478090862324094135" | 🇿🇦 South Africa |
| "-4607653479203584261" | 🇰🇷 South Korea |
| "-1378972998044664988" | 🇪🇸 Spain |
| "1674261238603557541" | 🇱🇰 Sri Lanka |
| "-9029363556881223240" | 🇸🇪 Sweden |
| "5655432603301324742" | 🇨🇭 Switzerland |
| "4193143159185317023" | 🇹🇿 Tanzania |
| "-7544610135368989548" | 🇹🇭 Thailand |
| "6763434224275225245" | 🇹🇳 Tunisia |
| "7506474075071901506" | 🇹🇷 Turkey |
| "598148624890232477" | 🇺🇦 Ukraine |
| "4567653256866191997" | 🇦🇪 United Arab Emirates |
| "7212154512116281289" | 🇬🇧 United Kingdom |
| "2553902795103616732" | 🇻🇳 Vietnam |
| "302730704137459992" | 🇻🇪 Venezuela |
请求示例
POST /api/v1/twitter/trending
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"language": "en"
}输出字段
成功返回 HTTP 200。业务结果位于 data.result。null、空字符串、空数组和缺失字段按实际数据保留,零值是有效统计。不会因某个展示字段为空而使整次请求失败。
| 字段 | 类型 | 说明 |
|---|---|---|
| code | string | 成功为 ok;错误为对应错误码 |
| message | string | 状态说明 |
| data.result | object / null | 实际业务数据,null 原样保留 |
| data.creditsUsed | integer | 本次扣除积分,来自当前配置 |
| data.remainingCredits | number | 结算后余额 |
| data.result.woeid | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.trends | array | 当前响应的记录列表 |
| data.result.trends[].name | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.trends[].query | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.trends[].url | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.trends[].tweetVolume | null (observed) | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.createdAt | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.location | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.asOf | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets | array | 当前响应的记录列表 |
| data.result.tweets[].author | object | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].author.name | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].author.screen_name | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].author.id | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].url | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].created_at | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].views | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].text | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].counts | object | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].counts.bookmark_count | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].counts.favorite_count | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].counts.quote_count | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].counts.retweet_count | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].counts.reply_count | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card | object | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.name | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.title | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.image | object | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.image.alt | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.image.url | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.image.width | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.image.height | integer | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.url | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.domain | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].card.description | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].quoted | null (observed) | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].media | array | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].media[].type | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].media[].url | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].media[].expanded_url | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].media[].alt | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].media[].video_info | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].lang | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].links | array | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].links[].display | null (observed) | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].links[].tco | null (observed) | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].links[].expanded | string | 公开业务字段;按实际结果返回,可为空或缺失 |
| data.result.tweets[].id | string | 公开业务字段;按实际结果返回,可为空或缺失 |
此接口无分页参数。
真实响应示例
以下保存自真实成功响应,仅展示公开业务字段。示例省略实时 data.creditsUsed 和 data.remainingCredits;实际请求返回当前配置费用和账户余额。没有删减列表记录。媒体链接可能过期。打开示例不会查询或扣费。
{
"code": "ok",
"message": "ok",
"data": {
"result": {
"woeid": "1",
"location": "Worldwide",
"asOf": "2026-11-16T02:48:20Z",
"createdAt": "2026-11-15T06:55:37Z",
"trends": [
{
"name": "Steelers",
"query": "Steelers",
"url": "http://twitter.com/search?q=Steelers",
"tweetVolume": null
},
{
"name": "Cowboys",
"query": "Cowboys",
"url": "http://twitter.com/search?q=Cowboys",
"tweetVolume": null
},
{
"name": "Bengals",
"query": "Bengals",
"url": "http://twitter.com/search?q=Bengals",
"tweetVolume": null
},
{
"name": "#ブラックサンダーとミルクマニア",
"query": "%23%E3%83%96%E3%83%A9%E3%83%83%E3%82%AF%E3%82%B5%E3%83%B3%E3%83%80%E3%83%BC%E3%81%A8%E3%83%9F%E3%83%AB%E3%82%AF%E3%83%9E%E3%83%8B%E3%82%A2",
"url": "http://twitter.com/search?q=%23%E3%83%96%E3%83%A9%E3%83%83%E3%82%AF%E3%82%B5%E3%83%B3%E3%83%80%E3%83%BC%E3%81%A8%E3%83%9F%E3%83%AB%E3%82%AF%E3%83%9E%E3%83%8B%E3%82%A2",
"tweetVolume": null
},
{
"name": "#はま寿司の旨ねた冬祭り",
"query": "%23%E3%81%AF%E3%81%BE%E5%AF%BF%E5%8F%B8%E3%81%AE%E6%97%A8%E3%81%AD%E3%81%9F%E5%86%AC%E7%A5%AD%E3%82%8A",
"url": "http://twitter.com/search?q=%23%E3%81%AF%E3%81%BE%E5%AF%BF%E5%8F%B8%E3%81%AE%E6%97%A8%E3%81%AD%E3%81%9F%E5%86%AC%E7%A5%AD%E3%82%8A",
"tweetVolume": null
},
{
"name": "49ers",
"query": "49ers",
"url": "http://twitter.com/search?q=49ers",
"tweetVolume": null
},
{
"name": "#クーリッシュカラースプレーでた",
"query": "%23%E3%82%AF%E3%83%BC%E3%83%AA%E3%83%83%E3%82%B7%E3%83%A5%E3%82%AB%E3%83%A9%E3%83%BC%E3%82%B9%E3%83%97%E3%83%AC%E3%83%BC%E3%81%A7%E3%81%9F",
"url": "http://twitter.com/search?q=%23%E3%82%AF%E3%83%BC%E3%83%AA%E3%83%83%E3%82%B7%E3%83%A5%E3%82%AB%E3%83%A9%E3%83%BC%E3%82%B9%E3%83%97%E3%83%AC%E3%83%BC%E3%81%A7%E3%81%9F",
"tweetVolume": null
},
{
"name": "通信障害",
"query": "%E9%80%9A%E4%BF%A1%E9%9A%9C%E5%AE%B3",
"url": "http://twitter.com/search?q=%E9%80%9A%E4%BF%A1%E9%9A%9C%E5%AE%B3",
"tweetVolume": null
},
{
"name": "Ferro",
"query": "Ferro",
"url": "http://twitter.com/search?q=Ferro",
"tweetVolume": null
},
{
"name": "Aaron Rodgers",
"query": "%22Aaron+Rodgers%22",
"url": "http://twitter.com/search?q=%22Aaron+Rodgers%22",
"tweetVolume": null
},
{
"name": "#UKKJKemenag2026",
"query": "%23UKKJKemenag2026",
"url": "http://twitter.com/search?q=%23UKKJKemenag2026",
"tweetVolume": null
},
{
"name": "NTTドコモ",
"query": "NTT%E3%83%89%E3%82%B3%E3%83%A2",
"url": "http://twitter.com/search?q=NTT%E3%83%89%E3%82%B3%E3%83%A2",
"tweetVolume": null
},
{
"name": "DK Metcalf",
"query": "%22DK+Metcalf%22",
"url": "http://twitter.com/search?q=%22DK+Metcalf%22",
"tweetVolume": null
},
{
"name": "Niners",
"query": "Niners",
"url": "http://twitter.com/search?q=Niners",
"tweetVolume": null
},
{
"name": "#ProvaDeFogo",
"query": "%23ProvaDeFogo",
"url": "http://twitter.com/search?q=%23ProvaDeFogo",
"tweetVolume": null
},
{
"name": "Jordan Battle",
"query": "%22Jordan+Battle%22",
"url": "http://twitter.com/search?q=%22Jordan+Battle%22",
"tweetVolume": null
},
{
"name": "Joe Burrow",
"query": "%22Joe+Burrow%22",
"url": "http://twitter.com/search?q=%22Joe+Burrow%22",
"tweetVolume": null
},
{
"name": "Jerry",
"query": "Jerry",
"url": "http://twitter.com/search?q=Jerry",
"tweetVolume": null
},
{
"name": "実刑判決",
"query": "%E5%AE%9F%E5%88%91%E5%88%A4%E6%B1%BA",
"url": "http://twitter.com/search?q=%E5%AE%9F%E5%88%91%E5%88%A4%E6%B1%BA",
"tweetVolume": null
},
{
"name": "Scottie Barnes",
"query": "%22Scottie+Barnes%22",
"url": "http://twitter.com/search?q=%22Scottie+Barnes%22",
"tweetVolume": null
},
{
"name": "ジャンポケ斉藤慎二",
"query": "%E3%82%B8%E3%83%A3%E3%83%B3%E3%83%9D%E3%82%B1%E6%96%89%E8%97%A4%E6%85%8E%E4%BA%8C",
"url": "http://twitter.com/search?q=%E3%82%B8%E3%83%A3%E3%83%B3%E3%83%9D%E3%82%B1%E6%96%89%E8%97%A4%E6%85%8E%E4%BA%8C",
"tweetVolume": null
},
{
"name": "Von Miller",
"query": "%22Von+Miller%22",
"url": "http://twitter.com/search?q=%22Von+Miller%22",
"tweetVolume": null
},
{
"name": "UKKJ 2026",
"query": "%22UKKJ+2026%22",
"url": "http://twitter.com/search?q=%22UKKJ+2026%22",
"tweetVolume": null
},
{
"name": "ロケバス内",
"query": "%E3%83%AD%E3%82%B1%E3%83%90%E3%82%B9%E5%86%85",
"url": "http://twitter.com/search?q=%E3%83%AD%E3%82%B1%E3%83%90%E3%82%B9%E5%86%85",
"tweetVolume": null
},
{
"name": "Purdy",
"query": "Purdy",
"url": "http://twitter.com/search?q=Purdy",
"tweetVolume": null
},
{
"name": "Christian Parker",
"query": "%22Christian+Parker%22",
"url": "http://twitter.com/search?q=%22Christian+Parker%22",
"tweetVolume": null
},
{
"name": "性的暴行の罪",
"query": "%E6%80%A7%E7%9A%84%E6%9A%B4%E8%A1%8C%E3%81%AE%E7%BD%AA",
"url": "http://twitter.com/search?q=%E6%80%A7%E7%9A%84%E6%9A%B4%E8%A1%8C%E3%81%AE%E7%BD%AA",
"tweetVolume": null
},
{
"name": "Chase Brown",
"query": "%22Chase+Brown%22",
"url": "http://twitter.com/search?q=%22Chase+Brown%22",
"tweetVolume": null
},
{
"name": "Pickens",
"query": "Pickens",
"url": "http://twitter.com/search?q=Pickens",
"tweetVolume": null
},
{
"name": "ANV 2YEARS SECRET LOVE",
"query": "%22ANV+2YEARS+SECRET+LOVE%22",
"url": "http://twitter.com/search?q=%22ANV+2YEARS+SECRET+LOVE%22",
"tweetVolume": null
},
{
"name": "राष्ट्रीय प्रेस",
"query": "%22%E0%A4%B0%E0%A4%BE%E0%A4%B7%E0%A5%8D%E0%A4%9F%E0%A5%8D%E0%A4%B0%E0%A5%80%E0%A4%AF+%E0%A4%AA%E0%A5%8D%E0%A4%B0%E0%A5%87%E0%A4%B8%22",
"url": "http://twitter.com/search?q=%22%E0%A4%B0%E0%A4%BE%E0%A4%B7%E0%A5%8D%E0%A4%9F%E0%A5%8D%E0%A4%B0%E0%A5%80%E0%A4%AF+%E0%A4%AA%E0%A5%8D%E0%A4%B0%E0%A5%87%E0%A4%B8%22",
"tweetVolume": null
},
{
"name": "Pengawas Sekolah",
"query": "%22Pengawas+Sekolah%22",
"url": "http://twitter.com/search?q=%22Pengawas+Sekolah%22",
"tweetVolume": null
},
{
"name": "Mason McCormick",
"query": "%22Mason+McCormick%22",
"url": "http://twitter.com/search?q=%22Mason+McCormick%22",
"tweetVolume": null
},
{
"name": "Courtney",
"query": "Courtney",
"url": "http://twitter.com/search?q=Courtney",
"tweetVolume": null
},
{
"name": "Mendoza",
"query": "Mendoza",
"url": "http://twitter.com/search?q=Mendoza",
"tweetVolume": null
},
{
"name": "Kerjasama Indonesia Norwegia",
"query": "%22Kerjasama+Indonesia+Norwegia%22",
"url": "http://twitter.com/search?q=%22Kerjasama+Indonesia+Norwegia%22",
"tweetVolume": null
},
{
"name": "Drew Sample",
"query": "%22Drew+Sample%22",
"url": "http://twitter.com/search?q=%22Drew+Sample%22",
"tweetVolume": null
},
{
"name": "England",
"query": "England",
"url": "http://twitter.com/search?q=England",
"tweetVolume": null
},
{
"name": "Ja'Marr Chase",
"query": "%22Ja%27Marr+Chase%22",
"url": "http://twitter.com/search?q=%22Ja%27Marr+Chase%22",
"tweetVolume": null
},
{
"name": "Bosa",
"query": "Bosa",
"url": "http://twitter.com/search?q=Bosa",
"tweetVolume": null
},
{
"name": "アチーブ",
"query": "%E3%82%A2%E3%83%81%E3%83%BC%E3%83%96",
"url": "http://twitter.com/search?q=%E3%82%A2%E3%83%81%E3%83%BC%E3%83%96",
"tweetVolume": null
},
{
"name": "Dak Prescott",
"query": "%22Dak+Prescott%22",
"url": "http://twitter.com/search?q=%22Dak+Prescott%22",
"tweetVolume": null
},
{
"name": "Critical Health",
"query": "%22Critical+Health%22",
"url": "http://twitter.com/search?q=%22Critical+Health%22",
"tweetVolume": null
},
{
"name": "Drew Lock",
"query": "%22Drew+Lock%22",
"url": "http://twitter.com/search?q=%22Drew+Lock%22",
"tweetVolume": null
},
{
"name": "Packers",
"query": "Packers",
"url": "http://twitter.com/search?q=Packers",
"tweetVolume": null
},
{
"name": "Collinsworth",
"query": "Collinsworth",
"url": "http://twitter.com/search?q=Collinsworth",
"tweetVolume": null
},
{
"name": "Seahawks",
"query": "Seahawks",
"url": "http://twitter.com/search?q=Seahawks",
"tweetVolume": null
},
{
"name": "Browns",
"query": "Browns",
"url": "http://twitter.com/search?q=Browns",
"tweetVolume": null
},
{
"name": "Spain",
"query": "Spain",
"url": "http://twitter.com/search?q=Spain",
"tweetVolume": null
},
{
"name": "Peñarol",
"query": "Pe%C3%B1arol",
"url": "http://twitter.com/search?q=Pe%C3%B1arol",
"tweetVolume": null
}
]
}
}
}计费
当前配置下,每次成功请求消耗 1 积分。
每次成功请求包含空结果,均按当前数据库配置结算;失败不扣费。查询前必须有足够余额,并发结算时余额不足返回 402,不交付未结算结果。URL 解析不单独收费。
状态码与错误
| HTTP | 含义 |
|---|---|
| 200 | 成功(含空结果) |
| 400 | JSON 或参数无效 |
| 401 | 鉴权无效 |
| 402 | 积分不足 |
| 429 | 请求过于频繁,按 Retry-After 等待 |
| 502 | 数据请求失败 |
| 503 | 接口或价格未配置 |
{"code":"invalid_params","message":"Invalid parameter"}