XTwitterListas de XComunidades de XSpaces de XGuía de API

Nuevos endpoints de la API de X: listas, comunidades, Spaces, Articles y ubicación de cuentas

14 nuevos endpoints de X (Twitter) en SocQ cubren ubicación de cuentas, seguidores verificados, comprobación de seguimiento, listas, comunidades, multimedia y respuestas, Articles, Spaces y transcripciones de video.

SocQActualizado el 19 de noviembre de 202610 min de lectura

Los endpoints de X en SocQ ya devolvían perfiles públicos, publicaciones, timelines, búsqueda, respuestas, citas, seguidores y tendencias; la guía de recopilación de X/Twitter los explica. El 2026-11-17 se publicaron 14 más en la página de la plataforma X. Llegan a partes de X que los endpoints básicos no cubrían: el panel "Acerca de esta cuenta", las listas, los miembros y moderadores de comunidades, las pestañas Multimedia y Respuestas de un usuario, los Articles de formato largo, los Spaces y lo que se dice en los videos.

Esta guía los agrupa por tarea, muestra una solicitud para cada uno e indica el precio.

Respuesta rápida: envíe un cuerpo JSON a POST https://api.socq.ai/v1/x/<endpoint>. Guarde el task_id devuelto, consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y luego lea data.results.items. Los 14 endpoints cuestan 0.7 créditos ($0.0035) por resultado, con una excepción para los videos largos en Video Transcript.

Los nuevos endpoints de X de un vistazo

1 crédito de SocQ = $0.005. No hay tarifa base, así que un resultado vacío no cuesta nada.

EndpointQué devuelvePrecio
X Account Location APIPaís en el que se basa una cuenta, cómo se conecta a X, fecha de alta y cambios de nombre de usuario0.7 créditos ($0.0035) por cuenta
X Verified Followers APICuentas verificadas que siguen a un perfil0.7 créditos ($0.0035) por seguidor
Twitter Follow Checker APIIndicadores de sigue, es seguido y seguimiento mutuo para hasta 100 pares0.7 créditos ($0.0035) por par
X List Tweets APIEl timeline de una lista, del más reciente al más antiguo, con los reposts marcados0.7 créditos ($0.0035) por publicación
Twitter List Members APICuentas de una lista, como perfiles completos0.7 créditos ($0.0035) por miembro
Twitter List Followers APICuentas que siguen una lista, como perfiles completos0.7 créditos ($0.0035) por seguidor
X Communities Search APIComunidades que coinciden con una palabra clave, con número de miembros y URL0.7 créditos ($0.0035) por comunidad
X Community Members APIMiembros de una comunidad, como perfiles completos0.7 créditos ($0.0035) por miembro
X Community Moderators APIAdministradores y moderadores de una comunidad0.7 créditos ($0.0035) por moderador
Twitter Media Scraper APIPublicaciones de la pestaña Multimedia de una cuenta, con archivos en calidad completa0.7 créditos ($0.0035) por publicación
X User Replies APIRespuestas escritas por una cuenta, cada una con la publicación a la que responde0.7 créditos ($0.0035) por respuesta
X Articles APITítulo del Article, línea de vista previa, cuerpo completo, portada e interacción0.7 créditos ($0.0035) por Article
X Spaces APIEstado del Space, programación, anfitriones, oradores, oyentes y repeticiones0.7 créditos ($0.0035) por Space
Twitter Video Transcript APITexto hablado del video de una publicación, con su duración0.7 créditos ($0.0035) por video de hasta 2 minutos

Autenticación y flujo de tareas asíncronas

Todas las solicitudes se autentican con una clave de API. Se usa el mismo encabezado para el envío, el estado de la tarea y las solicitudes de resultados:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Cada recopilación se ejecuta como una tarea en segundo plano:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La llamada de envío responde de inmediato con data.task_id y data.status. Consulte la tarea con ese ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Cuando status es succeeded, la respuesta incluye result_count, credits_amount y la primera página de registros normalizados en data.results.items. limit es 50 por defecto y llega hasta 500. Si results.has_more es true, pase results.next_cursor como cursor para leer la página siguiente. Una tarea fallida incluye error_message.

Todos los endpoints de abajo también aceptan un callback_url opcional. SocQ envía un POST con un resumen de la tarea cuando esta termina; lea los registros desde el endpoint de tareas. Un tiempo de espera agotado en el cliente no cancela la tarea, así que retómela con el mismo ID en lugar de enviarla de nuevo. Un 402 significa que la cuenta se quedó sin créditos y un 429, que la clave alcanzó un límite de frecuencia o de créditos.

Una nota sobre results_limit: en Verified Followers y en los endpoints de miembros de listas y comunidades, se aplica a cada entrada, es 100 por defecto y debe ser un múltiplo de 20 entre 20 y 2000. En Communities Search debe ser un múltiplo de 10 entre 10 y 500.

Verifique cuentas y relaciones

Account Location lee el panel "Acerca de esta cuenta": country, connected_via (por ejemplo United States App Store o Web), la fecha de alta, username_changes_count y affiliate_username. Úselo para verificar influencers y detectar cuentas coordinadas. Algunas cuentas, como muchas cuentas gubernamentales, no tienen país; aun así devuelven una fila con country: null. (docs)

curl -X POST "https://api.socq.ai/v1/x/user-about" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["elonmusk", "BBCWorld"]}'

Verified Followers devuelve la lista que X muestra en la pestaña de seguidores verificados. Cada fila es un seguidor verificado (actor) vinculado a la cuenta consultada (related_actor). Úselo para dimensionar la parte influyente de una audiencia o crear una lista de contacto a partir de los seguidores de un competidor. (docs)

curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["NASA"], "results_limit": 20}'

Follow Checker compara un username con hasta 100 usernames. Cada par devuelve is_following, is_followed_by e is_mutual. Úselo para confirmar que los participantes de una campaña siguen a su marca. (docs)

curl -X POST "https://api.socq.ai/v1/x/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}'

Lea listas de X

Los tres aceptan URL públicas de listas con el formato /i/lists/{numeric_id}.

List Tweets devuelve el timeline de la lista, del más reciente al más antiguo. Los reposts se conservan y se marcan con is_repost, además de reposted_post_id y reposted_author, para que pueda filtrarlos. Una sola solicitud monitorea todo un nicho. (docs)

curl -X POST "https://api.socq.ai/v1/x/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Members exporta las cuentas de una lista como perfiles completos con biografía, ubicación, sitio web, verificación y número de seguidores, seguidos y publicaciones. Una lista seleccionada a mano es una semilla de prospección lista para usar. (docs)

curl -X POST "https://api.socq.ai/v1/x/list-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Followers devuelve las cuentas suscritas a una lista, con la misma estructura de perfil. Seguir una lista es un interés declarado en su tema, lo que las convierte en un segmento de investigación preciso. (docs)

curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

Mapee las comunidades de X

Communities Search encuentra comunidades por palabra clave, con nombre, número de miembros, banner, is_nsfw y la URL de la comunidad. (docs)

curl -X POST "https://api.socq.ai/v1/x/search-communities" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "bitcoin", "results_limit": 20}'

Pase la URL de una comunidad (/i/communities/{numeric_id}) a Community Members para obtener sus miembros como perfiles completos. (docs)

curl -X POST "https://api.socq.ai/v1/x/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 20}'

Community Moderators devuelve el equipo completo, administradores incluidos, en una sola solicitud. Son los contactos para un patrocinio o un AMA. (docs)

curl -X POST "https://api.socq.ai/v1/x/community-moderators" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"]}'

La descripción y las reglas de una comunidad se explican en la guía de detalles de comunidades, y sus publicaciones en la guía de publicaciones de comunidades.

Recopile la multimedia y las respuestas de una cuenta

Ambos aceptan un username; results_limit es 20 por defecto y acepta de 1 a 1000.

Media Scraper devuelve las publicaciones de la pestaña Multimedia de una cuenta, de la más reciente a la más antigua, con texto, interacción, vistas y los archivos multimedia. Los videos apuntan al MP4 de mayor calidad disponible. (docs)

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}'

User Replies devuelve la pestaña Respuestas de la cuenta, de la más reciente a la más antigua. Cada respuesta incluye in_reply_to con el texto, el autor, el enlace y la hora de la publicación respondida, así que cada fila se lee como un intercambio completo. (docs)

curl -X POST "https://api.socq.ai/v1/x/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "results_limit": 20}'

Para conversaciones completas, consulte la guía de contexto de hilos.

Lea Articles, Spaces y el audio de los videos

Articles recibe la URL de la publicación que publica un Article (/{username}/status/{post_id}) y devuelve title, la línea de vista previa como summary, el cuerpo completo en text, la imagen de portada, el autor y los me gusta, respuestas, citas y vistas. Una publicación que no es un Article no devuelve ninguna fila; si ninguna de las URL es un Article, la tarea falla y no se cobra. (docs)

curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/USDOL/status/2119796255089947070"]}'

Spaces recibe enlaces /i/spaces/{space_id}. Cada Space devuelve su título, status (programado, en vivo o finalizado), scheduled_start_at, anfitriones, oradores, oyentes en vivo, vistas de la repetición e is_replay_available. (docs)

curl -X POST "https://api.socq.ai/v1/x/space" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'

Video Transcript convierte lo que se dice en el video de una publicación en texto plano, con duration_seconds. Un video de hasta 2 minutos cuesta 0.7 créditos. Un video más largo cuesta 4 créditos ($0.02) por cada minuto iniciado de su duración total, así que un video de 3 minutos cuesta 12 créditos ($0.06). Las publicaciones sin video no devuelven ninguna fila y no se cobran. (docs)

curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/NASA/status/2119833829389041896"]}'

Guías relacionadas de X

Para comparar SocQ con otros proveedores de datos de X y con la API oficial, lea Precios de la API de Twitter y las mejores alternativas a la API de X, Las 7 mejores API de scraping de Twitter/X y Alternativas a TwitterAPI.io.

Preguntas frecuentes

¿Qué devuelve X Account Location API cuando X no indica ningún país?

Una fila con country en null. Los demás campos, como connected_via y la fecha de alta, se devuelven igualmente.

¿Por qué results_limit debe ser un múltiplo de 20?

Esa es la regla para Verified Followers, List Tweets, List Members, List Followers y Community Members: de 20 a 2000 en pasos de 20, aplicada a cada entrada. Communities Search usa pasos de 10, de 10 a 500.

¿Se cobran las publicaciones que no son Articles o no tienen video?

No. Esas publicaciones no devuelven ninguna fila y solo paga por las filas devueltas. Si ninguna de las URL enviadas a la API de Articles es un Article, la tarea falla y no se cobra.

¿Cuánto cuesta la transcripción de un video largo?

Hasta 2 minutos: 0.7 créditos. Más largo: 4 créditos por cada minuto iniciado de la duración total, así que 3 minutos son 12 créditos y 5 minutos son 20 créditos ($0.10).

¿Puedo comprobar muchas relaciones de seguimiento a la vez?

Sí. Follow Checker compara una cuenta con hasta 100 más en una sola solicitud, con un cobro de 0.7 créditos por par.

X API

Probar el flujo de trabajo con una URL pública de X

Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.

Ver las API de X