こんにちは、Web 調査でソース URL にたどり着けず困るアーキテクトのやまぱんです。
X の投稿を一次情報として確認したいのに、閲覧環境によってはログイン画面や JavaScript 描画で内容を拾いにくいことがあります。そんなときに、既知の公開投稿を 1 件だけ確認する補助手段として使えるのが FxTwitter API です。
この記事で扱うのは、GET /2/status/{id} で公開投稿を JSON として読む最小限の手順です。投稿の検索、継続的な収集、非公開投稿の取得は対象にしません。
この図では、X の投稿 URL から構造化データを確認する位置付けを示しています。
TL;DR
- FxTwitter API v2 の
GET /2/status/{id}は、既知の X 投稿 ID から投稿データを JSON で返します。 - 取得時はレスポンスの
codeを確認します。200のときだけstatus.textやstatus.authorを参照します。 - API のレスポンスを取得しても、記事の出典は元の X 投稿 URL にします。
- FxTwitter は X Corp. 非公式の第三者サービスです。Cookie、アクセストークン、アカウント情報は渡しません。
- 継続的・大量の収集や業務システムへの組み込みには使わず、X が公開するインターフェースと条件を別途確認します。
FxTwitter API とは
FxEmbed は、FxTwitter、FixupX などの埋め込みサービスを提供するオープンソースプロジェクトです。プロジェクト自身も X Corp. とは提携していないと明記しています。
FxTwitter API は、そのサービスが提供する X/Twitter 向け API です。API Overview によると、現行 API は /2/ 配下にあり、レスポンスは JSON です。レスポンス本文にも HTTP ステータスを写した code フィールドが含まれます。
ここで重要なのは、X の公式 API ではないことです。便利に読めたとしても、X の機能仕様、利用可否、投稿内容の事実確認は、元の X URL や投稿内で参照されている公式発表へ戻って確認します。
まずは投稿 ID だけを取り出す
対象は、URL がすでに分かっている公開投稿です。たとえば次の URL なら、末尾の数値が投稿 ID です。
https://x.com/<account>/status/1234567890123456789
API の URL は次の形になります。
https://api.fxtwitter.com/2/status/1234567890123456789
id は 2〜20 桁の数値文字列です。ハンドル名は API URL に含めません。詳しいパラメーターは Get post の API リファレンス で確認できます。
PowerShell で確認するなら、認証情報を使わない読み取りだけにします。
# 公開投稿の投稿 ID を指定して JSON を確認する
$postId = '1234567890123456789'
$response = Invoke-RestMethod -Uri "https://api.fxtwitter.com/2/status/$postId"
if ($response.code -ne 200) {
throw "FxTwitter API returned code $($response.code)"
}
$response.status | Select-Object id, url, text, author, media
私の環境では 2026/09/14 に投稿 ID 20 を使い、code: 200、元の X URL、投稿本文、投稿者を含む JSON を確認できました。これは API の可用性を保証する検証ではなく、その時点の単発確認です。
code を見てから本文を読む
FxTwitter API のリファレンスでは、成功・失敗にかかわらずレスポンス内の code を確認するよう案内されています。投稿本文を読む処理は、code が 200 の場合だけに限定します。
この図は、実際に確認する順序です。失敗時に別の API を探し回るのではなく、元の X URL やブラウザ確認に戻ります。
code |
意味 | 確認すること |
|---|---|---|
200 |
投稿データを返せた | status.url、status.text、status.author を確認する |
400 |
投稿 ID やクエリが不正 | URL 末尾の数値を確認する |
401 |
非公開または利用できない投稿 | 取得を試行し続けず、公開範囲を確認する |
404 |
投稿が見つからない | 元 URL の削除・変更を確認する |
500 |
FxTwitter 側または上流の失敗 | 時間を置くか、元 URL をブラウザで確認する |
401、404、500 の定義は Get post の応答仕様 に基づいています。HTTP の成功だけで本文を読まず、JSON 内の code も確認するのがポイントです。
使う範囲を意識しておく
便利な API ほど、用途の境界を先に決めておくと迷いません。私は「既知の公開投稿を 1 件確認する」までに限定します。
向いている場面
- 共有された X 投稿 URL の本文を短時間で確認したい。
- 投稿者、本文、添付メディアの有無を構造化データとして把握したい。
- 記事や調査メモの出典候補を確認し、元 URL へリンクしたい。
避ける場面
- 非公開、削除済み、またはアクセス制限された投稿を取得しようとする。
- Cookie、アカウント情報、アクセストークンを渡す。
- 特定アカウントの投稿を継続監視したり、大量取得したりする。
- 取得結果だけを根拠に、投稿内容の真偽や公式見解を断定する。
X の利用規約では、提供されている公開インターフェース以外でのアクセス、書面による許可のないスクレイピング、技術的制限の回避を禁止しています。X Terms of Service を読む限り、FxTwitter の仕組みが規約に準拠しているか、あるいは利用が適法かをこの記事から判定することはできません。
そのため、FxTwitter を X の公式 API の代替や大量収集の基盤とみなすべきではありません。外部サービスへの依存は突然使えなくなる可能性もあるため、継続運用が必要な場合は X が公開する API、利用規約、必要な契約条件を確認してください。
調査での使い分け
投稿を取得できたことと、調査が終わったことは別です。API は読み取りを助ける入口にとどめ、主張の根拠は一次ソースへ戻します。
| やりたいこと | 使うもの | 出典の扱い |
|---|---|---|
| 既知の公開投稿を 1 件読む | FxTwitter API | 元の X 投稿 URL を記載する |
| 投稿が紹介する製品仕様を確認する | 製品の公式 Docs / 公式リポジトリ | 公式 URL を主な根拠にする |
| 投稿の画面表示や文脈を確かめる | 元の X URL / ブラウザ | 表示時点と閲覧条件を分けて記録する |
| 継続利用や業務利用を検討する | X の公式 API と利用条件 | 非公式 API への依存を前提にしない |
この分け方なら、画面が読み取りにくいときも調査が止まりにくく、記事に残す根拠も追いかけやすくなります。
まとめ
FxTwitter API は、既知の公開 X 投稿を JSON で確認する補助手段としては便利でした。code を確認してから必要なフィールドだけを見る、失敗したら元 URL に戻る、出典は原投稿を使う。この 3 点を守れば、調査の入口として扱いやすいと思います。
一方で、FxTwitter は非公式サービスです。認証情報を渡さず、単発の公開投稿に絞り、継続利用が必要なら公式の経路を検討しましょう。
気になった点や、別の確認方法をご存じの方はコメントで教えてください。
参考
- FxEmbed GitHub リポジトリ: プロジェクト概要、X Corp. との非提携表記
- FxEmbed API Overview: API v2、JSON レスポンス、
codeフィールド - FxTwitter API: Get post:
GET /2/status/{id}、パラメーター、応答コード - FxEmbed FAQ: 提供ドメインとプライバシー方針
- X Terms of Service: 自動アクセス、スクレイピング、公開インターフェースに関する条件