API de X (Twitter)
Busca y consulta publicaciones, perfiles, tendencias y relaciones públicas de X mediante palabra, usuario o ID. Cada acción mantiene autor y URL del objeto devuelto.
Likes, reposts, respuestas y vistas son contadores observados, no series históricas. Las listas públicas pueden ser parciales y no incluyen mensajes directos o relaciones privadas.
Disponibilidad de la plataforma
- Salud 24 h
- 79 %
Últimos 30 días
Funciones disponibles
Cada acción de X (Twitter), qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar publicaciones en Xsearch | Busca publicaciones de X mediante keyword y orden opcional, devolviendo texto, autor e interacciones públicas. | $0.56 por 1.000 solicitudes | Saludable · salud 98 % |
Consultar un perfil de Xprofile | Resuelve un username y recoge biografía, ubicación, seguidores, seguidos y verificación visible. | $0.56 por 1.000 solicitudes | Normal |
Listar publicaciones de una cuentauser_posts | Obtiene publicaciones públicas del username, con métricas por pieza. | $0.56 por 1.000 solicitudes | Disponible · salud 88 % |
Consultar una publicación por IDpost | Consulta una publicación mediante id, con tweet_id compatible, y devuelve autor, texto, fecha e interacciones. | $0.56 por 1.000 solicitudes | Normal |
Leer respuestas de una publicacióncomments | Lee respuestas vinculadas al id o tweet_id de una publicación. | $0.56 por 1.000 solicitudes | Normal |
Consultar tendencias por paístrending | Obtiene temas en tendencia sin entrada obligatoria y permite seleccionar country. | $0.56 por 1.000 solicitudes | Normal |
Listar seguidores visiblesfollowers_list | Enumera seguidores públicos del username con perfil y contadores visibles. | $0.56 por 1.000 solicitudes | Normal |
Listar cuentas seguidasfollowing_list | Lista cuentas seguidas por el username, con ubicación y métricas públicas. | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de X (Twitter)?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar publicaciones en X Busca publicaciones de X mediante | keyword | sort | Entrega síncrona | El catálogo declara defaultLimit = 25 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform |
profileConsultar un perfil de X Resuelve un | username | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | user_id · username · display_name · bio · url · follower_count · following_count · post_count · is_verified · location · avatar_url · created_at · platform |
user_postsListar publicaciones de una cuenta Obtiene publicaciones públicas del | username | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform |
postConsultar una publicación por ID Consulta una publicación mediante | id | tweet_id | Entrega síncrona | — | $0.56 por 1.000 solicitudes | id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform |
commentsLeer respuestas de una publicación Lee respuestas vinculadas al | id | tweet_id | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform |
trendingConsultar tendencias por país Obtiene temas en tendencia sin entrada obligatoria y permite seleccionar | country | Entrega síncrona | — | $0.56 por 1.000 solicitudes | id · name · rank · volume · period · collected_at · platform | |
followers_listListar seguidores visibles Enumera seguidores públicos del | username | — | Entrega síncrona | El catálogo declara defaultLimit = 200 y maxLimit = 2000 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform |
following_listListar cuentas seguidas Lista cuentas seguidas por el | username | — | Entrega síncrona | El catálogo declara defaultLimit = 200 y maxLimit = 2000 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform |
¿Qué significan los parámetros de X (Twitter) search?
Busca publicaciones de X mediante keyword y orden opcional, devolviendo texto, autor e interacciones públicas. No busca mensajes directos ni garantiza cobertura histórica completa.
keywordObligatorio- Expresión de búsqueda para posts de X en
search. Puede incluir operadores de búsqueda de la plataforma, comofrom:osince:. Para el orden, consultasort. sortOpcional- Preferencia de orden.
latestpide primero los posts más recientes; X devuelve por defecto los resultados destacados (Top) ylatestno garantiza un orden estrictamente cronológico.
¿Qué significan los parámetros de X (Twitter) profile?
Resuelve un username y recoge biografía, ubicación, seguidores, seguidos y verificación visible. No confirma identidad, actividad actual o composición de la audiencia.
usernameObligatorio- Nombre de usuario corto de X. Puede incluir
@. No uses la URL completa del perfil.profileobtiene los datos a partir de la información del autor en posts recientes.followers_listyfollowing_listobtienen los seguidores y las cuentas seguidas visibles, respectivamente, pero no se garantiza la obtención de la red de contactos completa.X: handle y nombre visible — X distingue el handle que forma `@usuario` y la URL del perfil del nombre visible. El handle puede cambiar y liberarse; para fines de archivo o atribución, no se debe depender únicamente del nombre mostrado. · Consultada
¿Qué significan los parámetros de X (Twitter) user_posts?
Obtiene publicaciones públicas del username, con métricas por pieza. El lote no incluye mensajes privados ni garantiza todos los posts, respuestas y republicaciones.
usernameObligatorio- Nombre de usuario corto de X. Puede incluir
@. No uses la URL completa del perfil.profileobtiene los datos a partir de la información del autor en posts recientes.followers_listyfollowing_listobtienen los seguidores y las cuentas seguidas visibles, respectivamente, pero no se garantiza la obtención de la red de contactos completa.X: handle y nombre visible — X distingue el handle que forma `@usuario` y la URL del perfil del nombre visible. El handle puede cambiar y liberarse; para fines de archivo o atribución, no se debe depender únicamente del nombre mostrado. · Consultada
¿Qué significan los parámetros de X (Twitter) post?
Consulta una publicación mediante id, con tweet_id compatible, y devuelve autor, texto, fecha e interacciones. No añade el hilo completo ni permite editar o republicar.
idObligatorio- ID numérico del post para
postocomments, es decir, el número que sigue ax.com/username/status/. Se recomienda guardarlo como un string para evitar la pérdida de precisión con enteros grandes en JavaScript. No incluyas la URL completa en el campoid.X: El número de visualizaciones no equivale al número de usuarios únicos — X explica que las múltiples visualizaciones de una misma persona pueden contabilizarse varias veces y que algunas publicaciones no tienen un recuento de visualizaciones disponible. Aquí se explica el criterio de la métrica, lo que no implica que esta API pueda acceder a contenido protegido o a datos analíticos privados. · Consultada tweet_idOpcional- Entrada compatible para
id. Tiene menor prioridad queidy no anula la obligatoriedad de este.
¿Qué significan los parámetros de X (Twitter) comments?
Lee respuestas vinculadas al id o tweet_id de una publicación. Conserva cada post y sus métricas, pero no garantiza reconstruir toda la conversación.
idObligatorio- ID numérico del post para
postocomments, es decir, el número que sigue ax.com/username/status/. Se recomienda guardarlo como un string para evitar la pérdida de precisión con enteros grandes en JavaScript. No incluyas la URL completa en el campoid.X: ID de la publicación original, ID de la conversación y relaciones de respuesta — El `conversation_id` de X se refiere al ID de la publicación original que inicia la conversación, y las respuestas en múltiples niveles pueden compartirlo; para reconstruir la relación jerárquica se necesita también el identificador de la publicación principal. Esta API no expone estos campos de relación, por lo que el árbol de respuestas completo del ejemplo oficial no debe considerarse como la salida actual. · Consultada tweet_idOpcional- Entrada compatible para
id. Tiene menor prioridad queidy no anula la obligatoriedad de este.
¿Qué significan los parámetros de X (Twitter) trending?
Obtiene temas en tendencia sin entrada obligatoria y permite seleccionar country. rank y volume pertenecen a la observación; no explican el algoritmo ni forman historial.
countryOpcional- Código de región para
trending. El valor por defecto esworld(global). Admiteus,ca,mx,uk/gb,fr,de,it,es,pt,nl,dk,at,be,ch,gr,ru,tr,kr,sg,id,ph,vn,th,au,il,ae,sa,ar,br,eg,ng,ke,za,jp. Algunos nombres de países en inglés también son compatibles. Una entrada no reconocida resultará en la lista global. No es un filtro por fecha histórica ni por ubicación del usuario.X: Tendencias regionales y recomendaciones personalizadas — X distingue entre las tendencias regionales y las recomendaciones que combinan señales como la ubicación y los intereses. Esto ayuda a entender el parámetro `country`; no se promete que el orden de los resultados sea idéntico a la página de recomendaciones de un usuario específico, ni se proporcionan las puntuaciones del modelo de tendencias oficial. · Consultada
¿Qué significan los parámetros de X (Twitter) followers_list?
Enumera seguidores públicos del username con perfil y contadores visibles. La lista puede estar limitada y no autoriza contacto automatizado.
usernameObligatorio- Nombre de usuario corto de X. Puede incluir
@. No uses la URL completa del perfil.profileobtiene los datos a partir de la información del autor en posts recientes.followers_listyfollowing_listobtienen los seguidores y las cuentas seguidas visibles, respectivamente, pero no se garantiza la obtención de la red de contactos completa.X: Dirección de seguidores y seguidos — X explica por separado quién te sigue (`followers`) y a quién sigues (`following`), aclarando que el seguimiento no tiene por qué ser mutuo; las publicaciones protegidas tienen restricciones de acceso adicionales. La consulta de listas no es una operación de seguimiento masivo ni implica una ampliación de los permisos de acceso. · Consultada
¿Qué significan los parámetros de X (Twitter) following_list?
Lista cuentas seguidas por el username, con ubicación y métricas públicas. La relación puede cambiar y no prueba afinidad o interacción.
usernameObligatorio- Nombre de usuario corto de X. Puede incluir
@. No uses la URL completa del perfil.profileobtiene los datos a partir de la información del autor en posts recientes.followers_listyfollowing_listobtienen los seguidores y las cuentas seguidas visibles, respectivamente, pero no se garantiza la obtención de la red de contactos completa.X: Dirección de seguidores y seguidos — X explica por separado quién te sigue (`followers`) y a quién sigues (`following`), aclarando que el seguimiento no tiene por qué ser mutuo; las publicaciones protegidas tienen restricciones de acceso adicionales. La consulta de listas no es una operación de seguimiento masivo ni implica una ampliación de los permisos de acceso. · Consultada
Cómo usar la API de X (Twitter)
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"twitter","action":"search","params":{"keyword":"<keyword>"}}'
Guías de X (Twitter)
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Plan de seguimiento de reputación en múltiples plataformas: registra el alcance de la recolección antes de evaluar cambios negativos.
Diseña un proceso de seguimiento de reputación trazable a partir de listas de objetivos, identidades de comentarios y cursores incrementales; usa muestras locales para demostrar la deduplicación y las brechas de recolección, conserva la revisión manual y evita presentar casos de éxito de clientes.
Leer el artículo →Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →Preguntas sobre la API de X (Twitter)
¿Cómo llamo a la API de X (Twitter)?
Envía POST /api/v1/social con platform igual a twitter, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de X (Twitter)?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye text, like_count, retweet_count y reply_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de X (Twitter)?
X distingue el handle que forma @usuario y la URL del perfil del nombre visible. El handle puede cambiar y liberarse; para fines de archivo o atribución, no se debe depender únicamente del nombre mostrado.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere username; user_posts requiere username; consulta las demás acciones en la lista de funciones.
¿Las acciones de X (Twitter) responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.