Tweets

Returns your X account's bookmarks. Without your own connected X account, it answers 424 account_required. Without X Premium, a folder answers 424 bookmark_folders_unavailable.

get/api/v1/x/bookmarks

Request

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

Query parameters

folderIdstring

Optional bookmark folder ID. Folders need X Premium.

cursorstring
Example:DAACCgACGRElMJcAAA

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

Response

List of bookmarked tweets

filtered_countinteger

Whole number from 0.

has_next_pageboolean required
next_cursorstring required

Cursor for the next page. Send it unchanged.

readBackTostring date-time

How far back a filtered Latest search has read, in UTC. Xquik checked every newer post, 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

    • warning

      added the new topup_in_progress enum value to the ///// response property for the response status

    • warning

      added the new topup_in_progress enum value to the ////// response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the ////// response property for the response status

    • warning

      added the new topup_in_progress enum value to the /////// response property for the response status