Sign in
Tweets

List the top tweets on X by likes, replies or views

Changed on

Returns the tweets X ranks highest by one metric over the last day, week or month, as x.com's Inspiration page shows them. Covers all of X unless you pick a country or a language. Pages hold up to 20 tweets, and the list ends at 100. Each tweet costs 1 credit.

get/api/v1/x/tweets/top

Request

  • Base URL: https://xquik.com
  • URL: https://xquik.com/api/v1/x/tweets/top
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer
    • none

Query parameters

metric'likes' | 'replies' | 'quotes' | 'bookmarks' | 'shares' | 'views'
Example:likes

What to rank tweets by. Defaults to likes. Singular names work too, such as like.

window'day' | 'week' | 'month'
Example:day

How far back to look. Defaults to day. Also takes 24h, 7d, 30d, daily, weekly and monthly.

countrystring
Example:US

Only tweets from one country, as a 2- or 3-letter ISO 3166 code, such as US or USA. Send country or language, not both.

languagestring
Example:en

Only tweets in one language, as a 2-letter code, such as en. Send country or language, not both.

cursorstring

Pagination cursor for collection results. Also read as next_cursor, next_token, pagination_token or continuation_token.

pageSizeinteger

Items per page (1-100, default 20). Source, filters or credits can return fewer. Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems, max_items & per_page.

Response

Top tweets

filtered_countinteger

Whole number from 0.

has_next_pageboolean required
next_cursorstring required
readBackTostring date-time

How far back a filtered Latest search has read, in UTC. Every newer post was checked, so an empty page still moves this time back.

windowCompletetrue

Present on a last page whose sources all read past its start time.

searchedQuerystring

Search q as X ran it, when Xquik fixed it.

Example response

{
  "tweets": [
    {
      "id": "2102761519985332442",
      "text": "This galaxy is a little extra.\n\nMeet Messier 106, a spiral galaxy with an extra set of arms. These two additional arms are made of gas heated up by jets from the galaxy’s central black hole. The jets’ superheated shockwaves are depicted in royal blue by @chandraxray. https://t.co/421Lzs0r0c",
      "retweetCount": 1364,
      "replyCount": 271,
      "likeCount": 9775,
      "quoteCount": 85,
      "viewCount": 962488,
      "bookmarkCount": 599,
      "conversationId": "2102761519985332442",
      "contentDisclosure": {
        "aiGenerated": {
          "hasAiGeneratedMedia": false
        }
      },
      "displayTextRange": [
        0,
        267
      ],
      "edit": {
        "editableUntilMsecs": "1790175988000",
        "editTweetIds": [
          "2102761519985332442"
        ]
      },
      "entities": {
        "hashtags": [],
        "urls": [],
        "user_mentions": [
          {
            "id_str": "12415722",
            "indices": [
              254,
              266
            ],
            "name": "Chandra Observatory",
            "screen_name": "chandraxray"
          }
        ]
      },
      "isNoteTweet": false,
      "isPinned": false,
      "isQuoteStatus": false,
      "isReply": false,
      "isRetweet": false,
      "isTranslatable": false,
      "lang": "en",
      "possiblySensitive": false,
      "source": "<a href=\"https://www.sprinklr.com\" rel=\"nofollow\">Sprinklr</a>",
      "type": "tweet",
      "url": "https://x.com/NASA/status/2102761519985332442",
      "viewState": "EnabledWithCount",
      "createdAt": "Wed Sep 23 14:06:28 +0000 2026",
      "media": [
        {
          "altText": "A spiral galaxy, laying diagonally at a three-quarters profile view. Its center is a luminous yellow that stretches out into a pinwheel of wispy blue and red arms. The disc itself is decorated with a smattering of stars and dark dust.",
          "availabilityStatus": "Available",
          "displayUrl": "pic.x.com/421Lzs0r0c",
          "expandedUrl": "https://x.com/NASA/status/2102761519985332442/photo/1",
          "focusRects": [
            {
              "h": 1146,
              "w": 2047,
              "x": 0,
              "y": 419
            },
            {
              "h": 1565,
              "w": 1565,
              "x": 0,
              "y": 0
            },
            {
              "h": 1565,
              "w": 1373,
              "x": 0,
              "y": 0
            },
            {
              "h": 1565,
              "w": 783,
              "x": 0,
              "y": 0
            },
            {
              "h": 1565,
              "w": 2047,
              "x": 0,
              "y": 0
            }
          ],
          "height": 1565,
          "id": "2102761515958833152",
          "indices": [
            268,
            291
          ],
          "mediaKey": "3_2102761515958833152",
          "mediaUrl": "https://pbs.twimg.com/media/HS6CdTYWkAAp0e1.jpg",
          "sizes": {
            "large": {
              "h": 1565,
              "resize": "fit",
              "w": 2047
            },
            "medium": {
              "h": 917,
              "resize": "fit",
              "w": 1200
            },
            "small": {
              "h": 520,
              "resize": "fit",
              "w": 680
            },
            "thumb": {
              "h": 150,
              "resize": "crop",
              "w": 150
            }
          },
          "type": "photo",
          "url": "https://t.co/421Lzs0r0c",
          "width": 2047
        }
      ],
      "author": {
        "id": "11348282",
        "username": "NASA",
        "name": "NASA",
        "followers": 92376233,
        "following": 115,
        "verified": true,
        "isBlueVerified": true,
        "isVerified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg",
        "coverPicture": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
        "profileBannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
        "description": "Making the seemingly impossible, possible. ✨",
        "location": "Pale Blue Dot",
        "createdAt": "Wed Dec 19 20:20:32 +0000 2007",
        "statusesCount": 74336,
        "mediaCount": 28160,
        "protected": false,
        "url": "http://www.nasa.gov/",
        "favouritesCount": 17003,
        "isTranslator": false,
        "possiblySensitive": false,
        "verifiedType": "Government",
        "profile_bio": {
          "description": "Making the seemingly impossible, possible. ✨",
          "entities": {
            "description": {},
            "url": {
              "urls": [
                {
                  "display_url": "nasa.gov",
                  "expanded_url": "http://www.nasa.gov/",
                  "indices": [
                    0,
                    23
                  ],
                  "url": "https://t.co/9NkQJKAnuU"
                }
              ]
            }
          }
        },
        "hasGraduatedAccess": true,
        "parodyCommentaryFanLabel": "None",
        "profileDescriptionLanguage": "en",
        "profileImageShape": "Square",
        "profileTranslatorType": "regular",
        "superFollowEligible": false
      }
    },
    {
      "id": "2102425682286412261",
      "text": "Sept. 22 marks the fall equinox. That means day and night are nearly equal in length around the world, and in the Northern Hemisphere, fall begins. In the Southern Hemisphere, spring begins on this day. https://t.co/laEQ0JajuN",
      "retweetCount": 1258,
      "replyCount": 200,
      "likeCount": 7566,
      "quoteCount": 98,
      "viewCount": 961825,
      "bookmarkCount": 322,
      "conversationId": "2102425682286412261",
      "contentDisclosure": {
        "aiGenerated": {
          "hasAiGeneratedMedia": false
        }
      },
      "displayTextRange": [
        0,
        202
      ],
      "edit": {
        "editableUntilMsecs": "1790095918000",
        "editTweetIds": [
          "2102425682286412261"
        ]
      },
      "entities": {
        "hashtags": [],
        "urls": [],
        "user_mentions": []
      },
      "isNoteTweet": false,
      "isPinned": false,
      "isQuoteStatus": false,
      "isReply": false,
      "isRetweet": false,
      "isTranslatable": false,
      "lang": "en",
      "possiblySensitive": false,
      "source": "<a href=\"https://www.sprinklr.com\" rel=\"nofollow\">Sprinklr</a>",
      "type": "tweet",
      "url": "https://x.com/NASA/status/2102425682286412261",
      "viewState": "EnabledWithCount",
      "createdAt": "Tue Sep 22 15:51:58 +0000 2026",
      "media": [
        {
          "altText": "A satellite's-eye view from October 2022 of the Adirondack Mountains of northeast New York during fall. The leaves on trees are a fiery orange and red. Some trees remain green. White fluffy clouds are visible at the edges of the image.",
          "availabilityStatus": "Available",
          "displayUrl": "pic.x.com/laEQ0JajuN",
          "expandedUrl": "https://x.com/NASA/status/2102425682286412261/photo/1",
          "focusRects": [
            {
              "h": 1801,
              "w": 3216,
              "x": 0,
              "y": 1187
            },
            {
              "h": 2988,
              "w": 2988,
              "x": 0,
              "y": 0
            },
            {
              "h": 2988,
              "w": 2621,
              "x": 0,
              "y": 0
            },
            {
              "h": 2988,
              "w": 1494,
              "x": 0,
              "y": 0
            },
            {
              "h": 2988,
              "w": 3216,
              "x": 0,
              "y": 0
            }
          ],
          "height": 2988,
          "id": "2102425671280553984",
          "indices": [
            203,
            226
          ],
          "mediaKey": "3_2102425671280553984",
          "mediaUrl": "https://pbs.twimg.com/media/HS1RAkdW8AAY1Mp.jpg",
          "sizes": {
            "large": {
              "h": 1903,
              "resize": "fit",
              "w": 2048
            },
            "medium": {
              "h": 1115,
              "resize": "fit",
              "w": 1200
            },
            "small": {
              "h": 632,
              "resize": "fit",
              "w": 680
            },
            "thumb": {
              "h": 150,
              "resize": "crop",
              "w": 150
            }
          },
          "type": "photo",
          "url": "https://t.co/laEQ0JajuN",
          "width": 3216
        }
      ],
      "author": {
        "id": "11348282",
        "username": "NASA",
        "name": "NASA",
        "followers": 92376233,
        "following": 115,
        "verified": true,
        "isBlueVerified": true,
        "isVerified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg",
        "coverPicture": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
        "profileBannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
        "description": "Making the seemingly impossible, possible. ✨",
        "location": "Pale Blue Dot",
        "createdAt": "Wed Dec 19 20:20:32 +0000 2007",
        "statusesCount": 74336,
        "mediaCount": 28160,
        "protected": false,
        "url": "http://www.nasa.gov/",
        "favouritesCount": 17003,
        "isTranslator": false,
        "possiblySensitive": false,
        "verifiedType": "Government",
        "profile_bio": {
          "description": "Making the seemingly impossible, possible. ✨",
          "entities": {
            "description": {},
            "url": {
              "urls": [
                {
                  "display_url": "nasa.gov",
                  "expanded_url": "http://www.nasa.gov/",
                  "indices": [
                    0,
                    23
                  ],
                  "url": "https://t.co/9NkQJKAnuU"
                }
              ]
            }
          }
        },
        "hasGraduatedAccess": true,
        "parodyCommentaryFanLabel": "None",
        "profileDescriptionLanguage": "en",
        "profileImageShape": "Square",
        "profileTranslatorType": "regular",
        "superFollowEligible": false
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAAHCgABHTK6Vr___-sLAAIAAAATMjEwMTc3MDE4NjE1NjA1Mjk1OQgAAwAAAAIAAA",
  "filtered_count": 0
}

Changes

Of the 52 revisions, 1 has no diff computed.