La API de X Media Data ofrece a los desarrolladores una forma directa de recopilar datos públicos de X para tableros, investigación de contenido, análisis de creadores, herramientas de moderación y pipelines de automatización
Esta API se centra en tres casos de uso de alto valor:
1) Resolver un nombre de usuario en información de perfil
2) Navegar por una línea de tiempo de medios de usuario con paginación basada en cursor
3) Recuperar detalles completos a nivel de tweet a partir de un ID de tweet o una URL completa de X
Los endpoints están diseñados para el consumo de API en producción con una validación de consulta clara, un envoltorio de respuesta predecible y un modelo de autenticación ligero
La autenticación utiliza un único encabezado secreto en entornos no de desarrollo, lo que facilita la integración desde servicios backend, funciones sin servidor y automatizaciones sin código
Si está lanzando productos de escucha social, flujos de trabajo de inteligencia de creadores, herramientas de crecimiento o pipelines de enriquecimiento de contenido, esta API está diseñada para reducir el tiempo de integración mientras mantiene un comportamiento consistente en los endpoints
[PROPUESTA DE VALOR PRINCIPAL]
- Integración rápida con solo parámetros de consulta y un encabezado de autenticación
- Diseñada para cargas de trabajo operativas: búsqueda de perfiles, recorrido de medios e inspección de tweets
- Funciona bien para ETL, tableros de BI, herramientas para creadores e inteligencia de leads
- Forma REST limpia adecuada para consumidores de RapidAPI
[URL BASE Y NOTAS DE VERSIONADO]
Endpoints de X cubiertos en este listado:
- /user/info
- /user/media
- /tweet/details
[NOTAS DEL CONTRATO GLOBAL DE SOLICITUD/RESPUESTA]
Envoltorio de éxito:
- Las respuestas de la API devuelven la carga útil dentro del campo "data"
Envoltorio de error:
- Los errores de la API devuelven el campo "error"
- Las validaciones y las excepciones HTTP pueden incluir "errorDetails" cuando estén disponibles
Comportamiento de estado común en todos los endpoints:
- 200: Solicitud exitosa
- 400: La validación falló para los parámetros de consulta
- 403: La autenticación falló
- 500: Fallo en el upstream o error interno de procesamiento
IMPORTANTE:
Este listado evita intencionadamente ejemplos de carga útil fija para el objeto de datos anidados porque los datos de origen social en upstream pueden evolucionar con el tiempo. El contrato estable es el envoltorio y el comportamiento de los parámetros documentados a continuación
Utilice este punto final para resolver un identificador público X en información de perfil que puede alimentar tarjetas de cuenta, búsquedas de identidad, paneles de creadores y tuberías de enriquecimiento
Este punto final es ideal cuando necesita una búsqueda de cuenta ligera antes de realizar un análisis más profundo de la línea de tiempo o a nivel de tweet
Obtener información del perfil del usuario - Características del Endpoint
| Objeto | Descripción |
|---|---|
username |
[Requerido] username of an user |
{"data":{"id":"1360509398041378817","name":"Defense Intelligence","username":"DI313_","createdAt":1613205701,"avatarUrl":"https://pbs.twimg.com/profile_images/1773964459205181440/KJTgBai3.jpg","isBlueVerified":true,"bioDescription":"Covering International Affairs, Monitoring Threat Matrix, National Security, Intelligence, Militancy and tracking politics.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/1360509398041378817/1754337330","followersCount":339166,"followingCount":3761,"statusesCount":30413,"mediaCount":13292}}
curl --location --request GET 'https://zylalabs.com/api/12396/x+media+data+api/23441/get+user+profile+info?username=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Utilice este endpoint para obtener datos de la línea de tiempo enfocados en medios para un usuario específico de X. Es adecuado para la ingestión de feeds, el monitoreo de tendencias, trabajos de archivo y flujos de trabajo de rastreo histórico
El endpoint admite paginación basada en cursores, por lo que los clientes pueden iterar de manera segura sobre grandes líneas de tiempo en múltiples solicitudes
Obtener la línea de tiempo de medios del usuario - Características del Endpoint
| Objeto | Descripción |
|---|---|
userId |
[Requerido] id of the user |
cursor |
Opcional cursor for pagination |
{"data":{"dataItems":[{"id":"2045874068763632017","title":"","createdAt":1776609363,"totalMediaCount":1,"statistics":{"likeCount":188966,"commentCount":10423,"retweetCount":13521,"viewCount":16003821,"quoteCount":2725},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2045874002250416128","isVideo":true,"downloadUrl":"https://video.twimg.com/amplify_video/2045874002250416128/vid/avc1/720x1280/Jai7sCeUH1ZrVWFD.mp4?tag=21"}],"quoted":null},{"id":"2044788684223066396","title":"","createdAt":1776350587,"totalMediaCount":1,"statistics":{"likeCount":10336,"commentCount":601,"retweetCount":859,"viewCount":493525,"quoteCount":87},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2044788615935664128","isVideo":true,"downloadUrl":"https://video.twimg.com/amplify_video/2044788615935664128/vid/avc1/1280x720/ghkmXyJBW5eLztD_.mp4?tag=21"}],"quoted":null},{"id":"2043744899678515256","title":"","createdAt":1776101729,"totalMediaCount":1,"statistics":{"likeCount":23855,"commentCount":1071,"retweetCount":1494,"viewCount":1084509,"quoteCount":197},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2043744897640083458","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/HFzXJ_tasAIL1wZ.jpg?format=jpg&name=large"}],"quoted":null},{"id":"2039372675211301259","title":"Let’s go!","createdAt":1775059310,"totalMediaCount":1,"statistics":{"likeCount":14651,"commentCount":911,"retweetCount":914,"viewCount":338954,"quoteCount":94},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2039372673055424512","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/HE1OpB4bgAA31rJ.jpg?format=jpg&name=large"}],"quoted":null},{"id":"2020861883524247807","title":"","createdAt":1770645993,"totalMediaCount":1,"statistics":{"likeCount":23941,"commentCount":3470,"retweetCount":1403,"viewCount":7524170,"quoteCount":976},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"2020861879552499712","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/HAuLLCba4AAB2kT.jpg?format=jpg&name=large"}],"quoted":null},{"id":"1991987664766328990","title":"The Blue Moon MK1 flight vehicle that will land near Shackleton crater. We’ll soon be doing fully integrated checkout tests. At over 26 feet tall (8 meters), it’s smaller than our MK2 human lander but larger than the historic Apollo lander.","createdAt":1763761843,"totalMediaCount":1,"statistics":{"likeCount":12434,"commentCount":3739,"retweetCount":1603,"viewCount":1261663,"quoteCount":314},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1991987659888009216","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/G6T2OQCWIAAjsE_.jpg?format=jpg&name=large"}],"quoted":null},{"id":"1990806387837055153","title":"","createdAt":1763480204,"totalMediaCount":1,"statistics":{"likeCount":9880,"commentCount":1395,"retweetCount":814,"viewCount":555858,"quoteCount":96},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1990806383357489152","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/G6DD26CacAAZntT.jpg?format=jpg&name=large"}],"quoted":null},{"id":"1990796256751575547","title":"","createdAt":1763477789,"totalMediaCount":1,"statistics":{"likeCount":29743,"commentCount":2242,"retweetCount":2684,"viewCount":1362228,"quoteCount":392},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1990796247893225479","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/G6C6o8fbMAclS71.jpg?format=jpg&name=large"}],"quoted":null},{"id":"1989856098409758793","title":"","createdAt":1763253638,"totalMediaCount":1,"statistics":{"likeCount":9333,"commentCount":1753,"retweetCount":871,"viewCount":1255635,"quoteCount":150},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1989856028654268416","isVideo":true,"downloadUrl":"https://video.twimg.com/amplify_video/1989856028654268416/vid/avc1/1280x720/V3cSqVDIC-s4Tk1F.mp4?tag=21"}],"quoted":null},{"id":"1989704582025679295","title":"","createdAt":1763217513,"totalMediaCount":1,"statistics":{"likeCount":20674,"commentCount":1419,"retweetCount":1750,"viewCount":1671579,"quoteCount":393},"author":{"id":"15506669","name":"Jeff Bezos","username":"JeffBezos","createdAt":1216593516,"avatarUrl":"https://pbs.twimg.com/profile_images/1591558315254890500/ETIHb4Nl.jpg","isBlueVerified":true,"bioDescription":"Amazon. Blue Origin. Washington Post. Bezos Earth Fund. Bezos Academy.","profileBannerUrl":"https://pbs.twimg.com/profile_banners/15506669/1448361938","followersCount":7461550,"followingCount":568,"statusesCount":495,"mediaCount":214},"mediaList":[{"id":"1989704579362217984","isVideo":false,"downloadUrl":"https://pbs.twimg.com/media/G5zZxeTaYAAogOw.jpg?format=jpg&name=large"}],"quoted":null}],"pagination":{"hasNextPage":true,"nextCursor":"DAABCgABHGWxkQF___0KAAIbnNnGg5uRvwgAAwAAAAIAAA"}}}
curl --location --request GET 'https://zylalabs.com/api/12396/x+media+data+api/23442/get+user+media+timeline?userId=15506669' --header 'Authorization: Bearer YOUR_API_KEY'
Utilice este endpoint para normalizar las búsquedas de tweets a partir de entradas mixtas. Su cliente puede enviar directamente un ID de tweet o una URL completa de X, y la API resuelve el identificador interno del tweet antes de obtener los datos detallados.
Este endpoint es útil para pipelines de ingestión donde los usuarios pegan enlaces, o para sistemas que solo almacenan IDs de tweets.
Obtener detalles del tweet - Características del Endpoint
| Objeto | Descripción |
|---|---|
idOrUrl |
[Requerido] id or url of the tweet |
{"data":{"id":"2045309037848272993","title":"Tesla engineering redesigned lithium refining from physics first principles","createdAt":1776474649,"totalMediaCount":0,"statistics":{"likeCount":107713,"commentCount":3560,"retweetCount":14328,"viewCount":31523263,"quoteCount":350},"author":{"id":"44196397","name":"Elon Musk","username":"elonmusk","createdAt":1243973549,"avatarUrl":"https://pbs.twimg.com/profile_images/2035314704307081216/71U1ftM3.jpg","isBlueVerified":true,"bioDescription":"https://t.co/dDtDyVssfm","profileBannerUrl":"https://pbs.twimg.com/profile_banners/44196397/1774145451","followersCount":238604221,"followingCount":1315,"statusesCount":101597,"mediaCount":4456},"mediaList":[],"quoted":{"id":"2045303851482546505","title":"Our Lithium Refinery is designed to have a much lower carbon footprint than traditional hard rock refineries\n\n– Acid-free refining helps produce a safe coproduct\n– Water is recycled throughout production, with every drop treated & cleaned on site\n– Designed to close the loop for","createdAt":1776473412,"totalMediaCount":1,"statistics":{"likeCount":19470,"commentCount":613,"retweetCount":2627,"viewCount":30877306,"quoteCount":239},"author":{"id":"1679769205938311169","name":"Tesla North America","username":"tesla_na","createdAt":1689323193,"avatarUrl":"https://pbs.twimg.com/profile_images/1681000114607857665/FLyxuLUB.jpg","isBlueVerified":true,"bioDescription":"Building a world of amazing abundance","profileBannerUrl":"https://pbs.twimg.com/profile_banners/1679769205938311169/1689616932","followersCount":110959,"followingCount":20,"statusesCount":941,"mediaCount":229},"mediaList":[{"id":"2045302933437526016","isVideo":true,"downloadUrl":"https://video.twimg.com/amplify_video/2045302933437526016/vid/avc1/3840x2026/IEblQjFEFbwcuwQv.mp4?tag=21"}],"quoted":null}}}
curl --location --request GET 'https://zylalabs.com/api/12396/x+media+data+api/23443/get+tweet+details?idOrUrl=https://x.com/elonmusk/status/2045309037848272993' --header 'Authorization: Bearer YOUR_API_KEY'
| Encabezado | Descripción |
|---|---|
Autorización
|
[Requerido] Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito. |
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
La API devuelve varios tipos de datos: el endpoint de Información del Perfil de Usuario proporciona detalles del usuario como ID, nombre, nombre de usuario, biografía y conteo de seguidores. El endpoint de Línea de Tiempo de Medios de Usuario devuelve publicaciones de medios con estadísticas como Me gusta, comentarios y retweets. El endpoint de Detalles del Tweet ofrece información completa del tweet, incluidos los detalles del autor y los medios asociados con el tweet
Los campos clave incluyen "id," "nombre," "nombre de usuario," "descripciónBio," y "conteoDeSeguidores" para los perfiles de usuario. Para las líneas de tiempo de medios, campos como "conteoTotalDeMedios," "estadísticas," y "listaDeMedios" son esenciales. El punto final de Detalles del Tweet presenta "título," "creadoEn," y "autor," proporcionando una vista completa del tweet
Los datos de respuesta están estructurados dentro de un campo "data" que contiene la información relevante Cada respuesta de un endpoint incluye atributos específicos relacionados con los datos solicitados asegurando un formato consistente Los errores están envueltos en un campo "error" proporcionando claridad sobre los problemas encontrados durante las solicitudes
Cada punto final acepta parámetros específicos: el punto final de Información de Perfil de Usuario requiere un nombre de usuario, mientras que el punto final de Línea de Tiempo de Medios de Usuario necesita un ID de usuario. El punto final de Detalles del Tweet puede aceptar ya sea un ID de tweet o una URL completa de X. Estos parámetros permiten a los usuarios personalizar sus solicitudes para una recuperación de datos precisa
Los casos de uso típicos incluyen la creación de paneles para análisis de redes sociales la realización de investigación de contenido y el desarrollo de herramientas de inteligencia para creadores La API también es útil para tareas de moderación y pipelines de automatización lo que permite un manejo eficiente de datos para diversas aplicaciones
La precisión de los datos se mantiene a través del acceso directo a la información de la cuenta pública X garantizando actualizaciones en tiempo real El diseño de la API incluye verificaciones de validación para los parámetros de consulta lo que ayuda a prevenir errores y asegura que los datos devueltos sean confiables y actuales
Los usuarios pueden aprovechar los datos devueltos para análisis e informes integrándolos en paneles de BI o procesos de ETL La respuesta estructurada permite una fácil interpretación y manipulación lo que permite a los desarrolladores construir aplicaciones que requieren información en tiempo real de datos públicos X
Los usuarios deben verificar el campo "data" en la respuesta Si está vacío o es nulo indica que no se encontraron resultados Implementar el manejo de errores para códigos de estado como 400 o 500 puede ayudar a gestionar resultados inesperados asegurando un comportamiento robusto de la aplicación incluso con datos incompletos
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.626ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
17ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.135ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.704ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
10.167ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
511ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.932ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.016ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.819ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
636ms