x/
list-posts

リストのURLから、公開Xリストのタイムラインにある最新のポストとリポストを新しい順に収集します。各項目に本文、投稿者、いいね数、表示回数、メディア、リポストのフラグが付きます。

X List Tweets API

リストURLを入力
リポストにフラグ
新しいポスト順
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

X List Tweets

Xリストのタイムラインは、誰かがリストにまとめたアカウントのポスト(ツイート)とリポストが流れるフィードで、各ポストには本文、投稿者、いいね、コメント、リポスト、表示回数、添付の画像や動画、ハッシュタグ、メンションが付いています。これらのポストをまとめて読むと、ジャーナリスト、創業者、競合などの厳選されたグループが何を話題にしているかを追い、どのメンバーのポストが最もエンゲージメントを集めているかを確かめ、グループが繰り返し拡散しているのが誰のコンテンツかを把握できます。

X List Tweets API の主な機能

  • URLで公開リストのタイムラインを取得x.com/i/lists/<id> のリンクを1つ以上送信すると、各リストのタイムラインが新しい順に、1リストにつき最大2,000件返ります。
  • リポストにフラグを付け、元の投稿者を区別is_repost がすべてのリポストを示します。author はそれをシェアしたリストメンバーのままで、reposted_author と reposted_post_id が元の投稿者とポストを指します。
  • 各ポストのエンゲージメントとメディアmetrics にはいいね、コメント、シェア、表示回数が入り、media には各画像や動画が URL、サムネイル、幅、高さとともに並びます。
  • ハッシュタグとメンションを別々の配列でhashtags と mentions はそれぞれ独立したリストで返るため、リストで話題になっているトピックや、メンバーが言及しているアカウントをフィールドから直接集計できます。

X List Tweets API のパラメータ

パラメータ必須説明
urls必須https://x.com/i/lists/<numeric id> 形式の公開XリストのURLです。各リストのタイムラインは個別に収集されます。
results_limit任意各リストから収集するポストの件数です。20〜2,000の範囲で20の倍数を指定し、デフォルトは100です。

X List Tweets API の使い方

リストのURLを送信し、タスクの完了を待ってから、タイムラインをページごとに読み取ります。

  1. {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} を /v1/x/list-posts に 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/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Reposts arrive with is_repost set to true and the original creator in reposted_author.

X List Tweets API の主なユースケース

  • 厳選リストで担当分野を追う: ジャーナリストやアナリストのリストのタイムラインを毎朝取得し、text、author、published_at を読んで、前回の実行以降にそのグループが取り上げた話題を確認します。
  • ニッチな分野で反響の大きいポストをランク付け: オリジナルのポスト(is_repost が false)を残して views_count と likes_count で並べ替え、どのメンバーの投稿が最も注目を集めたかを見つけます。
  • グループが拡散している相手の把握: リポスト全体で reposted_author.username を集計し、リストが外部のどのアカウントや、どのメンバー同士を最も頻繁に拡散しているかを確認します。
  • 競合の発表を1つのフィードに集約: 競合ブランドのアカウントを1つのリストにまとめてそのタイムラインを収集し、ローンチのポスト、リンク、添付メディアをまとめて取得します。
  • コミュニティのトピックデータセット構築: リストのポストに含まれる hashtags と mentions を published_at ごとにまとめ、そのコミュニティが時間とともにどのトピックやアカウントについて話しているかをグラフにします。

X List Tweets API 活用のヒント

  • リポストには元のポストのいいね数と表示回数が付くため、エンゲージメントでメンバーを順位付けする前に is_repost で絞り込んでください。
  • 複数のメンバーが同じポストをリポストしている場合は、reposted_post_id で重複を除き、元のポストを1回だけ数えてください。
  • 活発なリストではタイムラインの大半をリポストが占めることがあるため、オリジナルのポストを十分に集めたいときは results_limit を引き上げてください。
  • リポストの text は「RT @user:」で始まり、mentions にもそのユーザーが含まれるため、キーワードやメンションを数える前にリポストを除外するか、この接頭辞を取り除いてください。
  • 定期実行では、新しい順のタイムラインが前回の実行結果と重なるため、保存先にとって新しい id の項目だけを残してください。
  • めったに投稿しないメンバーも含めて、タイムラインに流れてくるすべてのアカウントを確認するには、同じリストを Twitter List Members API で収集してください。

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

  • Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
  • X Post Replies API — XのポストURLから公開返信を取得します。並び順を指定でき、返信テキスト、投稿者、表示中のエンゲージメント、メディア、親ポストの情報を返します。
  • Twitter Mentions API — 指定したアカウントをメンションしている公開ポストを取得します。
  • Twitter List Members API — リストのメンバーを、自己紹介、所在地、各種カウントを含むプロフィールとして書き出します。

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

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

X List Tweets API — よくある質問

X List Tweets APIは、x.com/i/lists のURLから公開Xリストのタイムラインを収集するためのプログラムインターフェースで、各ポストやリポストの本文、投稿者、いいね、コメント、シェア、表示回数、メディア、ハッシュタグ、メンション、リポスト元を返します。

x.com でリストを開いてURL(https://x.com/i/lists/1940592907737845989 のような形式)をコピーし、urls に入れて送信します。ポストはリスト自体のタイムラインと同じく新しい順に返ります。

リストURLの /i/lists/ の後ろにある数字です。送信時は urls に完全なURLを入れてください。

はい。リストメンバーによるリポストも返り、is_repost でマークされます。元のポストのIDは reposted_post_id に、その投稿者は reposted_author に入ります。オリジナルのポストだけが必要な場合は is_repost で絞り込んでください。

存在しないリストを指すURLは空の結果を返します。その場合もタスクは成功扱いで、料金はかかりません。/i/lists/ の後ろの数字が欠けていないか確認してください。

はい。各リストのURLを urls に追加してください。results_limit はリストごとに数えられるため、3つのリストで100に設定すると最大300件のポストが返ります。