API de plataforma de EveryData
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.
- Endpoint
- POST /api/v1/social
- Funciones
- 8
- Por 1.000
- 0,556 US$
Funciones disponibles
Compara las acciones de X (Twitter) por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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é 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.
¿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 la sintaxis de búsqueda de la plataforma. La ruta principal está fija enTopy, actualmente, no se puede garantizar un orden por los más recientes mediante el parámetrosort. sortOpcional- Solo una ruta de búsqueda compatible lee el valor
latest; la ruta de búsqueda principal permanece fija enTop. Actualmente, no es una condición de orden pública y estable, por lo que no debe usarse para garantizar la obtención de los resultados más recientes.
¿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 visibleX 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 visibleX 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 únicosX 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 respuestaEl `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 personalizadasX 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 seguidosX 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 seguidosX 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 devuelto si la acción es 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>"}}'
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 de origen contengan 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.