Get bookmark folders

1 credit per call · All plans from $0.00012/credit

Requires a connected X account. Use folder IDs from this response with GET /x/bookmarks?folderId=... to read tweets saved inside a folder.

curl https://xquik.com/api/v1/x/bookmarks/folders \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

The Node.js and Python snippets shape durable bookmark folder rows instead of printing the full response page. Persist folderRows or folder_rows so a worker can pass folder_id into GET /x/bookmarks?folderId=....

Direct bookmark folder handoff

Use GET /x/bookmarks/folders when a saved-tweet workflow, CRM enrichment job, research queue, or agent needs the current bookmark folder IDs for the authenticated X account. Store folder_id and folder_name. The current route returns one folder page with has_next_page: false and next_cursor: ""; use each folder_id with Bookmarks to fetch the saved tweets inside that folder.

Headers

x-api-key

string

required

Your API key. Session cookie authentication is also supported.

Response

folders

object[]

Array of bookmark folders.

Show folder object

string

Folder ID.

name

string

Folder name.

has_next_page

boolean

Always false for the current bookmark folder route.

next_cursor

string

Always an empty string for the current bookmark folder route.

{
  "folders": [
    { "id": "1234567890", "name": "Tech" },
    { "id": "1234567891", "name": "Design" }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

{ "error": "unauthenticated" }

Missing or invalid API key.

{ "error": "no_subscription" }

No active subscription or insufficient credits. Possible error values: no_subscription, subscription_inactive, no_credits, insufficient_credits.

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

The API key, user, or plan tier is sending requests too quickly. Respect the Retry-After header before retrying.

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

{ "error": "x_api_unavailable" }

Returned when you opt into the normalized v1 response contract and the read service is unavailable.

Related: Bookmarks · Timeline

Documentation Index

​Direct bookmark folder handoff

​Headers

​Response

Direct bookmark folder handoff

Headers

Response