x/
user-posts

1つ以上のユーザー名から最近の公開Xポストを取得し、本文、投稿者、メディア、エンゲージメント、関係フィールドを返します。返信は除外され、取得上限はアカウントごとに適用されます。

Twitter User Tweets Scraper API

アカウントのタイムライン
返信を除外
ユーザーごとの上限
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Twitter User Tweets Scraper

Xアカウントのタイムラインは、1つのユーザー名に紐づく最近の公開ポストの連なりで、投稿日時、本文、メディア、投稿者情報、表示中のエンゲージメントを含みます。対象アカウント群でこれらを比較すると、投稿頻度、繰り返し取り上げるテーマ、コンテンツ構成の変化が見えてきます。

Twitter User Tweets Scraper API の主な機能

  • 複数ユーザー名のタイムライン先頭の @ の有無にかかわらず1つ以上の公開Xユーザー名を送信し、タスク内のすべてのアカウントについて最近のポストを取得します。
  • 最近の投稿活動をすっきり把握返信は取得対象から除外されるため、返されるタイムラインはアカウントの最近の公開投稿活動に絞られます。
  • アカウントごとの個別上限results_limit は各ユーザー名に個別に適用され、20から2,000までの20の倍数を指定できます。デフォルトは20です。
  • アカウント分析にすぐ使えるコンテンツ各ポストには、本文、言語、投稿者の詳細、表示中のエンゲージメント、メディア、エンティティ、タイムスタンプ、会話の関係が含まれる場合があります。
  • アカウントと取得元を追跡可能extra.input_username で送信したアカウントを特定でき、collected_at にはタイムラインのスナップショットを取得した時刻が記録されます。

Twitter User Tweets Scraper API のパラメータ

パラメータ必須説明
usernames必須必須。公開Xユーザー名のリストです。各値の先頭に @ を付けても付けなくてもかまいません。
results_limit任意任意。ユーザー名ごとに個別に適用される取得上限です。デフォルトは20で、20から2,000までの20の倍数を指定できます。

Twitter User Tweets Scraper API の使い方

観察したいアカウントを決めて同じ取得件数を設定し、最近のタイムラインを比較可能なレコードに変換します。

  1. 1つ以上の公開Xユーザー名を追加します。先頭の @ は任意です。
  2. アカウントごとの results_limit を、20から2,000までの20の倍数で設定します。
  3. リクエストを /v1/x/user-posts に POST し、タスクが完了するまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を追加し、次の結果ページがある場合は next_cursor を使って取得します。
curl -X POST "https://api.socq.ai/v1/x/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","OpenAI"],"results_limit":40}'

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

Twitter User Tweets Scraper API の主なユースケース

  • アカウントのウォッチリスト管理: 最近のポストを extra.input_username でグループ化し、選定したブランド、クリエイター、競合、公的機関の最新状況を把握します。
  • 投稿頻度の比較: created_at を使って各アカウントの投稿頻度を測定し、投稿タイミング、メディアの使い方、繰り返し取り上げるテーマの変化を把握します。
  • 最近のポストのコーパス構築: 本文、投稿者、メディア、エンティティ、エンゲージメントのフィールドを組み合わせ、分類やコンテンツレビューに使えるアカウント別のデータセットを作成します。

Twitter User Tweets Scraper API 活用のヒント

  • 送信前に先頭の @ を取り除き、大文字・小文字を区別せずにユーザー名の重複を排除してください。
  • アカウント間で活動を比較する場合は、有効な20の倍数で同じ results_limit を使用してください。
  • 対象となる最近のポストが上限より少ないアカウントもあるため、results_limit はアカウントごとの上限として扱ってください。
  • 定期的に取得したデータを既存のタイムラインデータセットに追加する前に、ポストの id で重複を排除してください。
  • 投稿の時系列には created_at を、取得したスナップショットの鮮度には collected_at を使用してください。

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

  • Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
  • X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
  • X Post Replies API — XのポストURLから公開返信を取得します。並び順を指定でき、返信テキスト、投稿者、表示中のエンゲージメント、メディア、親ポストの情報を返します。
  • Twitter Mentions API — 指定したアカウントをメンションしている公開ポストを取得します。
  • Twitter Media Scraper API — アカウントが投稿した画像・動画・GIFのポストを、最高画質のメディアファイルとともに取得します。
  • X User Replies API — アカウントが書いた返信を、返信先のポストとセットで取得します。

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

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

Twitter User Tweets Scraper API — よくある質問

Twitter User Tweets Scraper APIは、1つ以上のユーザー名について最近の公開Xポストを取得するAPIです。アカウントに紐づいたポストの本文、投稿者、エンゲージメント、メディア、エンティティ、関係、取得時のタイムスタンプを返します。

先頭の @ の有無にかかわらず、公開ユーザー名を usernames 配列に追加してください。1つのタスクで複数のユーザー名を処理できます。

いいえ。ユーザー名ごとに個別に適用されます。デフォルトは20で、20から2,000までの20の倍数を指定する必要があります。

返信は取得するアカウントのタイムラインから除外されるため、レコードは送信した各ユーザー名のその他の最近の公開ポストが中心になります。

本文、言語、投稿者の詳細、表示中のエンゲージメント、メディア、ハッシュタグ、メンション、タイムスタンプ、会話の関係、送信したユーザー名を利用できます。

指定した値は取得件数の上限です。実際の件数は、タスク実行時にそのアカウントで取得対象となる最近の公開ポストの数によって決まります。

正規化されたアカウントのポストレコード1件につき0.5 SocQクレジットを使用します。