API Documentation

Twitter / X Trending Search API

Read a trending search timeline with optional tag and timeFilter; not general keyword search.

Test API

Read a trending search timeline with optional tag and timeFilter; not general keyword search.

Open product page and API Tester

Endpoint and authentication

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

Results return synchronously, without tasks or polling. Authenticate using Authorization: Bearer YOUR_API_KEY and send a JSON request body. There are no Path or Query parameters.

Input parameters

Returns up to 20 records per request; actual results may be fewer. Pagination is not supported. Do not send count, page_size or cursor.

ParameterLocationTypeRequiredDefaultConstraints and meaning
AuthorizationHeaderstringYes—Bearer YOUR_API_KEY
Content-TypeHeaderstringYesapplication/jsonapplication/json
tagJSON bodystringNo—Optional trending tag. This endpoint returns a trending search timeline, not general keyword search. maxLength=2048
timeFilterJSON bodystringNo—Optional time filter string; passed as supplied. No enum or default is specified. maxLength=2048

timeFilter is an optional string, without an enum or an unspecified default. This endpoint is not general keyword search.

Request example

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

{}

Output fields

Success returns HTTP 200. Business results are in data.result. Null, empty strings, empty arrays and missing business fields are preserved; zero is a valid statistic. Empty display fields do not invalidate an otherwise successful request.

FieldTypeMeaning
codestringok on success; error code otherwise
messagestringStatus message
data.resultobject / nullBusiness data; null is preserved
data.creditsUsedintegerCredits charged using current configuration
data.remainingCreditsnumberBalance after settlement
data.result.tweetsarrayRecords in this response
data.result.tweets[].authorobjectPublic business field; may be null, empty or absent
data.result.tweets[].author.namestringPublic business field; may be null, empty or absent
data.result.tweets[].author.screen_namestringPublic business field; may be null, empty or absent
data.result.tweets[].author.idstringPublic business field; may be null, empty or absent
data.result.tweets[].urlstringPublic business field; may be null, empty or absent
data.result.tweets[].created_atstringPublic business field; may be null, empty or absent
data.result.tweets[].viewsstringPublic business field; may be null, empty or absent
data.result.tweets[].textstringPublic business field; may be null, empty or absent
data.result.tweets[].countsobjectPublic business field; may be null, empty or absent
data.result.tweets[].counts.bookmark_countintegerPublic business field; may be null, empty or absent
data.result.tweets[].counts.favorite_countintegerPublic business field; may be null, empty or absent
data.result.tweets[].counts.quote_countintegerPublic business field; may be null, empty or absent
data.result.tweets[].counts.retweet_countintegerPublic business field; may be null, empty or absent
data.result.tweets[].counts.reply_countintegerPublic business field; may be null, empty or absent
data.result.tweets[].cardobjectPublic business field; may be null, empty or absent
data.result.tweets[].card.namestringPublic business field; may be null, empty or absent
data.result.tweets[].card.titlestringPublic business field; may be null, empty or absent
data.result.tweets[].card.imageobjectPublic business field; may be null, empty or absent
data.result.tweets[].card.image.altstringPublic business field; may be null, empty or absent
data.result.tweets[].card.image.urlstringPublic business field; may be null, empty or absent
data.result.tweets[].card.image.widthintegerPublic business field; may be null, empty or absent
data.result.tweets[].card.image.heightintegerPublic business field; may be null, empty or absent
data.result.tweets[].card.urlstringPublic business field; may be null, empty or absent
data.result.tweets[].card.domainstringPublic business field; may be null, empty or absent
data.result.tweets[].card.descriptionstringPublic business field; may be null, empty or absent
data.result.tweets[].quotednull (observed)Public business field; may be null, empty or absent
data.result.tweets[].mediaarrayPublic business field; may be null, empty or absent
data.result.tweets[].media[].typestringPublic business field; may be null, empty or absent
data.result.tweets[].media[].urlstringPublic business field; may be null, empty or absent
data.result.tweets[].media[].expanded_urlstringPublic business field; may be null, empty or absent
data.result.tweets[].media[].altstringPublic business field; may be null, empty or absent
data.result.tweets[].media[].video_infostringPublic business field; may be null, empty or absent
data.result.tweets[].langstringPublic business field; may be null, empty or absent
data.result.tweets[].linksarrayPublic business field; may be null, empty or absent
data.result.tweets[].links[].displaynull (observed)Public business field; may be null, empty or absent
data.result.tweets[].links[].tconull (observed)Public business field; may be null, empty or absent
data.result.tweets[].links[].expandedstringPublic business field; may be null, empty or absent
data.result.tweets[].idstringPublic business field; may be null, empty or absent

This endpoint has no pagination parameters.

Real response example

Saved from a real successful response with public business fields. The example omits live data.creditsUsed and data.remainingCredits, which use current configuration and account balance. No list records are omitted. Media URLs may expire. Displaying the example sends no request or charge.

{
  "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
        }
      ]
    }
  }
}

Billing

With the current configuration, each successful request costs 1 credit.

Every successful request, including empty results, is settled at the current database-configured rate. Failures are free. Sufficient balance is required before querying; insufficient balance during concurrent settlement returns 402 without delivering unsettled results. URL parsing adds no separate charge.

Status codes and errors

HTTPMeaning
200Success, including empty results
400Invalid JSON or parameters
401Invalid authentication
402Insufficient credits
429Rate limit; wait for Retry-After
502Data request failed
503API or pricing not configured
{"code":"invalid_params","message":"Invalid parameter"}