Bookmarks

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

Method	Endpoint	Description
GET	`/2/users/:id/bookmarks`	Get user’s bookmarks
POST	`/2/users/:id/bookmarks`	Bookmark a Post
DELETE	`/2/users/:id/bookmarks/:tweet_id`	Remove a bookmark
GET	`/2/users/:id/bookmarks/folders`	Get bookmark folders
GET	`/2/users/:id/bookmarks/folders/:folder_id`	Get 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

An approved developer account
A Project and App in the Developer Console
User Access Tokens via OAuth 2.0 PKCE or 3-legged OAuth

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

Get Post by ID

Bookmarks Lookup

​Overview