X Articles
X(旧Twitter)の記事は、プレミアム加入者がタイトル、カバー画像、書式付きの本文で公開する長文のポストで、タイムラインには短いプレビューとして表示され、ほかのポストと同じようにいいね、返信、引用、表示回数が集まります。タイトル、プレビュー、本文全体をテキストとしてこれらの数値と並べて持っておくと、長文コンテンツのアーカイブ、要約や分類、通常のポストと比べた記事の反響の比較ができるようになります。
X Articles API の主な機能
- URLで記事のポストを指定x.com/{username}/status/{post_id} 形式で、記事を公開しているポスト(ツイート)のリンクを1つ以上送信すると、記事ごとに1行が返り、その id と url はそのポストのものになります。
- プレーンテキストの本文全体text には段落の間に空行を入れた記事全体が入り、そのまま段落に分割したり、リーダー、検索インデックス、言語モデルに渡したりできます。
- タイトル、プレビュー、カバー画像title、summary(Xがタイムラインに表示するプレビュー)、cover_url で、読者がフィードで最初に目にする形の記事を表せます。
- 投稿者とエンゲージメントauthor にはハンドル、表示名、アイコン画像、認証フラグが、metrics にはいいね、返信、引用、表示回数が入り、published_at には記事が公開された日時が記録されます。
X Articles API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | /{username}/status/{post_id} 形式のXポストURLを1つ以上指定します。いずれも記事を公開しているポストを指すURLです。 |
X Articles API の使い方
記事を掲載しているポストのリンクを送信し、記事ごとに1行を読み取ります。
- {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} を /v1/x/article に POST します。
- タスクの status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items から記事を読み取り、has_more が true の間は results.next_cursor を送って次のページを取得します。
curl -X POST "https://api.socq.ai/v1/x/article" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/USDOL/status/2119796255089947070"]}'
# text holds the whole Article, with a blank line between paragraphs.X Articles API の主なユースケース
- 投稿者の長文コンテンツのアーカイブ: 各記事の title、text、cover_url、published_at、url を保存し、アカウントが長文で公開してきた内容を検索できる形で残します。
- 言語モデルで記事を要約: text を空行で分割し、title を文脈として段落を要約ツールや言語モデルに渡して、長い記事を短いダイジェストにまとめます。
- 記事と通常のポストの比較: 投稿者の記事の views_count、likes_count、quotes_count を通常のポストの同じ数値と並べ、オーディエンスがどちらの形式を読み、広めているかを確認します。
- 公開後の記事の追跡: 同じURLを一定間隔でリクエストし、published_at 後の数日間に表示回数、返信、引用がどのように積み上がるかを記録します。
- 発表内容を一字一句引用: 政府機関、企業、創業者が記事として発表を公開したときに、text から正確な一節を取り出し、url と published_at を添えて引用します。
X Articles API 活用のヒント
- どのポストが記事かわからない場合は、まとめて1つのバッチで送信してください。行が返り課金されるのは記事だけで、通常のポストだけで構成されたバッチは失敗し、全額返金されます。
- プレビューやカードには summary、閲覧画面には text を使ってください。summary は本文の冒頭部分と同じ内容なので、両方をつなげるとその部分が2回表示されます。
- 各記事は、それを公開しているポストのIDである id の下に保存してください。同じ記事を再度収集すると、保存済みの数値が更新されます。
- 記事のエンゲージメントをダッシュボードに載せるときは、metrics.comments_count を記事のポストへの返信数として扱ってください。
関連API
X Articles API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。
- Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
- Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
- Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
- X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
- X Post Replies API — XのポストURLから公開返信を取得します。並び順を指定でき、返信テキスト、投稿者、表示中のエンゲージメント、メディア、親ポストの情報を返します。
- Twitter Mentions API — 指定したアカウントをメンションしている公開ポストを取得します。
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API