Realiza tu primera solicitud

Esta guía te muestra paso a paso cómo realizar tu primera solicitud a la X API. Necesitarás una cuenta de desarrollador con credenciales de app antes de comenzar.

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 esta:

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

Guía paso a paso

Obtén tu Bearer Token

En la Developer Console, navega a tu app y copia el Bearer Token.

Elige un endpoint

Comienza con alguno de estos endpoints aptos para principiantes:

Endpoint	Qué hace
User lookup	Obtén el perfil de usuario por nombre de usuario o ID
Post lookup	Obtén un post por ID
Recent search	Busca posts de los últimos 7 días

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"

Analiza la respuesta

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

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

Solicita más datos con fields

Por defecto, los endpoints devuelven campos mínimos. 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": "The voice of the X Developer Platform",
    "public_metrics": {
      "followers_count": 570842,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

Más información sobre fields →

Más ejemplos

Buscar un post
Buscar posts recientes
Obtener los posts de un usuario

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

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

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
JavaScript
SDKs oficiales

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())

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));

Herramientas para pruebas

Postman

Pruebas visuales de la API con nuestra colección.

Código de muestra

Ejemplos en múltiples lenguajes.

Referencia de la API

Documentación completa de los endpoints.

Solución de problemas

401 Unauthorized

Verifica que tu Bearer Token sea correcto
Asegúrate de que el token no haya sido 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 de contexto de usuario (OAuth 1.0a o 2.0)
Verifica los permisos de tu app en la Developer Console

429 Too Many Requests

Alcanzaste un límite de tasa
Consulta el encabezado x-rate-limit-reset para saber cuándo reintentar
Implementa retroceso 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 construir.

Usa un SDK

Desarrollo más rápido con bibliotecas oficiales.

Construye algo

Ideas de qué crear.

​Inicio rápido con cURL

​Guía paso a paso

​Solicita más datos con fields

​Más ejemplos

​Usar código en lugar de cURL

​Herramientas para pruebas