Twitter Media Scraper
X(旧Twitter)プロフィールの「メディア」タブには、アカウントが画像、動画、GIFを共有したポストが新しい順に並び、それぞれに本文と、いいね、返信、リポスト、表示回数が付いています。これらのポストを1つのフィードとして読むと、アカウントがどんなビジュアルを発信しているか、どのクリップが最も再生されているか、画像と動画の使い方が時間とともにどう変わるかがわかります。
Twitter Media Scraper API の主な機能
- 1つのユーザー名から「メディア」タブを取得ユーザー名を1つ送信すると(先頭の @ は任意)、画像、動画、GIFを含むそのアカウントのポスト(ツイート)が、「メディア」タブと同じ新しい順で返ります。
- 最高ビットレートの動画ファイル動画の場合、media.url は最高ビットレートのMP4を、thumbnail_url はそのプレビュー画像を指すため、Xが提供する最高画質でクリップを保存できます。
- ポストの添付ファイルを1つのリストにmedia にはポストの各画像と動画が種類とともに並ぶため、複数の画像を含むポストでも1つの本文の下にまとまります。
- ポストごとの本文、リンク、エンゲージメント各ポストには text、url、published_at、author と、いいね、コメント、シェア、表示回数も付き、すべてのファイルを取得元のポストに結び付けられます。
Twitter Media Scraper API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
username | 必須 | 「メディア」タブを収集するXのユーザー名です。先頭の @ は付けても付けなくてもかまいません。 |
results_limit | 任意 | 返すメディアポストの件数です。1〜1,000の範囲で指定し、デフォルトは20です。 |
Twitter Media Scraper API の使い方
ユーザー名を1つ送信し、その「メディア」タブのポストをページごとに読み取ります。
- {"username": "NASA", "results_limit": 20} を /v1/x/user-media に POST します。
- status が succeeded になるまで、数秒おきに GET /v1/tasks/{task_id} を確認します。
- results.items からポストを読み取って各 media.url をダウンロードし、has_more が true の間は results.next_cursor で次のページをリクエストします。
curl -X POST "https://api.socq.ai/v1/x/user-media" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"NASA","results_limit":20}'
# For a video, media.url is the highest-bitrate MP4 and thumbnail_url its preview.Twitter Media Scraper API の主なユースケース
- アカウントの画像と動画のアーカイブ: すべての media.url をダウンロードし、ポストの url と published_at とともに保存して、アカウントが共有してきたものを日付付きで残します。
- 最も再生されたクリップの発見: media の種類が video のポストを残し、views_count と likes_count で順位付けして、最も成果を上げたクリップを選びます。
- ブランドのビジュアルコンテンツ構成の分析: published_at と media.type から月ごとの画像ポストと動画ポストの数を数え、ブランドの画像と動画のバランスの変化を確認します。
- レポートや資料用のビジュアル収集: thumbnail_url や画像リンクを各ポストの本文や表示回数とあわせて使い、競合レビューやキャンペーンの振り返りに図版を添えます。
Twitter Media Scraper API 活用のヒント
- 保存するファイルにはポストの id と media 内での添付ファイルの位置を組み合わせた名前を付けると、複数の画像を含むポストでも順序を保てます。
- アーカイブを更新するときは results_limit を小さめにし、すでに保存しているポストの id に達したらページ送りを止めてください。新しいポストから順に返ります。
- レイアウトで正確なサイズが必要な場合は、ダウンロードしたファイルから幅と高さを測ってください。
- 本文を分析する前に、text の末尾にある https://t.co のリンクを取り除いてください。これは添付メディアを指すためにXが付け加えるものです。
関連API
Twitter Media Scraper 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 Video Transcript API — Xの動画の音声をテキストに変換し、動画の長さも返します。
- 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
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API