Documentación de la API

Una API REST de datos públicos de X: perfiles, tuits, búsqueda, seguidores, listas y tendencias. Cada endpoint es un GET, devuelve JSON y cuesta una cantidad fija de tokens, indicada abajo. Las cuentas nuevas reciben 1,000 tokens cuando se confirma su correo.

¿Desarrollas con un agente de IA? El servidor MCP y las habilidades conectan Claude, Cursor y VS Code a los mismos endpoints.

Inicio rápido

Crea una cuenta y confirma tu correo.
Crea tu clave de API en la página Clave de API. Se muestra una sola vez, así que guárdala en un lugar seguro.
Envíala en el encabezado x-api-key:

Solicitud

curl "https://api.xscraper.online/api/v1/twitter/users/profile_by_username/jack" \
  -H "x-api-key: $XSCRAPER_KEY"

Autenticación

Cada solicitud necesita x-api-key: <your key>. Las claves empiezan por xs_. Cada cuenta tiene una clave; rotarla emite una nueva y detiene la anterior al instante. Guarda la clave en tu servidor. No la incluyas en código de navegador ni de móvil.

Tokens y precios

Cada llamada cuesta el precio de su endpoint. Los endpoints que aceptan count cobran un precio base más un precio por página de resultados, así que pedir más cuesta más. El precio solo se cobra cuando la llamada tiene éxito: cualquier respuesta de error se reembolsa, excepto 404 (no encontrado), que es una respuesta real y se cobra. Cada respuesta informa x-tokens-cost y x-tokens-remaining.

Endpoint	Ruta	Mín.	Máx.
Tuits
Tuits del usuario/users/tweets/:username	/users/tweets/:username	3	7
Último tuit/users/latest_tweet/:username	/users/latest_tweet/:username	1	1
Tuits y respuestas del usuario/users/replies/:username	/users/replies/:username	3	7
Tuits por ID de usuario/users/tweets_by_user_id/:userId	/users/tweets_by_user_id/:userId	3	7
Tuits y respuestas por ID de usuario/users/replies_by_user_id/:userId	/users/replies_by_user_id/:userId	3	7
Tuits con me gusta/users/likes/:username	/users/likes/:username	4	8
Tuit por ID/tweets/:tweetId	/tweets/:tweetId	1	1
Respuestas del tuit/tweets/:tweetId/replies	/tweets/:tweetId/replies	4	4
Citas del tuit/tweets/:tweetId/quotes	/tweets/:tweetId/quotes	4	4
Búsqueda
Búsqueda de usuarios/users/search_profiles	/users/search_profiles	4	6
Búsqueda de tuits/tweets/search	/tweets/search	6	14
Búsqueda avanzada/tweets/advanced_search	/tweets/advanced_search	8	12
Perfiles
Perfil por nombre de usuario/users/profile_by_username/:username	/users/profile_by_username/:username	1	1
Perfil por ID de usuario/users/profile_by_userid/:userId	/users/profile_by_userid/:userId	3	3
De nombre de usuario a ID/users/user_id/:username	/users/user_id/:username	1	1
Relaciones
Seguidores/users/followers/:userId	/users/followers/:userId	4	4
Siguiendo/users/following/:userId	/users/following/:userId	4	4
Listas
Tuits de una lista/lists/:listId/tweets	/lists/:listId/tweets	3	7
Tendencias
Tendencias/trends	/trends	2	2
Cuenta
Saldo de tokens/balance	/balance	0	0

Respuestas

Cada respuesta, de éxito o de error, usa el mismo sobre. Los datos van en data.

Éxito

{
  "success": true,
  "message": "Profile for @jack",
  "data": {
    "userId": "12",
    "username": "jack"
  },
  "errors": null
}

Error (402)

{
  "success": false,
  "message": "Not enough tokens: this call costs 14 and your balance is 10.",
  "data": null,
  "errors": [
    {
      "field": "balance",
      "message": "insufficient_tokens"
    }
  ]
}

Errores

Estado	Significado
400	Falta un parámetro o no es válido. El mensaje dice cuál.
401	Falta el x-api-key, es desconocido o está revocado.
402	Tu saldo es inferior al precio de la llamada. No se cobró nada.
403	El endpoint necesita una clave de administrador.
404	El usuario o la lista no existe o no es visible (un tuit que no está devuelve data: null). Se cobra: la consulta se ejecutó.
429	Demasiadas solicitudes por minuto en tu cuenta, o demasiadas a la vez. Espera los segundos que indica Retry-After.
503	El grupo de scrapers está ocupado. Reintenta después del encabezado Retry-After.
5xx	Fallo del origen. Se puede reintentar.

Límites de solicitudes

Cada clave puede hacer 100 solicitudes por minuto. Las respuestas incluyen X-RateLimit-Limit y X-RateLimit-Remaining; un 429 también incluye Retry-After. Las llamadas limitadas por tasa no se cobran.

Todos los endpoints

La misma lista está disponible como especificación OpenAPI 3.1 en /openapi.json y como resumen en texto plano para agentes de IA en /llms.txt.