Skip to main content
GET
/
x
/
bookmarks
Get bookmarks
curl --request GET \
  --url https://api.example.com/x/bookmarks \
  --header 'x-api-key: <x-api-key>'
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

​
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.

​
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"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAADDAABCgABF..."
}
Related: Bookmark Folders · Timeline