Manage Bookmarks

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

前提条件始める前に以下が必要です:

承認済みの App を含む開発者アカウント
bookmark.write スコープを持つユーザーアクセストークン(OAuth 2.0 PKCE)

ブックマークを追加する

ユーザー ID を取得する

認証済みユーザーの ID が必要です。/2/users/me エンドポイントまたはユーザールックアップエンドポイントで確認できます。

投稿 ID を取得する

投稿を表示している URL から投稿 ID を見つけます:

https://x.com/XDevelopers/status/1460323737035677698
                                └── これが投稿 ID

ブックマークを追加する

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# ブックマークを追加
response = client.bookmarks.create(
    user_id="2244994945",
    tweet_id="1460323737035677698"
)

print(f"Bookmarked: {response.data.bookmarked}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// ブックマークを追加
const response = await client.bookmarks.create("2244994945", {
  tweetId: "1460323737035677698",
});

console.log(`Bookmarked: ${response.data?.bookmarked}`);

レスポンスを確認する

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

ブックマークを削除する

投稿をブックマークから削除します:

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# ブックマークを削除
response = client.bookmarks.delete(
    user_id="2244994945",
    tweet_id="1460323737035677698"
)

print(f"Bookmarked: {response.data.bookmarked}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// ブックマークを削除
const response = await client.bookmarks.delete("2244994945", "1460323737035677698");

console.log(`Bookmarked: ${response.data?.bookmarked}`);

レスポンス:

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

必要なスコープ

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

Scope	Description
`bookmark.write`	ブックマークの追加と削除
`tweet.read`	投稿データを読み取り
`users.read`	ユーザーデータを読み取り

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Manage Bookmarks

ブックマークを追加する

ブックマークを削除する

必要なスコープ

次のステップ

ブックマークルックアップ

API リファレンス

​ブックマークを追加する

​ブックマークを削除する

​必要なスコープ

​次のステップ

ブックマークルックアップ

API リファレンス

ブックマークを追加する

ブックマークを削除する

必要なスコープ

次のステップ