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を送信し、タスクの完了を待ってから、タイムラインをページごとに読み取ります。
- {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} を /v1/x/list-posts に 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/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 で収集してください。
関連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 — リストのメンバーを、自己紹介、所在地、各種カウントを含むプロフィールとして書き出します。
- Twitter Profile Scraper 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
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API