> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-066e8699.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Realiza tu primera solicitud
> Envía tu primera solicitud a la X API v2 en minutos usando cURL o Postman, incluyendo autenticación, selección del endpoint y análisis de la respuesta JSON.
export const Button = ({href, children}) => {
return ;
};
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](/x-api/getting-started/getting-access) 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:
```bash theme={null}
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:
```json theme={null}
{
"data": {
"id": "2244994945",
"name": "X Developers",
"username": "xdevelopers"
}
}
```
***
## Guía paso a paso
En la [Developer Console](https://console.x.com), navega a tu app y copia el Bearer Token.
Comienza con alguno de estos endpoints aptos para principiantes:
| Endpoint | Qué hace |
| :------------------------------------------------ | :---------------------------------------------------- |
| [User lookup](/x-api/users/lookup/introduction) | Obtén el perfil de usuario por nombre de usuario o ID |
| [Post lookup](/x-api/posts/lookup/introduction) | Obtén un post por ID |
| [Recent search](/x-api/posts/search/introduction) | Busca posts de los últimos 7 días |
Usa cURL, Postman o tu cliente HTTP preferido:
```bash theme={null}
# Buscar un usuario por nombre de usuario
curl "https://api.x.com/2/users/by/username/xdevelopers" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
Las respuestas son JSON. Los datos principales están en el campo `data`:
```json theme={null}
{
"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:
```bash theme={null}
curl "https://api.x.com/2/users/by/username/xdevelopers?user.fields=created_at,description,public_metrics" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
Respuesta:
```json theme={null}
{
"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 →](/x-api/fundamentals/fields)
***
## Más ejemplos
```bash theme={null}
curl "https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at,public_metrics" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```bash theme={null}
curl "https://api.x.com/2/tweets/search/recent?query=from:xdevelopers&tweet.fields=created_at" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```bash theme={null}
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 theme={null}
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 theme={null}
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));
```
Para uso en producción, recomendamos los SDKs oficiales:
* [Python SDK](/xdks/python/overview)
* [TypeScript SDK](/xdks/typescript/overview)
Se encargan automáticamente de la autenticación, la paginación y los límites de tasa.
***
## Herramientas para pruebas
Pruebas visuales de la API con nuestra colección.
Ejemplos en múltiples lenguajes.
Documentación completa de los endpoints.
***
## Solución de problemas
* 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`
* 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
* 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 →](/x-api/fundamentals/response-codes-and-errors)
***
## Próximos pasos
Comprende OAuth para solicitudes con contexto de usuario.
Descubre lo que puedes construir.
Desarrollo más rápido con bibliotecas oficiales.
Ideas de qué crear.