x/
user-media

Recopile la pestaña Multimedia de una cuenta de X a partir de su nombre de usuario: posts con fotos, videos y GIF del más reciente al más antiguo, con texto, Me gusta, vistas y enlaces directos a los archivos, y videos en MP4 con la tasa de bits más alta.

Twitter Media Scraper API

Nombre de usuario
Fotos, videos y GIF
MP4 de mayor tasa de bits
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
usernameObligatorioEl nombre de usuario de X cuya pestaña Multimedia se recopila, con o sin la @ inicial.
results_limitOpcionalCuá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.

  1. Envíe {"username": "NASA", "results_limit": 20} por POST a /v1/x/user-media.
  2. Consulte GET /v1/tasks/{task_id} cada pocos segundos hasta que status sea succeeded.
  3. 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.

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.

Explorar otras plataformas

Combine los datos de X con datos públicos de otras plataformas sociales compatibles.

Twitter Media Scraper API — FAQ

Twitter Media Scraper API es una interfaz programática para recopilar los posts con fotos, videos y GIF de la pestaña Multimedia de una cuenta de X a partir de su nombre de usuario. Devuelve el texto, el autor y los conteos de interacción de cada post, junto con una lista media de URL directas a los archivos y los videos en MP4 con la tasa de bits más alta.

Envíe el nombre de usuario de la cuenta, defina results_limit con la profundidad que necesite y descargue cada media.url de los posts devueltos. Cada archivo queda vinculado a su post mediante url y published_at.

En cada video, media.url es el MP4 con la tasa de bits más alta disponible y thumbnail_url ofrece la imagen de vista previa.

Sí. Los posts con GIF forman parte de la pestaña Multimedia y vuelven junto con los posts de fotos y de video, en el mismo orden del más reciente al más antiguo.

Entre 1 y 1,000, según results_limit; el valor predeterminado es 20. Los resultados se paginan, así que siga leyendo con next_cursor mientras has_more sea true.

Cada solicitud acepta un nombre de usuario. Envíe una solicitud por cuenta y combine los resultados por author.username.