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
Отправьте одно имя пользователя и постранично читайте посты с его вкладки «Медиа».
- Отправьте {"username": "NASA", "results_limit": 20} методом POST на /v1/x/user-media.
- Проверяйте GET /v1/tasks/{task_id} каждые несколько секунд, пока status не станет succeeded.
- Читайте посты из 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 добавляет ее, чтобы указать на прикрепленные медиа.
Связанные API
Помимо 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 в текст и получайте длительность каждого видео.
- 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