Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

The Bookmarks endpoints let you view, add, and remove bookmarked Posts for the authenticated user. Bookmarks are private and only visible to the user who created them.

​
Overview

View bookmarks

Get all bookmarked Posts

Add bookmark

Bookmark a Post

Remove bookmark

Remove a bookmarked Post

Bookmark folders

Organize bookmarks into folders

​
Endpoints

MethodEndpointDescription
GET/2/users/:id/bookmarksGet user’s bookmarks
POST/2/users/:id/bookmarksBookmark a Post
DELETE/2/users/:id/bookmarks/:tweet_idRemove a bookmark
GET/2/users/:id/bookmarks/foldersGet bookmark folders
GET/2/users/:id/bookmarks/folders/:folder_idGet Posts in a folder

​
Example: Get bookmarks

curl "https://api.x.com/2/users/123456789/bookmarks?\
tweet.fields=created_at,author_id,public_metrics" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​
Example: Add bookmark

curl -X POST "https://api.x.com/2/users/123456789/bookmarks" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'

​
Getting started

Prerequisites

Lookup quickstart

Get a user’s bookmarks

Manage quickstart

Add and remove bookmarks

Integration guide

Key concepts and best practices

API Reference

Full endpoint documentation