x/
user-media

Собирайте вкладку «Медиа» аккаунта X по имени пользователя: посты с фото, видео и GIF от новых к старым, с подписью, лайками, просмотрами и прямыми ссылками на файлы, видео — в MP4 с максимальным битрейтом.

Twitter Media Scraper API

Имя пользователя на входе
Фото, видео и GIF
MP4 с максимальным битрейтом
0,7 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Twitter Media Scraper

Вкладка «Медиа» в профиле X (Twitter) собирает твиты, в которых аккаунт делился фото, видео или GIF, от новых к старым, и у каждого из них есть подпись, а также число лайков, ответов, репостов и просмотров. Если читать эти посты как единую ленту, видно, что аккаунт публикует в визуальном формате, какие ролики набирают больше всего просмотров и как со временем меняется его использование изображений и видео.

Возможности Twitter Media Scraper API

  • Вкладка «Медиа» по одному имени пользователяОтправьте одно имя пользователя, начальный @ необязателен, и получите твиты аккаунта с фото, видео или GIF в порядке вкладки «Медиа», от новых к старым.
  • Видеофайлы с максимальным битрейтомДля видео media.url указывает на MP4 с самым высоким битрейтом, а thumbnail_url — на его превью, поэтому ролики можно сохранить в лучшем качестве, которое предлагает X.
  • Все вложения поста в одном спискеmedia перечисляет каждое изображение и видео поста с указанием типа, поэтому несколько фото одного поста остаются вместе под одной подписью.
  • Подпись, ссылка и вовлеченность каждого постаКаждый пост также содержит 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} методом POST на /v1/x/user-media.
  2. Проверяйте GET /v1/tasks/{task_id} каждые несколько секунд, пока status не станет succeeded.
  3. Читайте посты из results.items и скачивайте каждый media.url; запрашивайте следующую страницу через results.next_cursor, пока has_more равно true.
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 поста, чтобы хранить датированную копию всего, чем делился аккаунт.
  • Поиск самых просматриваемых роликов аккаунта: Оставьте посты с типом медиа video и отсортируйте их по views_count и likes_count, чтобы выбрать самые успешные ролики.
  • Аудит визуального контента бренда: Считайте посты с изображениями и видео по месяцам на основе published_at и media.type, чтобы увидеть, как у бренда меняется соотношение фото и видео.
  • Визуальные материалы для отчетов и брифов: Используйте thumbnail_url и ссылки на изображения вместе с подписью и числом просмотров каждого поста, чтобы иллюстрировать обзоры конкурентов или итоги кампаний.

Практические советы по Twitter Media Scraper API

  • Называйте сохраненные файлы по id поста и позиции вложения в media, чтобы у постов с несколькими фото сохранялся порядок.
  • Чтобы обновить архив, запрашивайте небольшой results_limit и прекращайте листать страницы, как только дойдете до id поста, который у вас уже есть: самые новые посты идут первыми.
  • Измеряйте ширину и высоту по скачанным файлам, если макету нужны точные размеры.
  • Удаляйте завершающую ссылку https://t.co из text перед анализом подписей: X добавляет ее, чтобы указать на прикрепленные медиа.

Помимо Twitter Media Scraper API, используйте эти API, когда нужен другой тип публичных данных X.

  • Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
  • Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
  • X Post Quotes API — Собирайте публичные цитаты известных URL статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
  • X Post Replies API — Собирайте публичные ответы по URL постов X с выбором порядка: текст ответа, авторы, видимая вовлеченность, медиа и контекст родительского поста.
  • Twitter Mentions API — Собирайте публичные посты с упоминанием заданного аккаунта.
  • Twitter Video Transcript API — Превращайте речь в видео X в текст и получайте длительность каждого видео.

Другие платформы

Объединяйте данные X с публичными данными других поддерживаемых соцсетей.

Twitter Media Scraper API — FAQ

Twitter Media Scraper API — это программный интерфейс для сбора постов с фото, видео и GIF с вкладки «Медиа» аккаунта X по его имени пользователя. Он возвращает текст каждого поста, автора, счетчики вовлеченности и список media с прямыми URL файлов, а видео — в MP4 с максимальным битрейтом.

Отправьте имя пользователя аккаунта, задайте в results_limit нужную глубину и скачайте каждый media.url из возвращенных постов. Каждый файл остается связан со своим постом через url и published_at.

Для каждого видео media.url — это MP4 с самым высоким доступным битрейтом, а thumbnail_url содержит изображение превью.

Да. Посты с GIF относятся к вкладке «Медиа» и возвращаются вместе с постами с фото и видео в том же порядке, от новых к старым.

От 1 до 1 000, значение задается в results_limit; по умолчанию 20. Результаты разбиты на страницы, поэтому продолжайте чтение через next_cursor, пока has_more равно true.

Каждый запрос принимает одно имя пользователя. Отправляйте отдельный запрос для каждого аккаунта и объединяйте результаты по author.username.