API 文档

Twitter / X 趋势搜索 API

按可选标签和 timeFilter 查询趋势搜索时间线,不是任意关键词搜索。

测试 API

按可选标签和 timeFilter 查询趋势搜索时间线,不是任意关键词搜索。

打开产品页与 API Tester

接口与鉴权

POST https://api.goanyapi.com/api/v1/twitter/trending/search

同步返回结果,无任务或轮询。使用 Authorization: Bearer YOUR_API_KEY;参数放在 JSON 请求体。没有 Path 或 Query 参数。

输入参数

每次最多返回 20 条,实际返回可能更少。不支持分页,不接受 count、page_size 或 cursor 参数。

参数位置类型必填默认值范围与说明
AuthorizationHeaderstring是—Bearer YOUR_API_KEY
Content-TypeHeaderstring是application/jsonapplication/json
tagJSON bodystring否—可选趋势标签,仅用于趋势搜索时间线,不是任意关键词搜索。 maxLength=2048
timeFilterJSON bodystring否—可选字符串,按输入传递;不设枚举或未声明的默认值。 maxLength=2048

timeFilter 是可选字符串,不设枚举,不添加未声明的默认值。该接口不是任意关键词搜索。

请求示例

POST /api/v1/twitter/trending/search
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{}

输出字段

成功返回 HTTP 200。业务结果位于 data.result。null、空字符串、空数组和缺失字段按实际数据保留,零值是有效统计。不会因某个展示字段为空而使整次请求失败。

字段类型说明
codestring成功为 ok;错误为对应错误码
messagestring状态说明
data.resultobject / null实际业务数据,null 原样保留
data.creditsUsedinteger本次扣除积分,来自当前配置
data.remainingCreditsnumber结算后余额
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": {
      "tweets": [
        {
          "id": "2121922329693626392",
          "url": "https://x.com/AO3_Status/status/2121922329693626392",
          "author": {
            "name": "AO3 Status",
            "screen_name": "AO3_Status",
            "id": "90173824"
          },
          "created_at": "2026-11-15T11:04:41.000Z",
          "lang": "en",
          "text": "#AO3 is now up! Some features are temporarily disabled to bring the site back earlier than the four-week mark. There may be delays to manage traffic, please refresh if affected. No AO3 data has been deleted. For more information, refer to our status page: https://t.co/A6nVO4KceV",
          "counts": {
            "bookmark_count": 23031,
            "favorite_count": 471368,
            "quote_count": 32935,
            "reply_count": 5357,
            "retweet_count": 98848
          },
          "views": "7211595",
          "media": [],
          "card": {
            "name": "summary",
            "url": "https://t.co/A6nVO4KceV",
            "domain": "www.otwstatus.org",
            "title": "AO3 Down for Maintenance",
            "description": null,
            "image": {
              "url": "https://pbs.twimg.com/card_img/2120535968855793664/TKU7zLAs?format=png&name=orig",
              "width": 96,
              "height": 96,
              "alt": null
            }
          },
          "links": [
            {
              "tco": null,
              "expanded": "https://ao3-news.org/jap44ebd",
              "display": null
            }
          ],
          "quoted": null
        },
        {
          "id": "2121831918131904712",
          "url": "https://x.com/scott_colom/status/2121831918131904712",
          "author": {
            "name": "Scott Colom",
            "screen_name": "scott_colom",
            "id": "1958903510847954947"
          },
          "created_at": "2026-11-15T05:05:25.000Z",
          "lang": "en",
          "text": "I’m at the ATL airport and my @Delta flight has been continuously delayed because they can’t find another pilot. It’s midnight and they don’t know when or if they’ll find another pilot but won’t give out hotel vouchers until the flight is cancelled, which they can’t say when that’ll happen. This is a hot mess for Americans.\n\nOne of them just said, “pick another flight…pick another transportation secretary.” 🤷🏾‍♂️",
          "counts": {
            "bookmark_count": 2852,
            "favorite_count": 96387,
            "quote_count": 471,
            "reply_count": 1450,
            "retweet_count": 11002
          },
          "views": "3117675",
          "media": [],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121879564066619770",
          "url": "https://x.com/queermediabait/status/2121879564066619770",
          "author": {
            "name": "kat ☆ yj spoilers",
            "screen_name": "queermediabait",
            "id": "1645401480034123778"
          },
          "created_at": "2026-11-15T08:14:45.000Z",
          "lang": "en",
          "text": "ARCHIVE OF OUR OWN IS BACK!!!! I REPEAT: AO3 HAS RETURNED!!! https://t.co/Abrgr4erAL",
          "counts": {
            "bookmark_count": 4162,
            "favorite_count": 115885,
            "quote_count": 4020,
            "reply_count": 322,
            "retweet_count": 28393
          },
          "views": "1184596",
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJuN-6aQAAnUUW.jpg",
              "expanded_url": "https://x.com/queermediabait/status/2121879564066619770/photo/1",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJuN-zaYAA0XB-.jpg",
              "expanded_url": "https://x.com/queermediabait/status/2121879564066619770/photo/2",
              "alt": null,
              "video_info": null
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121882391388279212",
          "url": "https://x.com/Cinema_says/status/2121882391388279212",
          "author": {
            "name": "Cinema Crave",
            "screen_name": "Cinema_says",
            "id": "1969041873554878464"
          },
          "created_at": "2026-11-15T08:25:59.000Z",
          "lang": "en",
          "text": "The before and after nobody talks about. https://t.co/s3C7Mc5SjP",
          "counts": {
            "bookmark_count": 29813,
            "favorite_count": 118877,
            "quote_count": 1309,
            "reply_count": 1163,
            "retweet_count": 4279
          },
          "views": "20782426",
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJwu0RaEAA9uaH.jpg",
              "expanded_url": "https://x.com/Cinema_says/status/2121882391388279212/photo/1",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJwvRza4AAdBXY.jpg",
              "expanded_url": "https://x.com/Cinema_says/status/2121882391388279212/photo/2",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJwvr8aEAAvhFe.jpg",
              "expanded_url": "https://x.com/Cinema_says/status/2121882391388279212/photo/3",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJwwGcbkAEIpwk.jpg",
              "expanded_url": "https://x.com/Cinema_says/status/2121882391388279212/photo/4",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJwwhlbkAApP3W.jpg",
              "expanded_url": "https://x.com/Cinema_says/status/2121882391388279212/photo/5",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJww9QbYAAryiS.jpg",
              "expanded_url": "https://x.com/Cinema_says/status/2121882391388279212/photo/6",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJwxYZbIAA0aW2.jpg",
              "expanded_url": "https://x.com/Cinema_says/status/2121882391388279212/photo/7",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJwx1CaUAAzB2U.jpg",
              "expanded_url": "https://x.com/Cinema_says/status/2121882391388279212/photo/8",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJwyUzbgAAm7R5.jpg",
              "expanded_url": "https://x.com/Cinema_says/status/2121882391388279212/photo/9",
              "alt": null,
              "video_info": null
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121882792095031505",
          "url": "https://x.com/weekndshe/status/2121882792095031505",
          "author": {
            "name": "ayna 💋🪩",
            "screen_name": "weekndshe",
            "id": "858335856024854529"
          },
          "created_at": "2026-11-15T08:27:34.000Z",
          "lang": "en",
          "text": "COME GET UR BADGE EVERYONE https://t.co/PeXTV3KKUJ",
          "counts": {
            "bookmark_count": 8326,
            "favorite_count": 156467,
            "quote_count": 443,
            "reply_count": 192,
            "retweet_count": 41483
          },
          "views": "745985",
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJxJtjWAAAyjtY.jpg",
              "expanded_url": "https://x.com/weekndshe/status/2121882792095031505/photo/1",
              "alt": null,
              "video_info": null
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121940378555498738",
          "url": "https://x.com/melon/status/2121940378555498738",
          "author": {
            "name": "Melon 멜론",
            "screen_name": "melon",
            "id": "118953366"
          },
          "created_at": "2026-11-15T12:16:24.000Z",
          "lang": "en",
          "text": "#MMA2026 WINNER ANNOUNCEMENT\n\nArtist of the Year🏆\n#방탄소년단 #BTS\n\nCongratulations!\n\n@bts_bighit\n#멜론 #Melon #멜론뮤직어워드 https://t.co/SMUsVdpd6j",
          "counts": {
            "bookmark_count": 1410,
            "favorite_count": 56050,
            "quote_count": 1797,
            "reply_count": 1152,
            "retweet_count": 31044
          },
          "views": "1142797",
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXKlCzEbYAEN83M.jpg",
              "expanded_url": "https://x.com/melon/status/2121940378555498738/photo/1",
              "alt": null,
              "video_info": null
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121810566222098632",
          "url": "https://x.com/Gawge0us/status/2121810566222098632",
          "author": {
            "name": "Somebody Thick Ass Mama🤎",
            "screen_name": "Gawge0us",
            "id": "1894625094"
          },
          "created_at": "2026-11-15T03:40:34.000Z",
          "lang": "en",
          "text": "Any man on the train without a shirt on is not a man you need to be involved with 😭",
          "counts": {
            "bookmark_count": 2000,
            "favorite_count": 185071,
            "quote_count": 80,
            "reply_count": 240,
            "retweet_count": 5991
          },
          "views": "1725054",
          "media": [],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121838460449567217",
          "url": "https://x.com/TheCineprism/status/2121838460449567217",
          "author": {
            "name": "The Cinéprism",
            "screen_name": "TheCineprism",
            "id": "936857288274452480"
          },
          "created_at": "2026-11-15T05:31:25.000Z",
          "lang": "en",
          "text": "Inflation hits Hogwarts https://t.co/C5ClSRaCx5",
          "counts": {
            "bookmark_count": 4823,
            "favorite_count": 220973,
            "quote_count": 961,
            "reply_count": 766,
            "retweet_count": 14114
          },
          "views": "3837260",
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJI0uTa4AA76NS.jpg",
              "expanded_url": "https://x.com/TheCineprism/status/2121838460449567217/photo/1",
              "alt": null,
              "video_info": null
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121904347395043780",
          "url": "https://x.com/dearxpriest/status/2121904347395043780",
          "author": {
            "name": "lyiv 💒🪽",
            "screen_name": "dearxpriest",
            "id": "1538427916635279361"
          },
          "created_at": "2026-11-15T09:53:14.000Z",
          "lang": "en",
          "text": "the nail check 😭😭😭😭😭😭😭😭😭😭😭😭😭😭😭 she’s not having it  https://t.co/5olPjKPS2y",
          "counts": {
            "bookmark_count": 11348,
            "favorite_count": 117312,
            "quote_count": 2931,
            "reply_count": 478,
            "retweet_count": 14031
          },
          "views": "3965482",
          "media": [
            {
              "type": "video",
              "url": "https://pbs.twimg.com/amplify_video_thumb/2121898500522934272/img/xG0nCYLYWR4OYL1O.jpg",
              "expanded_url": "https://x.com/axovviz/status/2121899550386577701/video/1",
              "alt": null,
              "video_info": "https://video.twimg.com/amplify_video/2121898500522934272/vid/avc1/2160x2716/2Z8t3ZsJEgD0J2h7.mp4?tag=29"
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121944165114351969",
          "url": "https://x.com/StillwithV1/status/2121944165114351969",
          "author": {
            "name": "𐙚",
            "screen_name": "StillwithV1",
            "id": "1503445759441752073"
          },
          "created_at": "2026-11-15T12:31:27.000Z",
          "lang": "en",
          "text": "🏆Artist of the Year (Daesang)\n🏆Album of the Year (Daesang)\n🏆Best Male Group\n🏆Stage of the Year \n🏆Top 10 Artists (Bonsang)\n🏆Global Top 10 (Bonsang)  https://t.co/PIoVH6QO75",
          "counts": {
            "bookmark_count": 1432,
            "favorite_count": 52182,
            "quote_count": 302,
            "reply_count": 53,
            "retweet_count": 19948
          },
          "views": "213736",
          "media": [
            {
              "type": "video",
              "url": "https://pbs.twimg.com/amplify_video_thumb/2118796907736608768/img/viplhW-_QTPaBiVQ.jpg",
              "expanded_url": "https://x.com/jnlvmi/status/2118796932734964210/video/1",
              "alt": null,
              "video_info": "https://video.twimg.com/amplify_video/2118796907736608768/vid/avc1/960x720/NTM0Ek0ELOzLsfLN.mp4?tag=29"
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2122032351475585170",
          "url": "https://x.com/c0mpmilano/status/2122032351475585170",
          "author": {
            "name": "c0mp",
            "screen_name": "c0mpmilano",
            "id": "1772904124318679040"
          },
          "created_at": "2026-11-15T18:21:52.000Z",
          "lang": "en",
          "text": "Ronaldinho vs Forli\n\n46 years old https://t.co/CiPo8Mwzfi",
          "counts": {
            "bookmark_count": 16467,
            "favorite_count": 111224,
            "quote_count": 2800,
            "reply_count": 911,
            "retweet_count": 9790
          },
          "views": "7427104",
          "media": [
            {
              "type": "video",
              "url": "https://pbs.twimg.com/amplify_video_thumb/2122031572522037248/img/55eevrKRrIuCGW0H.jpg",
              "expanded_url": "https://x.com/c0mpmilano25722/status/2122032007832350781/video/1?a=SbBANsYwRuuzEgEVWw4&s=46",
              "alt": null,
              "video_info": "https://video.twimg.com/amplify_video/2122031572522037248/vid/avc1/1186x720/fdcgDvRWw4fymU_D.mp4?tag=29"
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121885594666037470",
          "url": "https://x.com/RupertLowe10/status/2121885594666037470",
          "author": {
            "name": "Rupert Lowe MP",
            "screen_name": "RupertLowe10",
            "id": "1121375429884039175"
          },
          "created_at": "2026-11-15T08:38:43.000Z",
          "lang": "en",
          "text": "Elon Musk has contributed more to human progress than every politician who has spent their time harassing him combined.\n\nIt's not even close.",
          "counts": {
            "bookmark_count": 857,
            "favorite_count": 66498,
            "quote_count": 260,
            "reply_count": 1544,
            "retweet_count": 6517
          },
          "views": "685976",
          "media": [],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121837409361137811",
          "url": "https://x.com/Kstheeittgirl/status/2121837409361137811",
          "author": {
            "name": "𝐇★𝐓 𝐆𝐈𝐑𝐋 🍒🐆🪩✨",
            "screen_name": "Kstheeittgirl",
            "id": "1703999516519641089"
          },
          "created_at": "2026-11-15T05:27:14.000Z",
          "lang": "en",
          "text": "Megan Thee Stallion and Queen Latifah at the 2026 Rock & Roll Hall of Fame Induction Ceremony https://t.co/a6ml9EHMwk",
          "counts": {
            "bookmark_count": 1522,
            "favorite_count": 43404,
            "quote_count": 333,
            "reply_count": 103,
            "retweet_count": 4343
          },
          "views": "942237",
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJHupZWcAAJHTH.jpg",
              "expanded_url": "https://x.com/Kstheeittgirl/status/2121837409361137811/photo/1",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJHupcXUAABuyC.jpg",
              "expanded_url": "https://x.com/Kstheeittgirl/status/2121837409361137811/photo/2",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJHupuWIAAhcOE.jpg",
              "expanded_url": "https://x.com/Kstheeittgirl/status/2121837409361137811/photo/3",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJHupaXEAACsPL.jpg",
              "expanded_url": "https://x.com/Kstheeittgirl/status/2121837409361137811/photo/4",
              "alt": null,
              "video_info": null
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121950754491523118",
          "url": "https://x.com/StephenM/status/2121950754491523118",
          "author": {
            "name": "Stephen Miller",
            "screen_name": "StephenM",
            "id": "1329891389430243330"
          },
          "created_at": "2026-11-15T12:57:38.000Z",
          "lang": "en",
          "text": "18 USC 241 and 242",
          "counts": {
            "bookmark_count": 977,
            "favorite_count": 26795,
            "quote_count": 250,
            "reply_count": 1751,
            "retweet_count": 5915
          },
          "views": "642366",
          "media": [],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121922724004254200",
          "url": "https://x.com/AboutMusicYT/status/2121922724004254200",
          "author": {
            "name": "About Music",
            "screen_name": "AboutMusicYT",
            "id": "1314159555127971840"
          },
          "created_at": "2026-11-15T11:06:15.000Z",
          "lang": "en",
          "text": "The kpop industry joins ILLIT and dances to It's Me together at the 2026 Melon Music Awards today. https://t.co/8LiPUH3p98",
          "counts": {
            "bookmark_count": 9158,
            "favorite_count": 93878,
            "quote_count": 4262,
            "reply_count": 518,
            "retweet_count": 19422
          },
          "views": "4784051",
          "media": [
            {
              "type": "video",
              "url": "https://pbs.twimg.com/amplify_video_thumb/2121922617229672448/img/cu9g5A9-2ydyewoJ.jpg",
              "expanded_url": "https://x.com/AboutMusicYT/status/2121922724004254200/video/1",
              "alt": null,
              "video_info": "https://video.twimg.com/amplify_video/2121922617229672448/vid/avc1/1094x666/u2g-mpBKARQvaM4N.mp4?tag=29"
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121896180078497830",
          "url": "https://x.com/Peller089/status/2121896180078497830",
          "author": {
            "name": "Peller",
            "screen_name": "Peller089",
            "id": "1737663959736504320"
          },
          "created_at": "2026-11-15T09:20:46.000Z",
          "lang": "en",
          "text": "Today, our hearts are fuller than ever. It’s a BOY! 🥹💙 Our little blessing, we can’t wait to hold you in our arms. ❤️ https://t.co/8ak8MMjvh3",
          "counts": {
            "bookmark_count": 1256,
            "favorite_count": 48847,
            "quote_count": 329,
            "reply_count": 1824,
            "retweet_count": 3713
          },
          "views": "1205258",
          "media": [
            {
              "type": "video",
              "url": "https://pbs.twimg.com/amplify_video_thumb/2121896020837588992/img/VdPVstbwomo7Yzhn.jpg",
              "expanded_url": "https://x.com/Peller089/status/2121896180078497830/video/1",
              "alt": null,
              "video_info": "https://video.twimg.com/amplify_video/2121896020837588992/vid/avc1/1080x1920/TYFYkuACDxaaxmwW.mp4?tag=29"
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121872304556929465",
          "url": "https://x.com/tmszhjh88/status/2121872304556929465",
          "author": {
            "name": "Kathleen",
            "screen_name": "tmszhjh88",
            "id": "1588432153880064001"
          },
          "created_at": "2026-11-15T07:45:54.000Z",
          "lang": "en",
          "text": "A dinosaur cat was discovered https://t.co/3M6WtO8rhY",
          "counts": {
            "bookmark_count": 6836,
            "favorite_count": 248916,
            "quote_count": 455,
            "reply_count": 613,
            "retweet_count": 20245
          },
          "views": "2298026",
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXJnl-BagAAeerF.jpg",
              "expanded_url": "https://x.com/tmszhjh88/status/2121872304556929465/photo/1",
              "alt": null,
              "video_info": null
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121812097244024942",
          "url": "https://x.com/techactually/status/2121812097244024942",
          "author": {
            "name": "Tech Actually",
            "screen_name": "techactually",
            "id": "1966816649279139841"
          },
          "created_at": "2026-11-15T03:46:40.000Z",
          "lang": "en",
          "text": "Instagram's entire UI evolution from 2010 to 2026 in one tweet. https://t.co/4sZb8oMQlR",
          "counts": {
            "bookmark_count": 9005,
            "favorite_count": 40392,
            "quote_count": 662,
            "reply_count": 315,
            "retweet_count": 4111
          },
          "views": "3005404",
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwqFqbYAAO5pi.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/1",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwrMNaMAAO91W.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/2",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwr5TbwAAQa-i.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/3",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIws1FbkAAWiap.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/4",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwti5aMAA0DF7.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/5",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwuaxa0AA1eYd.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/6",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwvn5aoAAGBuS.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/7",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwwUKaQAAE5Ed.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/8",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIww-NaEAAOj1A.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/9",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwxprb0AEZHme.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/10",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwyZhaAAAXVKE.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/11",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwzFMacAEw_vM.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/12",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIwzvxbYAAT48U.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/13",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIw0eMbcAEH4s2.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/14",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIw1LQbUAAqFIr.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/15",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIw11JbUAA26qd.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/16",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIw2jPa8AAI9ng.jpg",
              "expanded_url": "https://x.com/techactually/status/2121812097244024942/photo/17",
              "alt": null,
              "video_info": null
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121906835246510564",
          "url": "https://x.com/PollenMUFC/status/2121906835246510564",
          "author": {
            "name": "Pollen🔰🇿🇦",
            "screen_name": "PollenMUFC",
            "id": "1435692752134672388"
          },
          "created_at": "2026-11-15T10:03:07.000Z",
          "lang": "en",
          "text": "Me every time I see strangers beat cancer❤️🫂 https://t.co/yCApSjcCZT",
          "counts": {
            "bookmark_count": 2462,
            "favorite_count": 100930,
            "quote_count": 63,
            "reply_count": 52,
            "retweet_count": 11295
          },
          "views": "1249258",
          "media": [
            {
              "type": "video",
              "url": "https://pbs.twimg.com/ext_tw_video_thumb/1753243554137124864/pu/img/GTr75rCkjcvvoAR7.jpg",
              "expanded_url": "https://x.com/BulletClubIta/status/1753243598391308718/video/1",
              "alt": null,
              "video_info": "https://video.twimg.com/ext_tw_video/1753243554137124864/pu/vid/avc1/1280x720/Ww1rKidP66SvOnPs.mp4?tag=12"
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        },
        {
          "id": "2121860754089681295",
          "url": "https://x.com/FabrizioRomano/status/2121860754089681295",
          "author": {
            "name": "Fabrizio Romano",
            "screen_name": "FabrizioRomano",
            "id": "330262748"
          },
          "created_at": "2026-11-15T07:00:00.000Z",
          "lang": "en",
          "text": "❤️ Declan Rice: “My son is a huge fan of Lamine. I told him I was going to play against him, and he kept asking me why I was going to face Lamine!”.\n\n“But Lamine was really lovely to him, and as a father, I really appreciated that gesture. Such kindness”.\n\n“I know he has a younger brother he looks after, so I think it comes naturally to him. I was really touched by that gesture. It shows just how respectful and humble Lamine is”.",
          "counts": {
            "bookmark_count": 1614,
            "favorite_count": 96763,
            "quote_count": 191,
            "reply_count": 422,
            "retweet_count": 4708
          },
          "views": "3960091",
          "media": [
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIRwCNWwAASKAY.jpg",
              "expanded_url": "https://x.com/FabrizioRomano/status/2121860754089681295/photo/1",
              "alt": null,
              "video_info": null
            },
            {
              "type": "photo",
              "url": "https://pbs.twimg.com/media/HXIRwCNXIAAZJFI.jpg",
              "expanded_url": "https://x.com/FabrizioRomano/status/2121860754089681295/photo/2",
              "alt": null,
              "video_info": null
            }
          ],
          "card": null,
          "links": [],
          "quoted": null
        }
      ]
    }
  }
}

计费

当前配置下,每次成功请求消耗 1 积分。

每次成功请求包含空结果,均按当前数据库配置结算;失败不扣费。查询前必须有足够余额,并发结算时余额不足返回 402,不交付未结算结果。URL 解析不单独收费。

状态码与错误

HTTP含义
200成功(含空结果)
400JSON 或参数无效
401鉴权无效
402积分不足
429请求过于频繁,按 Retry-After 等待
502数据请求失败
503接口或价格未配置
{"code":"invalid_params","message":"Invalid parameter"}