Get bookmarks

POST/twitter/bookmarks_v2

The account's own bookmarks. Paginated: use cursor / next_cursor.

Price: $0.0006 per request.

Request body

Send as application/json.

login_cookiesstringrequired
The login_cookies value returned by Log in to an X account. Send the same value with every action for that account.
proxystringrequired
Proxy for this X account, in the form scheme://user:pass@host:port where scheme is http, https, socks5 or socks4. Use the same proxy for every request of the account. Must be a public address; a residential proxy is recommended.
countinteger
Number of items per page.
cursorstring
Pagination cursor. Leave empty for the first page, then pass next_cursor from the previous response.

Example request

curl -X POST "https://api.cheapxapi.com/twitter/bookmarks_v2" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "login_cookies": "<login_cookies>",
    "proxy": "<proxy>"
  }'

Response

Charged. "status": "success" means the action was done; "status": "error" means X rejected it and message says why.

Field	Type
`tweets`	array of Tweet
`type`	"tweet"
`id`	string
`url`	string
`text`	string
`source`	string
`retweetCount`	integer
`replyCount`	integer
`likeCount`	integer
`quoteCount`	integer
`viewCount`	integer
`createdAt`	string
`lang`	string
`bookmarkCount`	integer
`isReply`	boolean
`inReplyToId`	string
`conversationId`	string
`displayTextRange`	array of integer
`inReplyToUserId`	string
`inReplyToUsername`	string
`author`	UserInfo
`entities`	TweetEntities
`quoted_tweet`	Tweet
`retweeted_tweet`	Tweet
`isLimitedReply`	boolean
`has_next_page`	boolean
`next_cursor`	string

Status codes

200: Charged. "status": "success" means the action was done; "status": "error" means X rejected it and message says why.
400: Missing or invalid fields (not charged). The message names the field; your values are never echoed back.
401: Missing or invalid API key (not charged).
402: Insufficient balance (not charged).
405: Wrong HTTP method (not charged).
413: Request body too large (not charged).
429: Rate limit exceeded, including the per-X-account and login limits (not charged). Retry after the time in the Retry-After header.
503: Temporary service problem (not charged). If it says the request timed out, the action may already have been applied on X: check before retrying.