Volver a las API
Datos públicos de X

X Public Data API

Recopile perfiles públicos, relaciones de seguidores y seguidos, posts, respuestas, citas, quienes hicieron repost, resultados de búsqueda y tendencias actuales. Use resultados consistentes para investigación y monitoreo.

API de X disponibles

Elija la API que corresponda a su punto de partida: un nombre de usuario, la URL de un post, una lista de cuentas, una consulta de búsqueda o un WOEID numérico conocido.

x/profiles

Perfiles0.6 créditos por resultado

x/followers-list

Perfiles0.5 créditos por resultado

x/posts

Publicaciones0.5 créditos por resultado

x/post-retweeters

Perfiles0.5 créditos por resultado

x/user-posts

Publicaciones0.5 créditos por resultado

x/search

Búsqueda0.7 créditos por resultado

x/following-list

Perfiles0.5 créditos por resultado

x/post-quotes

Publicaciones0.5 créditos por resultado

x/post-replies

Comentarios0.5 créditos por resultado

x/trends

Búsqueda0.5 créditos por resultado

x/mentions

Publicaciones0.7 créditos por resultado

x/search-users

Búsqueda0.6 créditos por resultado

x/community

Perfiles0.5 créditos por resultado

x/community-posts

Publicaciones0.7 créditos por resultado

x/thread-context

Publicaciones0.5 créditos por resultado

x/user-about

Perfiles0.7 créditos por resultado

x/verified-followers

Perfiles0.7 créditos por resultado

x/list-posts

Publicaciones0.7 créditos por resultado

x/list-members

Perfiles0.7 créditos por resultado

x/list-followers

Perfiles0.7 créditos por resultado

x/community-members

Perfiles0.7 créditos por resultado

x/community-moderators

Perfiles0.7 créditos por resultado

x/search-communities

Búsqueda0.7 créditos por resultado

x/article

Publicaciones0.7 créditos por resultado

x/space

Publicaciones0.7 créditos por resultado

x/user-media

Publicaciones0.7 créditos por resultado

x/user-replies

Comentarios0.7 créditos por resultado

x/check-follow

Perfiles0.7 créditos por resultado

x/post-transcript

Publicaciones0.7 créditos por resultado

¿Qué datos de X se pueden obtener?

Cree un conjunto de datos en torno a la identidad de cuentas, contenido conocido, actividad de publicación reciente, descubrimiento de posts o temas actuales por ubicación.

Perfiles de cuentas públicas

Convierta nombres de usuario en identidad del perfil, biografía, recursos visuales, estado de la cuenta, métricas de audiencia, listas de seguidores, listas de seguidos y momento de recopilación.

Detalles de posts conocidos

Convierta URL públicas de status en detalles del post, respuestas, citas, perfiles de quienes hicieron repost, multimedia, relaciones e interacción visible.

Posts recientes por cuenta

Recopile los posts públicos recientes, sin incluir respuestas, de nombres de usuario seleccionados y compare la actividad en una lista de cuentas.

Búsqueda y descubrimiento de posts

Busque posts públicos con una consulta, elija el orden por más recientes o por más populares, y mantenga la consulta vinculada a cada coincidencia.

Tendencias actuales por WOEID

Recopile una instantánea por ubicación de los nombres de las tendencias, sus posiciones en la fuente, consultas, descripciones y horas de observación.

SocQ vs productos para desarrolladores de X

SocQ está diseñado para flujos consistentes de investigación con datos públicos. Los productos para desarrolladores de X admiten integraciones administradas por X, con sus propios productos y requisitos de autorización.

Flujo de trabajoEndpoints de X de SocQProductos para desarrolladores de X
Mejor opción paraEnriquecimiento de perfiles, investigación de posts, monitoreo y descubrimiento de temas públicosIntegraciones de aplicaciones y cuentas administradas por X
Entrada inicialNombres de usuario, URL de status, listas de cuentas, una expresión de búsqueda o WOEID conocidosSolicitudes específicas de cada producto y contexto de cuenta autorizado
AutenticaciónClave de API de SocQCredenciales de desarrollador de X y la autorización correspondiente
Forma de los datosRegistros normalizados de perfiles, posts y tendenciasRespuestas nativas de X específicas de cada producto
Modelo de procesamientoTarea asíncrona seguida de paginación de resultadosCiclo de solicitud y respuesta específico de cada producto

Cómo funciona la API de X

Todas las API de X siguen el mismo patrón de envío, seguimiento y obtención.

  1. 1. Enviar la entrada

    Envíe nombres de usuario, URL de status, una lista de cuentas, una consulta de búsqueda o WOEID numéricos a la API correspondiente.

  2. 2. Seguir la tarea

    Use task_id con /v1/tasks/{task_id} hasta que el procesamiento termine.

  3. 3. Obtener los resultados

    Lea data.results.items y use next_cursor mientras has_more sea true.

Comience con una sola solicitud a la API

Autentíquese con su clave de API de SocQ y envíe uno o más nombres de usuario de X. Posts, user posts, búsqueda y tendencias siguen el mismo flujo de tarea.

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

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso frecuentes de la API de X

Investigación de creadores y socios

Enriquezca nombres de usuario conocidos, compare señales públicas de las cuentas y cree perfiles de creadores de contenido consistentes.

Monitoreo de marcas y de mercado

Siga cuentas seleccionadas, repita búsquedas estables o capture tendencias de WOEID conocidos para crear conjuntos de datos con marcas de tiempo sobre marcas, competidores y temas.

Informes de contenido de campañas

Resuelva las URL de los posts de una campaña y organice el contenido, los autores, la multimedia, las relaciones y la interacción al momento de la recopilación.

Investigación y productos de datos

Use registros consistentes de perfiles y posts en almacenes de datos, clasificadores, índices de búsqueda, herramientas de revisión y paneles.

Límites y política de datos públicos

SocQ devuelve los datos de X de acceso público tal como aparecen cuando se ejecuta la tarea.

  • Los contadores de perfiles y la interacción de los posts son instantáneas asociadas a collected_at.
  • Los resultados de búsqueda siguen el orden seleccionado, más recientes o más populares, vigente al momento de la recopilación.
  • Las posiciones y las descripciones de las tendencias provienen de la fuente y representan el WOEID solicitado al momento de la recopilación.
  • results_limit establece un máximo, pero la cantidad devuelta depende de los registros públicos elegibles disponibles durante la tarea.
  • Las API leen solo datos públicos y no publican posts ni administran cuentas de X.

Preguntas frecuentes sobre la API de X

¿Qué puedo recopilar con la API de X?

Puede obtener perfiles públicos, listas de seguidores y seguidos, posts conocidos, posts recientes, respuestas, citas, perfiles de quienes hicieron repost, resultados de búsqueda y las tendencias actuales de WOEID numéricos conocidos.

¿Qué API de X debo elegir?

Use Profiles, Followers List o Following List para cuentas; Posts, Post Replies, Post Quotes o Post Retweeters para URL de status; User Posts para la actividad reciente de una cuenta; Search para el descubrimiento basado en consultas; y Trends para WOEID numéricos conocidos.

¿Cómo funciona el procesamiento de tareas?

Envíe una solicitud POST, consulte /v1/tasks/{task_id}, luego lea data.results.items y continúe con next_cursor mientras has_more sea true.

¿Qué incluye cada resultado?

Los resultados incluyen los campos disponibles para cada API, como la identidad del perfil, el contenido y la multimedia de los posts, o el nombre de la tendencia, su posición en la fuente, el WOEID, la consulta, la descripción y el momento de recopilación.

¿Las métricas de X son en tiempo real?

No. Los contadores de cuentas, la interacción de los posts y las posiciones de las tendencias son instantáneas. Use collected_at como hora de observación al comparar resultados.

¿Cuánto cuesta la recopilación de datos de X?

Profiles cuesta 0.6 créditos por resultado, los posts directos, los user posts y las tendencias cuestan 0.5, y los resultados de búsqueda cuestan 0.7.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.