Haz tu primera solicitud

Empieza a usar X API en cuestión de minutos

En esta guía aprenderás a hacer tu primera solicitud a la X API. Antes de empezar, necesitarás una cuenta de desarrollador con credenciales de App.

---

​

Inicio rápido con cURL

La forma más rápida de probar la API es con cURL. Vamos a buscar un usuario:

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

Reemplaza $BEARER_TOKEN con tu Bearer Token real. Obtendrás una respuesta como:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

---

​

Guía paso a paso

1. Obtén tu Bearer Token

   En la Consola de desarrollador, dirígete a tu App y copia el Bearer Token.

2. Elige un endpoint

   Empieza con uno de estos endpoints aptos para principiantes:

   Endpoint	Qué hace
   User lookup	Obtiene el perfil de usuario por nombre de usuario o ID
   Post lookup	Obtiene una publicación por ID
   Recent search	Busca publicaciones de los últimos 7 días

3. Realiza la solicitud

   Usa cURL, Postman o tu cliente HTTP preferido:

   # Buscar un usuario por nombre de usuario
   curl "https://api.x.com/2/users/by/username/xdevelopers" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
4. Analiza la respuesta

   Las respuestas están en formato JSON. Los datos principales están en el campo data:

   {
     "data": {
       "id": "2244994945",
       "name": "X Developers",
       "username": "xdevelopers"
     }
   }
   

---

​

Solicita más datos con campos

De forma predeterminada, los endpoints devuelven un conjunto mínimo de campos. Usa el parámetro fields para solicitar datos adicionales:

curl "https://api.x.com/2/users/by/username/xdevelopers?user.fields=created_at,description,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Respuesta:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "La voz de la Plataforma de Desarrolladores de X",
    "public_metrics": {
      "followers_count": 570842,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

Más información sobre campos →

---

​

Más ejemplos

Consultar una publicación

curl "https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Buscar publicaciones recientes

curl "https://api.x.com/2/tweets/search/recent?query=from:xdevelopers&tweet.fields=created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Obtener las publicaciones de un usuario

curl "https://api.x.com/2/users/2244994945/tweets?max_results=5" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Usar código en lugar de cURL

Python

import requests

bearer_token = "YOUR_BEARER_TOKEN"
url = "https://api.x.com/2/users/by/username/xdevelopers"

headers = {"Authorization": f"Bearer {bearer_token}"}
response = requests.get(url, headers=headers)

print(response.json())

JavaScript

const bearerToken = "YOUR_BEARER_TOKEN";
const url = "https://api.x.com/2/users/by/username/xdevelopers";

fetch(url, {
  headers: { Authorization: `Bearer ${bearerToken}` }
})
  .then(res => res.json())
  .then(data => console.log(data));

SDK oficiales

Para uso en producción, recomendamos los SDK oficiales:

• Python SDK
• TypeScript SDK

Estos gestionan automáticamente la autenticación, la paginación y la limitación de frecuencia de solicitudes.

---

​

Herramientas para realizar pruebas

Postman

Pruebas visuales de la API con nuestra colección.

Código de ejemplo

Ejemplos en varios lenguajes de programación.

Referencia de la API

Documentación completa del endpoint.

---

​

Solución de problemas

401 Unauthorized

• Verifica que tu Bearer Token sea correcto
• Asegúrate de que el token no se haya regenerado
• Verifica el formato del encabezado Authorization: Bearer YOUR_TOKEN

403 Forbidden

• Es posible que tu app no tenga acceso a este endpoint
• Algunos endpoints requieren autenticación con contexto de usuario (OAuth 1.0a o 2.0)
• Revisa los permisos de tu app en la Consola de desarrollador

429 Too Many Requests

• Has alcanzado un límite de frecuencia de solicitudes
• Revisa el encabezado x-rate-limit-reset para saber cuándo reintentar
• Implementa backoff exponencial en tu código

Referencia completa de errores →

---

​

Próximos pasos

Aprende sobre autenticación

Comprende OAuth para solicitudes con contexto de usuario.

Explora los endpoints

Descubre lo que puedes crear.

Usa un SDK

Desarrolla más rápido con bibliotecas oficiales.

Crea algo

Ideas sobre qué crear.