Search Twitter Bookmarks API

Search inside a user's Twitter bookmarks via API. $0.001 per call, ~20 results per call. GetXAPI bookmark search endpoint documentation.

POST/twitter/user/bookmark_search

This endpoint costs $0.001 per API call and returns ~20 results per page.

Request Body

Field	Type	Required	Description
`auth_token`	string	Yes	User's auth token
`ct0`	string	No	Optional current CSRF token cookie. When provided with `twid`, skips server-side credential resolution.
`twid`	string	No	Optional current user ID cookie, for example `u=1234567890`. Must be provided with `ct0`.
`q`	string	Yes	Search query
`cursor`	string	No	Pagination cursor
`proxy`	string	No	Proxy URL (`http://`, `https://`, `socks5://`, or `socks4://`)

Notes

If you already have current ct0 and twid, send both to skip the extra server-side credential bootstrap from auth_token. If either one is omitted, the server resolves them from auth_token as before. Stale or invalid supplied values are not validated upfront and may fail on the actual Twitter action instead of returning an early 401.
Searches your bookmarks.
Pagination uses next_cursor until has_more is false.

Response (200)

{
  "userId": "1858475867762270208",
  "query": "claude",
  "tweet_count": 20,
  "has_more": true,
  "next_cursor": "DAAHCgABHAY...",
  "bookmarks": [
    {
      "type": "tweet",
      "id": "2010705621524292007",
      "text": "Hello from GetXAPI.",
      "author": {
        "userName": "example_user"
      }
    }
  ]
}

Error Responses

400 - Missing fields

{
  "error": "Missing required field: q"
}

401 - Invalid auth_token

{
  "error": "Invalid auth_token - could not extract userId"
}

Example

curl -X POST "https://api.getxapi.com/twitter/user/bookmark_search" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "your_auth_token",
    "q": "claude"
  }'

# With pagination
curl -X POST "https://api.getxapi.com/twitter/user/bookmark_search" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "your_auth_token",
    "q": "claude",
    "cursor": "DAAHCgABHAY..."
  }'

Bookmark Search