> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Manage Bookmarks
> このガイドでは、X API を使用してブックマークを追加および削除する方法を説明します。クイックスタートを扱う X API v2 スタンダードティアのリファレンス。
export const Button = ({href, children}) => {
return ;
};
このガイドでは、X API を使用してブックマークを追加および削除する方法を説明します。
**前提条件**
始める前に以下が必要です:
* 承認済みの App を含む[開発者アカウント](https://developer.x.com/en/portal/petition/essential/basic-info)
* `bookmark.write` スコープを持つユーザーアクセストークン(OAuth 2.0 PKCE)
***
## ブックマークを追加する
認証済みユーザーの ID が必要です。`/2/users/me` エンドポイントまたは[ユーザールックアップエンドポイント](/x-api/users/lookup/introduction)で確認できます。
投稿を表示している URL から投稿 ID を見つけます:
```
https://x.com/XDevelopers/status/1460323737035677698
└── これが投稿 ID
```
```bash cURL theme={null}
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"}'
```
```python Python SDK theme={null}
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}")
```
```javascript JavaScript SDK theme={null}
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}`);
```
```json theme={null}
{
"data": {
"bookmarked": true
}
}
```
***
## ブックマークを削除する
投稿をブックマークから削除します:
```bash cURL theme={null}
curl -X DELETE "https://api.x.com/2/users/2244994945/bookmarks/1460323737035677698" \
-H "Authorization: Bearer $USER_ACCESS_TOKEN"
```
```python Python SDK theme={null}
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}")
```
```javascript JavaScript SDK theme={null}
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}`);
```
**レスポンス:**
```json theme={null}
{
"data": {
"bookmarked": false
}
}
```
***
## 必要なスコープ
OAuth 2.0 PKCE を使用する場合、アクセストークンには以下のスコープが必要です:
| Scope | Description |
| :--------------- | :----------- |
| `bookmark.write` | ブックマークの追加と削除 |
| `tweet.read` | 投稿データを読み取り |
| `users.read` | ユーザーデータを読み取り |
***
## 次のステップ
ブックマークした投稿を取得
エンドポイントの完全なドキュメント