API 文档

Twitter / X 趋势推文 API

按语言、地区和可选话题查询公开趋势推文时间线。

测试 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 参数。

参数位置类型必填默认值范围与说明
AuthorizationHeaderstring是—Bearer YOUR_API_KEY
Content-TypeHeaderstring是application/jsonapplication/json
languageJSON bodystring否"en"见下方完整枚举
placeIdJSON bodystring否""见下方完整枚举
topicIdJSON bodystring否—数字话题 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、空字符串、空数组和缺失字段按实际数据保留,零值是有效统计。不会因某个展示字段为空而使整次请求失败。

字段类型说明
codestring成功为 ok;错误为对应错误码
messagestring状态说明
data.resultobject / null实际业务数据,null 原样保留
data.creditsUsedinteger本次扣除积分,来自当前配置
data.remainingCreditsnumber结算后余额
data.result.woeidstring公开业务字段;按实际结果返回,可为空或缺失
data.result.trendsarray当前响应的记录列表
data.result.trends[].namestring公开业务字段;按实际结果返回,可为空或缺失
data.result.trends[].querystring公开业务字段;按实际结果返回,可为空或缺失
data.result.trends[].urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.trends[].tweetVolumenull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.createdAtstring公开业务字段;按实际结果返回,可为空或缺失
data.result.locationstring公开业务字段;按实际结果返回,可为空或缺失
data.result.asOfstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweetsarray当前响应的记录列表
data.result.tweets[].authorobject公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].author.namestring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].author.screen_namestring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].author.idstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].created_atstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].viewsstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].textstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].countsobject公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].counts.bookmark_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].counts.favorite_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].counts.quote_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].counts.retweet_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].counts.reply_countinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].cardobject公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.namestring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.titlestring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.imageobject公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.image.altstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.image.urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.image.widthinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.image.heightinteger公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.domainstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].card.descriptionstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].quotednull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].mediaarray公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].media[].typestring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].media[].urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].media[].expanded_urlstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].media[].altstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].media[].video_infostring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].langstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].linksarray公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].links[].displaynull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].links[].tconull (observed)公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].links[].expandedstring公开业务字段;按实际结果返回,可为空或缺失
data.result.tweets[].idstring公开业务字段;按实际结果返回,可为空或缺失

此接口无分页参数。

真实响应示例

以下保存自真实成功响应,仅展示公开业务字段。示例省略实时 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成功(含空结果)
400JSON 或参数无效
401鉴权无效
402积分不足
429请求过于频繁,按 Retry-After 等待
502数据请求失败
503接口或价格未配置
{"code":"invalid_params","message":"Invalid parameter"}