メインコンテンツへスキップ
Bookmarks エンドポイントを使用すると、認証済みユーザーのブックマーク済み投稿を表示、追加、削除できます。ブックマークは非公開で、作成したユーザー本人にしか表示されません。

概要

ブックマークを表示

ブックマーク済みのすべての投稿を取得する

ブックマークを追加

ポストをブックマークに追加する

ブックマークを削除

ブックマーク済みポストをブックマークから削除する

ブックマークフォルダ

ブックマークをフォルダに整理する

エンドポイント

MethodEndpointDescription
GET/2/users/:id/bookmarksユーザーのブックマークを取得
POST/2/users/:id/bookmarksポストをブックマークする
DELETE/2/users/:id/bookmarks/:tweet_idブックマークを削除
GET/2/users/:id/bookmarks/foldersブックマークフォルダを取得
GET/2/users/:id/bookmarks/folders/:folder_idフォルダ内のポストを取得

例: ブックマークの取得

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

例: ブックマークを追加

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"}'

はじめに

前提条件

ルックアップ クイックスタート

ユーザーのブックマークを取得する

管理クイックスタート

ブックマークを追加・削除する

インテグレーションガイド

主要な概念とベストプラクティス

APIリファレンス

エンドポイントの詳細ドキュメント