Get User Likes API

Fetch a Twitter user's liked tweets via API. $0.001 per call, ~20 tweets per call — just $0.05 per 1,000 tweets. GetXAPI user likes endpoint.

POST/twitter/user/likes

This endpoint costs $0.001 per API call and returns ~20 tweets 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`.
`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.
Fetches the user's own liked tweets.
Pagination uses next_cursor until has_more is false.

Response (200)

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

Error Responses

400 - Missing auth_token

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

401 - Invalid auth_token

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

Example

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

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

User Likes