Bookmarks

Save and manage bookmarked Posts for the authenticated user

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