X API

Acceso programático a las publicaciones, usuarios, espacios y más de X

La X API te ofrece acceso programático a la conversación pública de X. Lee publicaciones, publica contenido, administra usuarios y analiza tendencias, todo a través de endpoints REST modernos con un modelo de precios flexible de pago por uso.

Primeros pasos

Crea una App y realiza tu primera solicitud en cuestión de minutos.

Referencia de la API

Explora todos los endpoints disponibles.

SDKs

Bibliotecas oficiales de Python y TypeScript.

---

​

Lo que puedes crear

Publicaciones

Busca, recupera y publica Publicaciones. Accede a cronologías, hilos y publicaciones citadas.

Usuarios

Busca usuarios y gestiona seguimientos, bloqueos y silenciamientos.

Espacios

Encuentra conversaciones de audio en vivo y sus participantes.

Mensajes directos

Envía y recibe mensajes privados.

Listas

Crea y administra listas seleccionadas de cuentas.

Tendencias

Accede a temas en tendencia según ubicación.

---

​

Precios

La X API utiliza un modelo de precios pago por uso. Sin suscripciones, sin límites mensuales: pagas solo por lo que usas.

Escalado flexible

Empieza con poco y crece. Los costos se ajustan a tu uso real.

Sin compromisos

Sin contratos ni gasto mínimo. Puedes dejar de usarlo cuando quieras.

Seguimiento en tiempo real

Supervisa el uso y los costos en tiempo real en la Consola de desarrollador.

Basado en créditos

Compra créditos por adelantado. Se descuentan a medida que usas la API.

---

​

Funciones clave

Acceso a datos

​

Objetos de datos enriquecidos

Accede a datos detallados y estructurados de publicaciones, usuarios, contenido multimedia y más:

• Publicaciones: Texto completo, métricas, entidades, anotaciones, hilos de conversación
• Usuarios: Perfiles, cantidad de seguidores, estado de verificación
• Contenido multimedia: Imágenes, videos, GIF con metadatos
• Encuestas: Opciones y recuentos de votos

Personaliza las respuestas con fields y expansions para obtener exactamente los datos que necesitas.

Streaming en tiempo real

​

Stream filtrado

Recibe publicaciones en tiempo real a medida que se publican. Define hasta 1,000 reglas de filtrado para recibir solo las publicaciones que coincidan.

# Agrega una regla
curl -X POST "https://api.x.com/2/tweets/search/stream/rules" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"add": [{"value": "from:xdevelopers"}]}'

# Conéctate al stream
curl "https://api.x.com/2/tweets/search/stream" \
  -H "Authorization: Bearer $TOKEN"

Más información sobre el stream filtrado →

Búsqueda y analítica

​

Búsqueda en el archivo completo

Busca en el historial completo de publicaciones públicas, desde 2006. Crea consultas con operadores para usuarios, palabras clave, fechas y más.

curl "https://api.x.com/2/tweets/search/all?query=AI%20lang:en" \
  -H "Authorization: Bearer $TOKEN"

​

Métricas

Accede a métricas de interacción, incluidas impresiones, Me gusta, republicaciones, respuestas y visualizaciones de video.

Más información sobre la búsqueda →

---

​

Versiones de la API

Versión	Estado	Descripción
v2	Vigente	Endpoints modernos, precios flexibles, todas las funciones nuevas
Enterprise	Disponible	Acceso de alto volumen con soporte dedicado

Utiliza X API v2 para todos los proyectos nuevos. Es donde se publican todas las nuevas funciones y mejoras.

---

​

Inicio rápido

1. Crea una cuenta de desarrollador

   Regístrate en console.x.com y crea una aplicación.

2. Obtén tus credenciales

   Genera tu Bearer Token para solicitudes solo de la aplicación (app-only).

3. Realiza una solicitud

   Prueba a buscar un usuario:

   curl "https://api.x.com/2/users/by/username/xdevelopers" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

---

​

Herramientas y bibliotecas

Python SDK

Biblioteca oficial de Python con compatibilidad asincrónica (async).

TypeScript SDK

Biblioteca oficial de TypeScript/JavaScript.

Postman

Explorador interactivo de la API.

Ver todas las bibliotecas →

---

​

Soporte

Foro de desarrolladores

Obtén ayuda de la comunidad y del equipo de X.

Centro de soporte

Preguntas frecuentes y guías para la resolución de problemas.