Twitter Media Scraper
La pestaña Multimedia de un perfil de X (Twitter) reúne los tweets en los que una cuenta compartió fotos, videos o GIF, del más reciente al más antiguo, cada uno con su texto y sus Me gusta, respuestas, reposts y vistas. Leídos como una sola línea de tiempo, estos posts muestran qué publica visualmente una cuenta, qué clips atraen más vistas y cómo cambia con el tiempo su uso de imágenes y video.
Funcionalidades de la Twitter Media Scraper API
- La pestaña Multimedia a partir de un nombre de usuarioEnvíe un nombre de usuario, con la @ inicial opcional, y reciba los tweets de la cuenta que contienen fotos, videos o GIF en el orden de su pestaña Multimedia, del más reciente al más antiguo.
- Archivos de video con la tasa de bits más altaEn un video, media.url apunta al MP4 de mayor tasa de bits y thumbnail_url a su imagen de vista previa, de modo que los clips pueden guardarse con la mejor calidad que ofrece X.
- Todos los adjuntos de un post en una sola listamedia enumera cada imagen y cada video de un post con su tipo, así que un post con varias fotos las mantiene juntas bajo un mismo texto.
- Texto, enlace e interacción de cada postCada post también trae text, url, published_at, author y los conteos de Me gusta, comentarios, veces compartido y vistas, lo que vincula cada archivo con el post del que proviene.
Parámetros de la Twitter Media Scraper API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio | El nombre de usuario de X cuya pestaña Multimedia se recopila, con o sin la @ inicial. |
results_limit | Opcional | Cuántos posts con archivos multimedia se devuelven, de 1 a 1,000. El valor predeterminado es 20. |
Cómo usar la Twitter Media Scraper API
Envíe un nombre de usuario y recorra por páginas los posts de su pestaña Multimedia.
- Envíe {"username": "NASA", "results_limit": 20} por POST a /v1/x/user-media.
- Consulte GET /v1/tasks/{task_id} cada pocos segundos hasta que status sea succeeded.
- Lea los posts en results.items y descargue cada media.url; solicite la página siguiente con results.next_cursor mientras has_more sea 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.Casos de uso de la Twitter Media Scraper API
- Archivar las fotos y los videos de una cuenta: Descargue cada media.url y guárdelo con la url y el published_at del post para conservar una copia fechada de lo que una cuenta ha compartido.
- Encontrar los clips más vistos de una cuenta: Conserve los posts cuyo tipo de archivo multimedia es video y ordénelos por views_count y likes_count para elegir los clips con mejor rendimiento.
- Auditar la combinación de contenido visual de una marca: Cuente los posts con imágenes y con video por mes a partir de published_at y media.type para ver cómo cambia el equilibrio entre fotos y video de una marca.
- Obtener recursos visuales para informes y briefs: Use thumbnail_url y los enlaces de las imágenes junto con el texto y el conteo de vistas de cada post para ilustrar análisis de competidores o resúmenes de campañas.
Consejos de expertos para la Twitter Media Scraper API
- Nombre los archivos guardados con el id del post más la posición del adjunto en media, para que los posts con varias fotos conserven su orden.
- Para actualizar un archivo, solicite un results_limit pequeño y deje de paginar al llegar a un id de post que ya tiene, ya que los posts más recientes aparecen primero.
- Mida el ancho y el alto a partir de los archivos descargados cuando un diseño requiera dimensiones exactas.
- Quite el enlace https://t.co final de text antes de analizar los textos de los posts; X lo agrega para apuntar a los archivos multimedia adjuntos.
APIs relacionadas
Además de la Twitter Media Scraper API, use estas APIs cuando necesite otro tipo de datos públicos de X.
- Twitter Tweet Scraper API — Obtiene el texto de posts públicos, autores, interacción, contenido multimedia, hashtags, menciones y relaciones de conversación desde URLs de estado de x.com o twitter.com.
- Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
- X Post Quotes API — Recolecta posts públicos con cita de URLs de estado conocidas, con comentario, autores, interacción, contenido multimedia, marcas de tiempo y contexto del post de origen.
- X Post Replies API — Recolecta respuestas públicas de URLs de posts de X con orden seleccionable, texto de la respuesta, autores, interacción visible, contenido multimedia y contexto del post principal.
- Twitter Mentions API — Recolecta posts públicos que mencionan a una cuenta indicada.
- Twitter Video Transcript API — Convierte la voz de los videos de X en texto, con la duración de cada video.
- 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