x/
article

記事を公開しているポストのURLから、Xの記事の全文を取得します。タイトル、タイムラインのプレビュー、カバー画像、投稿者、エンゲージメントも返し、段落の区切りもそのまま保持します。

X Articles API

ポストURLを入力
記事の本文全体
タイトル・プレビュー・カバー画像
結果1件あたり0.7クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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行を読み取ります。

  1. {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} を /v1/x/article に POST します。
  2. タスクの status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. 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 を記事のポストへの返信数として扱ってください。

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 — 指定したアカウントをメンションしている公開ポストを取得します。

他のプラットフォームを見る

Xのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

X Articles API — よくある質問

X Articles APIは、タイトルとカバー画像を持つ長文のポストであるXの記事を、それを公開しているポストのURLから読み取るためのプログラムインターフェースです。タイトル、タイムラインのプレビュー、本文の全文、カバー画像のURL、投稿者、いいね数・返信数・引用数・表示回数を返します。

Xの記事は、プレミアム加入者がXで公開できる長文のポストで、タイトル、カバー画像、書式付きの本文があります。タイムラインでは短いプレビュー付きのポストとして表示され、読者は開いて全文を読みます。

x.com/{username}/status/{post_id} 形式の、記事を公開しているポストのリンクを使います。urls には複数のリンクを一度に入れることができ、記事ごとに1行が返ります。

そのポストは行を返さず料金もかかりませんが、同じリクエスト内の記事は返ります。すべてのURLが記事でない場合、タスクは失敗し全額返金されます。

カバー画像は cover_url で返ります。本文中に配置された画像は含まれず、text には文章の内容だけが入ります。

はい。text には本文全体が段落の間に空行を入れたプレーンテキストで入っているので、.txt ファイルとして保存したり、Markdownの段落として使ったりでき、title を見出しとして先頭に追加できます。