Export Twitter bookmarks with Twitter bookmarks API

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

# Page 2
curl -G https://xquik.com/api/v1/x/bookmarks \
  --data-urlencode "cursor=abc123" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

const bookmarkFolderId = ""; // Set to a folder ID to export one folder.
const baseUrl = "https://xquik.com/api/v1/x/bookmarks";
let pageCursor = "";

for (let pageIndex = 0; pageIndex < 3; pageIndex += 1) {
  const params = new URLSearchParams();
  if (bookmarkFolderId !== "") params.set("folderId", bookmarkFolderId);
  if (pageCursor !== "") params.set("cursor", pageCursor);

  const query = params.toString();
  const response = await fetch(query === "" ? baseUrl : `${baseUrl}?${query}`, {
    headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
  });
  const page = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(page));

  const bookmarkRows = page.tweets.map((tweet) => ({
    bookmark_source: bookmarkFolderId === "" ? "all_bookmarks" : "folder",
    folder_id: bookmarkFolderId || null,
    tweet_id: tweet.id,
    tweet_url: tweet.url ?? null,
    text: tweet.text,
    author_id: tweet.author?.id ?? null,
    author_username: tweet.author?.username ?? null,
    author_name: tweet.author?.name ?? null,
    author_followers: tweet.author?.followers ?? null,
    author_verified: tweet.author?.verified ?? null,
    author_profile_picture: tweet.author?.profilePicture ?? null,
    created_at: tweet.createdAt ?? null,
    like_count: tweet.likeCount ?? null,
    reply_count: tweet.replyCount ?? null,
    retweet_count: tweet.retweetCount ?? null,
    quote_count: tweet.quoteCount ?? null,
    view_count: tweet.viewCount ?? null,
    media_urls: (tweet.media ?? []).map((item) => item.mediaUrl).filter(Boolean),
    page_index: pageIndex,
    page_cursor: pageCursor,
    next_cursor: page.next_cursor,
    has_next_page: page.has_next_page,
  }));
  for (const row of bookmarkRows) process.stdout.write(`${JSON.stringify(row)}\n`);

  if (!page.has_next_page || page.next_cursor === "") break;
  pageCursor = page.next_cursor;
}

import json
import requests

bookmark_folder_id = ""  # Set to a folder ID to export one folder.
page_cursor = ""

for page_index in range(3):
    params = {}
    if bookmark_folder_id:
        params["folderId"] = bookmark_folder_id
    if page_cursor:
        params["cursor"] = page_cursor

    response = requests.get(
        "https://xquik.com/api/v1/x/bookmarks",
        params=params,
        headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    )
    page = response.json()
    if not response.ok:
        raise RuntimeError(page)

    for tweet in page["tweets"]:
        bookmark_row = {
            "bookmark_source": "all_bookmarks" if not bookmark_folder_id else "folder",
            "folder_id": bookmark_folder_id or None,
            "tweet_id": tweet["id"],
            "tweet_url": tweet.get("url"),
            "text": tweet["text"],
            "author_id": (tweet.get("author") or {}).get("id"),
            "author_username": (tweet.get("author") or {}).get("username"),
            "author_name": (tweet.get("author") or {}).get("name"),
            "author_followers": (tweet.get("author") or {}).get("followers"),
            "author_verified": (tweet.get("author") or {}).get("verified"),
            "author_profile_picture": (tweet.get("author") or {}).get("profilePicture"),
            "created_at": tweet.get("createdAt"),
            "like_count": tweet.get("likeCount"),
            "reply_count": tweet.get("replyCount"),
            "retweet_count": tweet.get("retweetCount"),
            "quote_count": tweet.get("quoteCount"),
            "view_count": tweet.get("viewCount"),
            "media_urls": [
                item["mediaUrl"] for item in tweet.get("media", []) if item.get("mediaUrl")
            ],
            "page_index": page_index,
            "page_cursor": page_cursor,
            "next_cursor": page["next_cursor"],
            "has_next_page": page["has_next_page"],
        }
        print(json.dumps(bookmark_row, separators=(",", ":")))

    if not page["has_next_page"] or not page["next_cursor"]:
        break
    page_cursor = page["next_cursor"]