> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Haz tu primera solicitud
> Empieza a usar X API en cuestión de minutos
export const Button = ({href, children}) => {
return ;
};
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](/es/x-api/getting-started/getting-access).
***
## 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:
```json theme={null}
{
"data": {
"id": "2244994945",
"name": "X Developers",
"username": "xdevelopers"
}
}
```
***
## Guía paso a paso
En la [Consola de desarrollador](https://console.x.com), dirígete a tu App y copia el Bearer Token.
Empieza con uno de estos endpoints aptos para principiantes:
| Endpoint | Qué hace |
| :--------------------------------------------------- | :------------------------------------------------------ |
| [User lookup](/es/x-api/users/lookup/introduction) | Obtiene el perfil de usuario por nombre de usuario o ID |
| [Post lookup](/es/x-api/posts/lookup/introduction) | Obtiene una publicación por ID |
| [Recent search](/es/x-api/posts/search/introduction) | Busca publicaciones 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 están en formato 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 campos
De forma predeterminada, los endpoints devuelven un conjunto mínimo de campos. 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": "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 →](/es/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 SDK oficiales:
* [Python SDK](/es/xdks/python/overview)
* [TypeScript SDK](/es/xdks/typescript/overview)
Estos gestionan automáticamente la autenticación, la paginación y la limitación de frecuencia de solicitudes.
***
## Herramientas para realizar pruebas
Pruebas visuales de la API con nuestra colección.
Ejemplos en varios lenguajes de programación.
Documentación completa del endpoint.
***
## Solución de problemas
* 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`
* 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
* 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 →](/es/x-api/fundamentals/response-codes-and-errors)
***
## Próximos pasos
Comprende OAuth para solicitudes con contexto de usuario.
Descubre lo que puedes crear.
Desarrolla más rápido con bibliotecas oficiales.
Ideas sobre qué crear.