Skip to main content
GET
/
x
/
bookmarks
Get bookmarks
curl --request GET \
  --url https://xquik.com/api/v1/x/bookmarks \
  --header 'x-api-key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page or ID list, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.
1 credit per result returned · All plans from $0.00012/credit
Requires a connected X account. Uses user-authenticated access.
curl -G https://xquik.com/api/v1/x/bookmarks \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

# Page 2
curl -G https://xquik.com/api/v1/x/bookmarks \
  --data-urlencode "cursor=abc123" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

​
Bookmarks handoff

Use GET /x/bookmarks when a reading list, CRM, research queue, or agent needs saved tweets from the authenticated account. The examples write JSON Lines rows with bookmark source, folder ID, tweet ID, tweet URL, text, author ID, username, display name, follower count, verified state, profile image URL, engagement counts, media URLs, and cursor fields. Store the last saved next_cursor per folder so each bookmark export can resume without duplicating earlier rows.

All saved tweets

Omit folderId when the workflow needs every bookmarked tweet visible to the connected account.

Folder export

Call Bookmark Folders first, then pass its folder_id as folderId.

Cursor checkpoint

Store has_next_page and next_cursor per folder. Pass next_cursor back as cursor only when has_next_page is true.

Account-scoped queue

Keep saved-tweet rows in account-scoped research, CRM, or agent memory systems.

​
Query parameters

​
folderId
string
Bookmark folder ID. Omit to return all bookmarks.
​
cursor
string
Pagination cursor. Pass the next_cursor value from the previous response to fetch the next page.

​
Which saved-feed endpoint?

Saved tweets

Use GET /x/bookmarks for bookmarked tweets from the connected account.

Bookmark folders

Use GET /x/bookmarks/folders to find folder IDs before a folder-specific bookmark export.

Home timeline

Use GET /x/timeline for the connected account’s home feed instead of saved tweets.

Notifications

Use GET /x/notifications for inbox activity rows from the connected account.

​
Headers

​
x-api-key
string
required
Your API key. Session cookie authentication is also supported.

​
Response

​
tweets
object[]
Array of bookmarked tweets.
​
has_next_page
boolean
Whether more results are available.
​
next_cursor
string
Opaque cursor for the next page. Empty string when no more results.
{
  "tweets": [
    {
      "id": "1893456789012345678",
      "text": "Bookmarked tweet content",
      "createdAt": "2026-02-24T10:00:00.000Z",
      "likeCount": 150,
      "retweetCount": 42,
      "replyCount": 10,
      "url": "https://x.com/user/status/1893456789012345678",
      "author": {
        "id": "44196397",
        "username": "elonmusk",
        "name": "Elon Musk",
        "followers": 150000000,
        "verified": true,
        "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAADDAABCgABF..."
}
Related: Bookmark Folders · Timeline
Last modified on May 25, 2026