Twitter bookmark folders API & saved tweet export

{
  "folders": [
    {
      "id": "1234567890",
      "media": {
        "originalImageUrl": "https://pbs.twimg.com/media/cover.jpg"
      },
      "name": "Read Later"
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

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

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

bookmarks

folders

Twitter bookmark folders API & saved tweet export

curl --request GET \
  --url https://xquik.com/api/v1/x/bookmarks/folders \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/x/bookmarks/folders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/bookmarks/folders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "folders": [
    {
      "id": "<string>",
      "name": "<string>",
      "media": {}
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

List Twitter bookmark folders for one connected account. Each row contains a folder ID and name for a saved tweet export. X documents bookmark folders as private, authenticated-user content.

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

The route reads bookmark folders through your connected X account. Without one, it returns 424 account_required. Use Connect X account to add one. When your connected X accounts are busy, it returns 503. Retry after the Retry-After delay. X shows bookmark folders only to X Premium accounts. For any other account, the route returns 424 bookmark_folders_unavailable, & a retry returns the same. Upgrade that account on X, or read all saved tweets with Bookmarks without folderId. 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

const response = await fetch("https://xquik.com/api/v1/x/bookmarks/folders", {
  headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
});
const data = await response.json();
const folderRows = data.folders.map((folder) => ({
  folder_id: folder.id,
  folder_name: folder.name,
  bookmarks_endpoint: `/x/bookmarks?folderId=${encodeURIComponent(folder.id)}`,
  has_more_folders: data.has_next_page,
}));

for (const row of folderRows) {
  process.stdout.write(`${JSON.stringify(row)}\n`);
}

import json
import requests

response = requests.get(
    "https://xquik.com/api/v1/x/bookmarks/folders",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
)
data = response.json()
folder_rows = [
    {
        "folder_id": folder["id"],
        "folder_name": folder["name"],
        "bookmarks_endpoint": f"/x/bookmarks?folderId={folder['id']}",
        "has_more_folders": data["has_next_page"],
    }
    for folder in data["folders"]
]

for row in folder_rows:
    print(json.dumps(row))

The Node.js and Python snippets build bookmark folder rows. They do not print the full response. Store folderRows or folder_rows. Then pass folder_id into GET /x/bookmarks?folderId=....

Direct bookmark folder handoff

Use GET /x/bookmarks/folders for an authenticated X account. It serves a saved-tweet workflow, CRM enrichment job, research queue, or agent. Store folder_id and folder_name with the connected account ID. The route returns one folder page. has_next_page stays false, and next_cursor stays empty. Use each folder ID with Bookmarks to fetch its saved tweets.

Twitter bookmark folder workflow

1. Discover existing folders

Call the route with the connected account’s Xquik API key. It lists that account’s private folders. It cannot create, rename, move, or delete folders. An empty folders array means the X Premium account has no folders.

2. Build a folder index

Use folder_id as the stable join key. Folder names can change or repeat. Protect folder names like saved tweets. Exclude them from public logs, URLs, and shared filenames.

3. Export saved tweets by folder

Pass each folder ID to GET /x/bookmarks?folderId=.... Saved tweet rows can include text, authors, likes, replies, reposts, views, media, and cursors. Write the folder ID beside every row to keep folder membership.

4. Resume and audit the export

The folder list has no next page. The bookmarked-tweet route paginates per folder. Store its next_cursor, collection time, and connected account ID.

Export Twitter bookmark folders

Every folder list is a snapshot for one account. Compare folder IDs with the preceding snapshot. Match renamed folders by ID. A missing ID only means the current snapshot omitted it. Keep prior exports until verification.

Store one checkpoint per folder

Store the folder ID, bookmark cursor, completion state, and collection time. Retry only the incomplete folder after 424, 429, or 502 responses. Upsert rows by account, folder, and tweet IDs. Save every row before advancing the cursor.

Define folder export records

Store account_id, folder_id, and folder_name beside each saved tweet. Keep tweet, author, engagement, media, and timestamp fields. Store source_cursor beside each page. Validate IDs before exporting to a spreadsheet, CRM, research queue, or storage system.

Twitter bookmark folder questions

Do Twitter bookmarks have folders?

Yes, for X Premium accounts. This endpoint lists the named folders visible to the connected account.

Can this API create or rename bookmark folders?

No. This route only reads folder IDs and names.

Can I access folders from mobile and desktop?

Yes. The endpoint works independently of the device. It returns folders available to the connected account.

How do I back up Twitter bookmark folders?

Save the folder index as JSON Lines or CSV. Export each folder’s saved tweets. Join both files by folder_id. Include the account ID and collection time.

What errors can stop a folder export?

A 401 response means the key cannot access the connected account. A 402 response requires more credits. Respect retry guidance in a 429 response. 424 account_required means you have no connected X account. 424 bookmark_folders_unavailable means the account has no X Premium. Retry other 424, 502 & 503 read failures later.

Query parameters

string

Pass next_cursor from the previous page. Omit it for the first page.

Headers

string

required

Your API key. Session cookie authentication is also supported.

Response

200 OK

object[]

Array of bookmark folders. Folder object fields.

string

This value contains the folder ID.

string

This value contains the folder name.

object

Public folder cover image metadata. Omitted if unavailable.

boolean

Always false for the bookmark folder route.

string

Always an empty string for the bookmark folder route.

Related. Bookmarks · Timeline

{
  "folders": [
    {
      "id": "1234567890",
      "media": {
        "originalImageUrl": "https://pbs.twimg.com/media/cover.jpg"
      },
      "name": "Read Later"
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

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

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Twitter bookmark folders API & saved tweet export

curl --request GET \
  --url https://xquik.com/api/v1/x/bookmarks/folders \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/x/bookmarks/folders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/bookmarks/folders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "folders": [
    {
      "id": "<string>",
      "name": "<string>",
      "media": {}
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Twitter bookmark folders API & saved tweet export

Direct bookmark folder handoff

Twitter bookmark folder workflow

1. Discover existing folders

2. Build a folder index

3. Export saved tweets by folder

4. Resume and audit the export

Export Twitter bookmark folders

Store one checkpoint per folder

Define folder export records

Twitter bookmark folder questions

Do Twitter bookmarks have folders?

Can this API create or rename bookmark folders?

Can I access folders from mobile and desktop?

How do I back up Twitter bookmark folders?

What errors can stop a folder export?

Query parameters

Headers

Response

200 OK

​Direct bookmark folder handoff

​Twitter bookmark folder workflow

​1. Discover existing folders

​2. Build a folder index

​3. Export saved tweets by folder

​4. Resume and audit the export

​Export Twitter bookmark folders

​Store one checkpoint per folder

​Define folder export records

​Twitter bookmark folder questions

​Do Twitter bookmarks have folders?

​Can this API create or rename bookmark folders?

​Can I access folders from mobile and desktop?

​How do I back up Twitter bookmark folders?

​What errors can stop a folder export?

​Query parameters

​Headers

​Response

​200 OK

Direct bookmark folder handoff

Twitter bookmark folder workflow

1. Discover existing folders

2. Build a folder index

3. Export saved tweets by folder

4. Resume and audit the export

Export Twitter bookmark folders

Store one checkpoint per folder

Define folder export records

Twitter bookmark folder questions

Do Twitter bookmarks have folders?

Can this API create or rename bookmark folders?

Can I access folders from mobile and desktop?

How do I back up Twitter bookmark folders?

What errors can stop a folder export?

Query parameters

Headers

Response

200 OK