POST https://xquik.com/api/v1/x/tweets/{id}/bookmark
10 credits per call · All plans from $0.00012/creditA write that must sign in to your X account first adds 10 credits. Xquik refunds them if the sign-in fails. A sign-in that works keeps them, even if X then refuses the write. See the X sign-in fee.
Idempotency-Key for the intended bookmark.
Store the returned write action and poll statusUrl when needed.
Bookmark one tweet by ID
Put the exact Tweet ID in the request path. Put the connected account username or ID in the body. That account saves the bookmark. Copy Tweet IDs as strings. JavaScript numbers cannot represent every X identifier exactly. This endpoint accepts 1 Tweet ID per request.Keep bookmarks private to the acting account
X shows a bookmark only to the account that saved it. The post’s author sees a bookmark count, never who saved it. Bookmarking never notifies the author or adds a like. Read the saved posts with Bookmarks.Save a bookmark receipt
Save the action first. Then update your reading list.Choose bookmark, like, or read bookmarks
Use Remove bookmark to reverse a bookmark.
Twitter bookmark API questions
Can an API bookmark a tweet by ID?
Yes. Send the Tweet ID in the path and the connected account in the body.Can other people see the bookmark?
No. X shows bookmarks only to the account that saved them. The author sees the total bookmark count on the post.Handle errors
Never infer failure from a client timeout. Poll a returned action before sending another request.- For
400, correct the Tweet ID or account value. - For
401, replace invalid Xquik authentication. - For
402, add credits before another request. - For
403, reconnect the selected X account. - For
409, keep the original action and payload. - For
422, review the X rejection before retrying. - For
429, wait forRetry-After. - For
500or503, followsafeToRetryandterminal.
Headers
Path parameters
Body
Response
Durable write recovery
- Store
id, the nestedhashinrequest,billing, andstatusUrl. - Poll after
Retry-AfterorpollAfterMswhenterminalisfalse. - Retry only when
safeToRetryistrue. - Use a new key when
nextAction.requiresNewIdempotencyKeyistrue.
200 terminal or 202 active
- After HTTP
200, store the result and settled billing. - After HTTP
202, poll the same action. Never submit another write. - After HTTP
400, fix the named field. Use a new idempotency key. - After HTTP
401, fix authentication. Do not retry unchanged. - After HTTP
402, fund the account before another write. - After HTTP
403, reconnect the account. - After HTTP
409, keep the original action. Use a new key for new input. - After HTTP
422, fix the rejected request before retrying. - After HTTP
429, wait forRetry-After. FollownextAction.
Response examples
200 example
202 example
- 400
{ "error": "missing_idempotency_key", "message": "Idempotency-Key is required. Generate one unique key for this write.", "charged": false, "chargedCredits": "0", "retryable": false, "safeToRetry": true } - 401
{ "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 404
{ "error": "account_not_found", "message": "X account not found. Connect it first at /dashboard/x-accounts." } - 409
{ "error": "idempotency_conflict", "message": "Idempotency-Key was already used with a different request.", "charged": false, "chargedCredits": "0", "retryable": false, "safeToRetry": true } - 422
{ "error": "x_rejected", "message": "X rejected this request. Check what you sent & the account on x.com before you try again." } - 429
{ "error": "x_rate_limited", "message": "X rate limited this account. Try again in about 15 minutes. Send fewer requests from this account." } - 500
{ "error": "x_write_failed", "message": "Write action failed unexpectedly. Contact support if this persists." } - 503
{ "error": "write_tracking_unavailable", "message": "Write tracking unavailable. Try again.", "charged": false, "chargedCredits": "0", "retryable": true, "safeToRetry": true }