x/
posts

既知の公開x.comまたはtwitter.comのステータスURLから、全文、投稿者情報、エンゲージメント数、メディア、エンティティ、会話の関係を含む構造化ポストレコードを取得します。

Twitter Tweet Scraper API

既知のポストを照会
エンゲージメント情報
会話のつながり
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Twitter Tweet Scraper

公開Xポストは、本文と投稿日時に加えて、投稿者、メディア、ハッシュタグ、メンション、表示中のリアクション、周辺の会話へのリンクで構成されます。既知のURLについてこれらをまとめて取得することで、ポストのカタログ、レビュー用データセット、特定時点の比較をより充実させることができます。

Twitter Tweet Scraper API の主な機能

  • ステータスURLからの正確な照会パスに数値のステータスIDを含む、1つ以上の公開x.comまたはtwitter.comのリンクを照会します。
  • ポストと投稿者の情報正規のポストIDとURL、全文、言語、投稿日時、投稿者の公開アカウント情報とプロフィールリンクを返します。
  • エンゲージメント、メディア、エンティティいいね、返信、リポスト、引用、表示回数、ブックマークの各数値と、メディアの参照、ハッシュタグ、メンションをポストとあわせて保持します。
  • 会話とソースの情報返信、会話、引用、リポスト、ソース、送信URLの各識別子を保持するため、既知のポストを追跡できます。

Twitter Tweet Scraper API のパラメータ

パラメータ必須説明
urls必須必須。公開x.comまたはtwitter.comのステータスURLのリストです。各URLの /status/ パスには数値のポストIDが含まれている必要があります。

Twitter Tweet Scraper API の使い方

まずポストのリンクを検証し、1つの非同期照会タスクで該当するステータスのレコードを取得します。

  1. すべての公開x.comまたはtwitter.comのURLに /status/{numeric_id} が含まれていることを確認します。
  2. 検証済みの urls 配列を /v1/x/posts に POST し、返された task_id を保存します。
  3. 照会が成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. 完了後に data.results.items を取得し、has_more が false になるまで next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/x/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Twitter Tweet Scraper API の主なユースケース

  • ポストリンクのカタログ整備: Xのリンクだけの状態から、検索可能な本文、投稿者情報、メディアの参照、エンティティ、投稿日時、固定のポストIDを含むレコードに置き換えます。
  • キャンペーンポストの記録: 承認済みのキャンペーンURLについて、正確な内容、投稿者、メディア、関係情報、取得時点のエンゲージメントを記録します。
  • 選定したポストのスナップショット比較: 同じポストIDを一定間隔で照会し、いいね、返信、リポスト、引用、表示回数、ブックマークを collected_at ごとに比較します。

Twitter Tweet Scraper API 活用のヒント

  • 数値の /status/ IDを含まないリンクは送信前に除外し、プロフィールURLや検索URLが照会対象に混ざらないようにしてください。
  • x.com と twitter.com の各形式からポストIDを抽出し、URL文字列全体ではなくそのIDで重複を排除してください。
  • 公開されている数値は照会後も変化し続けるため、エンゲージメントを比較する際は必ず collected_at とあわせて扱ってください。
  • 形式の異なるポストレコードを保存する場合は、メディア配列や返信・引用・リポストの識別子を任意項目として扱ってください。

Twitter Tweet Scraper API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。

  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
  • X Post Replies API — XのポストURLから公開返信を取得します。並び順を指定でき、返信テキスト、投稿者、表示中のエンゲージメント、メディア、親ポストの情報を返します。
  • X Post Retweeters API — 既知のXまたはTwitterのステータスURLをリポストしたアカウントについて、正規化された公開プロフィールをタスク単位で重複なく取得します。
  • Twitter Mentions API — 指定したアカウントをメンションしている公開ポストを取得します。

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

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

Twitter Tweet Scraper API — よくある質問

Twitter Tweet Scraper APIは、受け付けたステータスURLごとに公開Xポストを取得するAPIです。ポストの本文、投稿者、エンゲージメント数、メディア、エンティティ、タイムスタンプ、会話の関係を返します。

/status/ パスに数値のポストIDを含む公開x.comまたはtwitter.comのURLを使用します。受け付け可能なリンクを1つ以上 urls 配列に追加してください。

各レコードには、正規のIDとURL、全文、言語、投稿者の詳細、エンゲージメント数、メディア、ハッシュタグ、メンション、投稿日時、取得時刻が含まれる場合があります。

extra オブジェクトに、利用可能な会話、親ポスト、引用元ポスト、リポスト元ポストの識別子が含まれ、取得したポストを会話の文脈と結び付けます。

タスクから返された取得済みポスト1件につき0.5 SocQクレジットです。