ブックマークの管理

X API を使用してブックマークを追加および削除します

このガイドでは、X API を使用してブックマークを追加および削除する方法を説明します。

前提条件

作業を始める前に、次のものが必要です。

• 承認された App を持つ 開発者アカウント
• bookmark.write スコープを持つユーザーアクセストークン (OAuth 2.0 PKCE)

---

​

ブックマークを追加する

1. ユーザーIDを取得する

   認証済みユーザーのIDが必要です。/2/users/me エンドポイント、または ユーザー lookup エンドポイントを使って取得できます。

2. ポストIDを取得する

   ポストを表示しているときのURLからポストIDを確認します：

   https://x.com/XDevelopers/status/1460323737035677698
                                   └── これがポストIDです
   
3. ブックマークを追加する

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/users/2244994945/bookmarks" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"tweet_id": "1460323737035677698"}'
   
4. レスポンスを確認する

   {
     "data": {
       "bookmarked": true
     }
   }
   

---

​

ブックマークを削除する

ブックマークからポストを削除するには、次のようにします:

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

レスポンス:

{
  "data": {
    "bookmarked": false
  }
}

---

​

必要なスコープ

OAuth 2.0 PKCE を使用する場合、アクセストークンには次のスコープが必要です。

Scope	Description
bookmark.write	ブックマークの追加と削除
tweet.read	ポストのデータの読み取り
users.read	ユーザーデータの読み取り

---

​

次のステップ

ブックマークの取得

ブックマークした投稿を取得

APIリファレンス

エンドポイントの完全なドキュメント