x/
user-media

ユーザー名から、Xアカウントの「メディア」タブを収集します。画像・動画・GIFのポストを新しい順に、本文、いいね数、表示回数、ファイルの直接リンクとともに返し、動画は最高ビットレートのMP4で提供します。

Twitter Media Scraper API

ユーザー名を入力
画像・動画・GIF
最高ビットレートのMP4
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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つ送信し、その「メディア」タブのポストをページごとに読み取ります。

  1. {"username": "NASA", "results_limit": 20} を /v1/x/user-media に POST します。
  2. status が succeeded になるまで、数秒おきに GET /v1/tasks/{task_id} を確認します。
  3. 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が付け加えるものです。

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の動画の音声をテキストに変換し、動画の長さも返します。

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

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

Twitter Media Scraper API — よくある質問

Twitter Media Scraper APIは、ユーザー名からXアカウントの「メディア」タブにある画像・動画・GIFのポストを収集するためのプログラムインターフェースです。各ポストの本文、投稿者、エンゲージメント数と、ファイルの直接URLを含むメディアの一覧を返し、動画は最高ビットレートのMP4で提供します。

アカウントのユーザー名を送信し、results_limit を必要な件数に設定して、返されたポストの各 media.url をダウンロードします。すべてのファイルは url と published_at によって元のポストと結び付いたままです。

各動画の media.url は利用可能な中で最もビットレートの高いMP4で、thumbnail_url でプレビュー画像を取得できます。

はい。GIFを含むポストも「メディア」タブに含まれるため、画像や動画のポストと一緒に同じ新しい順で返ります。

results_limit で1〜1,000件の範囲で指定でき、デフォルトは20件です。結果はページ単位で返るので、has_more が true の間は next_cursor で読み進めてください。

1回のリクエストで指定できるユーザー名は1つです。アカウントごとにリクエストを送り、author.username で結果をまとめてください。