Obtén acceso

Regístrate para obtener acceso a la API y obtén tus credenciales

Comienza a usar la X API en tres pasos: regístrate, crea una App y guarda tus credenciales.

---

Paso 1: Crea una cuenta de desarrollador

1. Ve a la Consola de desarrollador

   Visita console.x.com e inicia sesión con tu cuenta de X.

2. Acepta el Acuerdo de desarrollador

   Lee y acepta el Acuerdo y la Política para desarrolladores.

3. Completa tu perfil

   Proporciona información básica sobre cómo utilizarás la API.

---

Paso 2: Crea una app

Después de registrarte, crea una app para obtener tus credenciales de la API:

1. Haz clic en 'New App'

   Desde el panel principal de la Consola de desarrollador, crea una nueva app.

2. Introduce los detalles de la app

   Indica el nombre, la descripción y el caso de uso de tu app.

3. Genera credenciales

   La consola generará tus claves y tokens de API.

---

Paso 3: Guarda tus credenciales

Recibirás varias credenciales según tus necesidades de autenticación:

Credencial	Propósito
API Key & Secret	Identificar tu App. Se usan para generar tokens y firmar solicitudes OAuth 1.0a.
Bearer Token	Autenticación de App únicamente para leer datos públicos.
Access Token & Secret	Realizar solicitudes en nombre de tu propia cuenta (OAuth 1.0a).
Client ID & Secret	Autenticación OAuth 2.0 para solicitudes en contexto de usuario.

Guárdalas de inmediato. Las credenciales solo se muestran una vez. Almacénalas en un gestor de contraseñas o una bóveda segura. Si las pierdes, tendrás que regenerarlas (lo que invalida las anteriores).

---

¿Qué credenciales necesitas?

Lectura de datos públicos

Usa el Bearer Token para un acceso sencillo y de solo lectura a datos públicos.

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

Ideal para: buscar Publicaciones, consultar usuarios, leer tendencias.

Actuar como un usuario

Usa OAuth 2.0 (recomendado) o OAuth 1.0a para actuar en nombre de los usuarios.

OAuth 2.0 ofrece ámbitos de permisos granulares: solicita solo los permisos que necesitas.

Ideal para: publicar, indicar “Me gusta”, seguir, acceder a mensajes directos (MD).

Guía de OAuth 2.0 →

Actuar como tú mismo

Usa tu Access Token y Secret para hacer solicitudes como tu propia cuenta.

Estos tokens representan la cuenta que es propietaria de la App.

Ideal para: pruebas, bots personales y tu propia automatización.

---

Mejores prácticas de seguridad de credenciales

Usa variables de entorno

Nunca incluyas credenciales directamente en tu código fuente.

No hagas commits en Git

Añade los archivos de credenciales a .gitignore.

Rota las credenciales con regularidad

Regenera las credenciales periódicamente como medida de seguridad.

Usa scopes mínimos

Solicita solo los permisos de OAuth que tu App necesita.

---

Próximos pasos

Realiza tu primera solicitud

Realiza una llamada a la API con tus nuevas credenciales.

Aprende sobre autenticación

Conoce OAuth 1.0a y OAuth 2.0.