XのブックマークをAPIで取得する手順認証・料金・100件ずつのページ送り
Xのブックマークは公式APIで自分の分だけ取得できます。必要なスコープは3つ、1回に取れるのは100件まで、料金は自分のデータの読み取りで1件0.001ドル、上限は15分あたり180回。認証から取得までの手順を公式ドキュメントで確認しました。

目次を見る
Xのブックマークが数百件を超えると、画面を上下にたどるだけでは目当てのポストに戻れなくなります。手元のファイルやデータベースに移したくなるのは、だいたいこの段階です。
私は普段、新規事業の立ち上げと成長の支援をしていて、Xで見つけたポストを毎日かなりの数保存しています。エンジニアではありませんが、自分のサービスは Claude Code を使って作っています。
ただ、公式APIを使う前に知っておいたほうがいいことが一つあります。
Xの公式APIは2026年11月19日時点で従量課金制です。 公式の料金ページには「No subscriptions—pay only for what you use.」と書かれています。
月額プランを選ぶ形ではなくなっているので、見積もりは件数から立てることになります。
では、実際にブックマークを取り出すには何が必要なのか。
必要なのは、承認済みのアプリ、bookmark.read を含むスコープでの本人の許可、そして自分のユーザーIDです。1回のリクエストで取れるのは100件までで、続きはページ送りで取ります。
この記事では、認証の準備から100件ずつの取得まで、公式ドキュメントに書かれている手順と費用の数え方をまとめます。
ブラウザの拡張機能や標準機能で済ませたい方は「Xのブックマークを整理する方法」のほうが近い内容です。
取り出したあとをAIエージェントから検索できる形にしたい方は「あとで読むサービスのAPIとMCP連携」が近いです。
取得できるのは自分のブックマークだけ
最初に線を引いておきます。このAPIで取れるのは、認証した本人のブックマークに限られます。
公式ドキュメントのブックマークの説明は「Bookmarks are private and only visible to the user who created them.」と書いています。他人のブックマークを一覧することはできません。
パスに入れるIDも本人のものである必要があります。ドキュメントは「The authenticated user's numeric ID, not me」と書いていて、me という文字列では通りません。
確認の条件
数字を並べる前に、何をどこで確認したかを書いておきます。
- 確認日: 2026年11月19日に、X の開発者向け公式ドキュメント(エンドポイント仕様・レート上限・料金)で確認した内容です
- 通貨: 公式ページの表記どおりドル建てで書いています。円に換算した金額は、為替で変わるため書きません
- 含めたもの: 公式APIのうち、自分のブックマークを読み取るエンドポイントと、その認証・上限・料金
- やっていないこと: 私自身が開発者コンソールでアプリを登録し、このエンドポイントを呼んで請求額を確かめたわけではありません。書いているのは公式ドキュメントの記載です
- 「要確認」の意味: 公式ページで確認できなかった項目です。無いという意味ではありません
| 項目 | 公式ドキュメントの記載 |
|---|---|
| エンドポイント | GET /2/users/{id}/bookmarks |
| 認証 | OAuth 2.0 PKCE で取得したユーザーアクセストークン |
| スコープ | bookmark.read/tweet.read/users.read |
| 1回の取得件数 | max_results は最小1・最大100 |
| レート上限 | ユーザーあたり15分で180回(アプリあたりの記載なし) |
| 上限を超えたとき | 429 エラーが返り、ウィンドウが開くまで戻らない |
| 料金 | 自分のデータの読み取りは1件0.001ドル |
| 書き込み側の料金 | ブックマークの追加は1リクエスト0.005ドル |
認証の準備
ここが一番つまずく場所だと思っています。トークンの種類を間違えると、同じエンドポイントでも通りません。
アプリを作ってリダイレクトURIを登録する
公式ドキュメントは、サインアップ先として console.x.com を挙げ、そこでアプリを作るよう案内しています。前提条件に挙がっているのは、承認済みの開発者アカウントとアプリです。
OAuth 2.0 PKCE を使うので、認証後に戻ってくる先をアプリ側に登録しておきます。ドキュメントの例ではローカルの開発用アドレスが使われています。
bookmark.read を含む3つのスコープで許可を取る
ブックマークの取得に必要なスコープは3つです。bookmark.read・tweet.read・users.read で、エンドポイントの仕様ページにこの3つが並んでいます。
bookmark.read の説明は「Read your bookmarked Posts.」です。残りの2つは、見られるポストとアカウントを参照するための許可として説明されています。
アプリだけで使える Bearer トークンでは足りません。ブックマークは本人にしか見えないデータなので、本人が許可したうえで発行されるユーザーアクセストークンが要ります。
3-legged OAuth でも取得できると書かれていますが、ドキュメントが先に挙げているのは OAuth 2.0 PKCE です。新しく作るなら後者で揃えるほうが迷いません。
取得の手順
準備ができたら、呼ぶのは2回だけです。
自分のユーザーIDを調べる
まず GET /2/users/me を呼び、返ってきた数値のIDを控えます。公式のクイックスタートも、ユーザーIDの取得を最初の手順に置いています。
ここで控えるのは画面に出るユーザー名ではなく、数値のIDです。パスに入れるのはこちらです。
100件ずつページ送りで取る
次に GET /2/users/{id}/bookmarks を、ユーザーアクセストークンを Authorization ヘッダーに付けて呼びます。max_results の上限は100なので、それ以上は1回では返りません。
続きを取るための値は、レスポンスの meta に入っています。 クイックスタートは、ブックマークしたポストが data の配列で返り、meta に次のページ用の next_token が入ると説明しています。
この値を pagination_token として次のリクエストに渡し、返らなくなるまで繰り返します。500件あれば5回、1,000件あれば10回です。
ユーザーあたりの上限は15分で180回なので、この繰り返し自体が上限に当たることはまずありません。
費用はいくらになるのか
従量課金なので、件数から見積もれます。
公式の料金ページには「Owned Reads」という区分があり、自分のデータを読み取るエンドポイントが並んでいます。その一覧に GET /2/users/{id}/bookmarks が「Your bookmarks」として載っていて、単価は1件0.001ドルです。
課金の単位はリクエストではなく、返ってきた件数です。 読み取りは「Charged per resource returned in the response.」と書かれています。
1,000件取れば1ドルという計算になります。
同じ区分の条件として、パスのIDが認証したユーザーと一致し、そのユーザーが開発者アプリの所有者であることが挙げられています。自分の分を自分のアプリで取る、という前提です。
重複して取ったときの扱いも書かれています。同じリソースを24時間(UTC)のあいだに取り直しても追加の課金は起きない、という説明です。
ただし、これは「soft guarantee」と書かれています。
はじめて支払い用のカードを登録してクレジットを購入すると20ドル分の無料クレジットがもらえる、という案内もあります。試すだけなら、この範囲で収まる規模だと思います。
フォルダごとに取りたいとき
ブックマークをフォルダで分けている場合は、別のエンドポイントがあります。
公式ドキュメントのブックマークの一覧には、フォルダの一覧を返す GET /2/users/:id/bookmarks/folders が載っています。
フォルダ内のポストを返すのは GET /2/users/:id/bookmarks/folders/:folder_id です。
ただ、この2つが料金ページの「Owned Reads」の一覧に出てくるかは確認できませんでした。単価は要確認です。
そもそも画面側でフォルダを作るには X Premium が必要です。この条件は「Xのブックマークを整理する方法」で確認日つきにまとめています。
取り出したあとをどうするか
APIで取れるのは、ポストのIDと本文などのデータです。これをどこに置くかは別の問題として残ります。
ファイルに落として検索するだけなら、ここまでで足ります。問題は、数百件のテキストを並べても「どれを読み返すか」の判断が進まないことです。
保存した記事を読まないのは本人の怠慢ではなく、一覧にタイトルとURLしか情報が無いことが原因だと思っています。
私が開発している SuperFlow(AI要約)は、保存した時点で日本語の要約が付く形にしています。ただ、Xのブックマークを一括で取り込む機能はありません。
ポストは1件ずつ保存する仕組みで、Free は累計10件、Standard は月額1,980円(税込)で月100件です。過去分をまとめて移したい方には向きません。
自分で書いたコードで取り出して自分のデータベースに置きたい、という目的なら、公式APIのほうが素直です。SuperFlowの使い方は、1件ずつ保存して要約で選ぶ使い方を前提に書いています。
まとめ
- Xのブックマークを公式APIで取れるのは認証した本人の分だけで、ドキュメントは「Bookmarks are private and only visible to the user who created them.」と書いている
- 使うのは
GET /2/users/{id}/bookmarks。パスのIDはmeではなく数値のIDで、GET /2/users/meで調べる - 必要なスコープは
bookmark.read・tweet.read・users.readの3つで、トークンは OAuth 2.0 PKCE のユーザーアクセストークン - 1回に取れるのは最大100件。続きは
metaのnext_tokenをpagination_tokenに渡してページ送りする - レート上限はユーザーあたり15分で180回。超えると429が返る
- 料金は従量課金で、自分のデータの読み取りは返ってきた1件につき0.001ドル。ブックマークの追加は1リクエスト0.005ドル
- フォルダのエンドポイントも用意されているが、料金ページの「Owned Reads」に載っているかは確認できなかった(要確認)
よくある質問
XのブックマークをAPIで取得するには何が必要ですか
承認済みの開発者アプリと、OAuth 2.0 PKCE で発行したユーザーアクセストークン、そして自分の数値のユーザーIDです。スコープは bookmark.read・tweet.read・users.read の3つが必要です。2026年11月19日に公式ドキュメントで確認しました。
1回のリクエストで何件まで取れますか
max_results の最大が100なので、1回で100件までです。続きはレスポンスの meta に入る next_token を pagination_token として渡し、返らなくなるまで繰り返します。仕様は2026年11月19日に確認した内容です。
ブックマークの取得にいくらかかりますか
公式の料金ページでは、自分のデータを読み取る区分に GET /2/users/{id}/bookmarks が載っていて、単価は1件0.001ドルです。課金は返ってきた件数に対してかかるので、1,000件で1ドルの計算になります。はじめてクレジットを購入すると20ドル分の無料クレジットが付く案内もあります。2026年11月19日時点の確認内容です。
他の人のブックマークも取得できますか
できません。公式ドキュメントはブックマークを本人にしか見えないデータと説明していて、パスのIDも認証したユーザー自身のものである必要があります。2026年11月19日に確認しました。
アプリ用のBearerトークンでは取得できないのですか
取得できません。本人が許可したうえで発行されるユーザーアクセストークンが必要です。公式ドキュメントは OAuth 2.0 PKCE と 3-legged OAuth を挙げています。2026年11月19日時点の確認内容です。
レート上限はどれくらいですか
公式のレート上限のページでは、GET /2/users/:id/bookmarks はユーザーあたり15分で180回で、アプリあたりの数値は載っていません。超えると429エラーが返り、ウィンドウが開くまで戻りません。2026年11月19日時点の確認内容です。
出典・確認日
エンドポイントの仕様・スコープ・レート上限・料金は、次の公式ページで2026年11月19日に確認した内容に基づきます。料金と仕様は変わることがあるため、最新の内容は公式ページと開発者コンソールでご確認ください。
- Bookmarks(X Developer Platform): https://docs.x.com/x-api/posts/bookmarks/introduction
- bookmarks by user(エンドポイント仕様): https://docs.x.com/x-api/bookmarks/bookmarks-by-user
- bookmarks lookup(クイックスタート): https://docs.x.com/x-api/posts/bookmarks/quickstart/bookmarks-lookup
- X API Rate Limits: https://docs.x.com/x-api/fundamentals/rate-limits
- 料金(Pricing): https://docs.x.com/x-api/getting-started/pricing
- X API の概要: https://docs.x.com/x-api/introduction
- SuperFlow の料金とプランの枠: https://super-flow.ai/
保存するだけで、AIが日本語で要約
記事・X・YouTube・PDFを保存すると、AIが要約を自動で作るサービスです。まずは無料で試せます。
株式会社VASILYでのグロースハック担当、AR/VR領域の事業を手掛ける株式会社MESONの代表を経て、POSTSを創業。生成AIなどの先端テクノロジーを事業成長に結びつける戦略パートナーとして活動しています。著書に『生成AI時代を勝ち抜く事業・組織のつくり方』(日経BP)、『いちばんやさしいグロースハックの教本』(インプレス)。
AI時代の情報過多を解消するためにSuperFlowを開発しました。


