Límites de tasa de X API

Límites de tasa por endpoint para X API v2

Los límites de tasa controlan la cantidad de solicitudes que puedes hacer a cada endpoint. Si excedes los límites, recibirás un error 429 hasta que la ventana se reinicie.

---

Cómo funcionan los límites de tasa

Concepto	Descripción
Ventana de tiempo	Normalmente 15 minutos o 24 horas
Límites por usuario	Se aplican con OAuth 1.0a o tokens de usuario de OAuth 2.0
Límites por App	Se aplican con Bearer Token (solo App)
Límites por endpoint	Cada endpoint tiene sus propios límites

---

Comprobar tus límites

Los encabezados de la respuesta muestran el estado actual de tus límites de frecuencia:

x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800

Encabezado	Descripción
x-rate-limit-limit	Límite máximo de solicitudes permitidas
x-rate-limit-remaining	Solicitudes restantes en la ventana
x-rate-limit-reset	Marca de tiempo Unix cuando la ventana se restablece

---

Tablas de límites de uso

Consulta el límite de uso para cada endpoint a continuación. También puedes ver estos límites en la Consola de desarrollador.

Los límites se muestran en intervalos de 15 minutos, a menos que se indique lo contrario (por ejemplo, “/24hrs” o “/sec”).

Publicaciones (25 endpoints)

Consulta de Tweets

Método	Endpoint	Por App	Por usuario
GET	/2/tweets	3,500/15min	5,000/15min
GET	/2/tweets/:id	450/15min	900/15min

Búsqueda reciente

Método	Endpoint	Por App	Por usuario	Notas
GET	/2/tweets/search/recent	450/15min	300/15min	10 por defecto, 100 resultados como máximo; longitud de la consulta de 512 caracteres

Búsqueda en el archivo completo

Method	Endpoint	Per App	Per User	Notas
GET	/2/tweets/search/all	1/seg, 300/15 min	1/seg	10 por defecto, máximo 500 resultados; longitud máxima de la consulta: 1024 caracteres

Recuento de publicaciones

Método	Endpoint	Por App	Por usuario	Notas
GET	/2/tweets/counts/recent	300/15min	—	longitud de la consulta: 512
GET	/2/tweets/counts/all	300/15min	—	longitud de la consulta: 1024

Flujo filtrado

Método	Endpoint	Por App	Por usuario	Notas
GET	/2/tweets/search/stream	50/15min	—	1 conexión; 1000 reglas; longitud de regla: 1024; 250 publicaciones/seg
GET	/2/tweets/search/stream/rules	450/15min	—	1 conexión; 1000 reglas; longitud de regla: 1024
POST	/2/tweets/search/stream/rules	100/15min	—	1 conexión; 1000 reglas; longitud de regla: 1024

Administrar publicaciones

Método	Endpoint	Por App	Por usuario
POST	/2/tweets	10,000/24 h	100/15 min
DELETE	/2/tweets/:id	—	50/15 min

Cronologías

Método	Endpoint	Por App	Por usuario
GET	/2/users/:id/tweets	10,000/15min	900/15min
GET	/2/users/:id/mentions	450/15min	300/15min
GET	/2/users/:id/timelines/reverse_chronological	—	180/15min

Búsqueda de Me gusta

Método	Endpoint	Por App	Por usuario
GET	/2/tweets/:id/liking_users	75/15min	75/15min
GET	/2/users/:id/liked_tweets	75/15min	75/15min

Administrar Me gusta

Método	Endpoint	Por App	Por usuario
POST	/2/users/:id/likes	—	50/15 min, 1.000/24 h
DELETE	/2/users/:id/likes/:tweet_id	—	50/15 min, 1.000/24 h

Consulta de retweets

Método	Endpoint	Por App	Por usuario	Notas
GET	/2/tweets/:id/retweeted_by	75/15min	75/15min	—
GET	/2/tweets/:id/quote_tweets	75/15min	75/15min	—
GET	/2/users/reposts_of_me	—	75/15min	Hasta 100 resultados

Administrar retweets

Método	Endpoint	Por aplicación	Por usuario
POST	/2/users/:id/retweets	—	50/15min
DELETE	/2/users/:id/retweets/:tweet_id	—	50/15min

Ocultar respuestas

Método	Endpoint	Por App	Por usuario
PUT	/2/tweets/:tweet_id/hidden	—	50/15min

---

Usuarios (14 endpoints)

Consulta de usuarios

Method	Endpoint	Por App	Por usuario
GET	/2/users	300/15min	900/15min
GET	/2/users/:id	300/15min	900/15min
GET	/2/users/by	300/15min	900/15min
GET	/2/users/by/username/:username	300/15min	900/15min
GET	/2/users/me	—	75/15min

Buscar usuarios

Método	Endpoint	Por App	Por usuario
GET	/2/users/search	300/15min	900/15min

Consulta de follows

Method	Endpoint	Por App	Por usuario
GET	/2/users/:id/following	300/15min	300/15min
GET	/2/users/:id/followers	300/15min	300/15min

Administrar seguimientos

Método	Endpoint	Por App	Por usuario
POST	/2/users/:id/following	—	50/15min
DELETE	/2/users/:source_user_id/following/:target_user_id	—	50/15min

Consulta de bloqueos

Método	Endpoint	Por App	Por usuario
GET	/2/users/:id/blocking	—	15/15min

Consulta de cuentas silenciadas

Método	Endpoint	Por App	Por usuario
GET	/2/users/:id/muting	—	15/15min

Gestionar silencios

Método	Endpoint	Por aplicación	Por usuario
POST	/2/users/:id/muting	—	50/15min
DELETE	/2/users/:source_user_id/muting/:target_user_id	—	50/15min

---

Spaces (6 endpoints)

Consulta de Spaces

Method	Endpoint	Por App	Por usuario
GET	/2/spaces/:id	300/15min	300/15min
GET	/2/spaces	300/15min	300/15min
GET	/2/spaces/:id/tweets	300/15min	300/15min
GET	/2/spaces/by/creator_ids	300/15min, 1/sec	300/15min, 1/sec
GET	/2/spaces/:id/buyers	300/15min	300/15min

Buscar Spaces

Método	Endpoint	Por App	Por usuario
GET	/2/spaces/search	300/15min	300/15min

---

Mensajes Directos (8 endpoints)

Consulta de Mensajes Directos

Método	Endpoint	Por App	Por usuario
GET	/2/dm_events	—	15/15min
GET	/2/dm_events/:id	—	15/15min
GET	/2/dm_conversations/:dm_conversation_id/dm_events	—	15/15min
GET	/2/dm_conversations/with/:participant_id/dm_events	—	15/15min

Administrar Mensajes Directos

Método	Endpoint	Por App	Por usuario
POST	/2/dm_conversations	1,440/24 h	15/15 min, 1,440/24 h
POST	/2/dm_conversations/with/:participant_id/messages	1,440/24 h	15/15 min, 1,440/24 h
POST	/2/dm_conversations/:dm_conversation_id/messages	1,440/24 h	15/15 min, 1,440/24 h
DELETE	/2/dm_events/:id	4,000/24 h	300/15 min, 1,500/24 h

---

Listas (14 endpoints)

Consulta de Listas

Método	Endpoint	Por App	Por usuario
GET	/2/lists/:id	75/15min	75/15min
GET	/2/users/:id/owned_lists	15/15min	15/15min

Búsqueda de Tweets de listas

Método	Endpoint	Por App	Por usuario
GET	/2/lists/:id/tweets	900/15min	900/15min

Búsqueda de miembros de la lista

Método	Endpoint	Por App	Por usuario
GET	/2/lists/:id/members	900/15min	900/15min
GET	/2/users/:id/list_memberships	75/15min	75/15min

Administrar listas

Método	Endpoint	Por App	Por usuario
POST	/2/lists	—	300/15min
DELETE	/2/lists/:id	—	300/15min
PUT	/2/lists/:id	—	300/15min

Gestionar miembros de Listas

Método	Endpoint	Por App	Por usuario
POST	/2/lists/:id/members	—	300/15min
DELETE	/2/lists/:id/members/:user_id	—	300/15min

Administrar seguimientos de Listas

Método	Endpoint	Por App	Por usuario
POST	/2/users/:id/followed_lists	—	50/15min
DELETE	/2/users/:id/followed_lists/:list_id	—	50/15min

Listas fijadas

Método	Endpoint	Por App	Por usuario
GET	/2/users/:id/pinned_lists	15/15min	15/15min
POST	/2/users/:id/pinned_lists	—	50/15min
DELETE	/2/users/:id/pinned_lists/:list_id	—	50/15min

---

Marcadores (5 endpoints)

Consulta de marcadores

Method	Endpoint	Por App	Por usuario
GET	/2/users/:id/bookmarks	—	180/15 min
GET	/2/users/:id/bookmarks/folders	50/15 min	50/15 min
GET	/2/users/:id/bookmarks/folders/:folder_id	50/15 min	50/15 min

Administrar marcadores

Método	Endpoint	Por App	Por usuario
POST	/2/users/:id/bookmarks	—	50/15min
DELETE	/2/users/:id/bookmarks/:tweet_id	—	50/15min

---

Cumplimiento (3 endpoints)

Cumplimiento por lotes

Método	Endpoint	Por App	Por usuario
POST	/2/compliance/jobs	150/15min	—
GET	/2/compliance/jobs/:job_id	150/15min	—
GET	/2/compliance/jobs	150/15min	—

---

Uso (1 endpoint)

Método	Endpoint	Por App	Por usuario
GET	/2/usage/tweets	50/15min	—

---

Tendencias (2 endpoints)

Tendencias personalizadas

Método	Endpoint	Por App	Por usuario
GET	/2/users/personalized_trends	200/24hrs, 200/15min	100/24hrs, 10/15min

Tendencias por WOEID

Método	Endpoint	Por App	Por usuario
GET	/2/trends/by/woeid/:id	75/15min	—

---

Comunidades (2 endpoints)

Método	Endpoint	Por App	Por usuario	Notas
GET	/2/communities/:id	300/15min	300/15min	—
GET	/2/communities/search	300/15min	300/15min	100 resultados máx.

---

Analíticas (1 endpoint)

Método	Endpoint	Por App	Por usuario
GET	/2/tweets/analytics	300/15min	300/15min

---

Contenido multimedia (8 endpoints)

Método	Endpoint	Por App	Por usuario
POST	/2/media/upload	50,000/24hrs	500/15min
GET	/2/media/upload	100,000/24hrs	1,000/15min
POST	/2/media/upload/initialize	180,000/24hrs	1,875/15min
POST	/2/media/upload/:id/append	180,000/24hrs	1,875/15min
POST	/2/media/upload/:id/finalize	180,000/24hrs	1,875/15min
POST	/2/media/metadata	50,000/24hrs	500/15min
POST	/2/media/subtitles	10,000/24hrs	100/15min
DELETE	/2/media/subtitles	10,000/24hrs	100/15min

---

Actividad y webhooks

Método	Endpoint	Por App	Por usuario	Notas
GET	/2/activity/stream	450/15min	—	2 conexiones; 250 publicaciones/s
POST	/2/activity/subscriptions	500/15min	—	—
GET	/2/activity/subscriptions	500/15min	—	—
PUT	/2/activity/subscriptions/:subscription_id	500/15min	—	—
DELETE	/2/activity/subscriptions/:subscription_id	500/15min	—	—
POST	/2/webhooks	450/15min	—	—
GET	/2/webhooks	450/15min	—	—
PUT	/2/webhooks/:webhook_id	450/15min	—	—
DELETE	/2/webhooks/:webhook_id	450/15min	—	—
POST	/2/webhooks/replay	100/15min	—	—

---

Otros endpoints

Método	Endpoint	Por App	Por usuario
GET	/2/tweets/sample10/stream	100/15 min	—
GET	/2/news/:id	200/15 min	—
GET	/2/news/search	200/15 min	200/15 min
POST	/2/users/:id/dm/block	25/15 min, 1,000/24 h	10/15 min, 400/24 h
POST	/2/users/:id/dm/unblock	25/15 min, 1,000/24 h	10/15 min, 400/24 h
GET	/2/users/by/username/:username/tweets	1,500/15 min	900/15 min
GET	/2/users/by/username/:username/mentions	450/15 min	180/15 min
GET	/2/users/:id/following/spaces	300/15 min	300/15 min
GET	/2/tweets/:id/retweets	75/15 min	75/15 min
DELETE	/2/connections/all	25/15 min	25/15 min

---

Gestión de los límites de tasa

Cuando superes un límite de tasa, recibirás una respuesta 429:

{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}

Estrategia de recuperación

1. Comprueba x-rate-limit-reset para saber cuándo se reinicia la ventana
2. Espera hasta ese momento antes de volver a intentarlo
3. Utiliza una estrategia de backoff exponencial si es necesario

import time

def make_request_with_backoff(url, headers):
    response = requests.get(url, headers=headers)
    
    if response.status_code == 429:
        reset_time = int(response.headers.get('x-rate-limit-reset', 0))
        wait_time = max(reset_time - time.time(), 60)
        time.sleep(wait_time)
        return make_request_with_backoff(url, headers)
    
    return response

---

Mejores prácticas

Almacenar en caché las respuestas

Almacena los resultados localmente para reducir solicitudes repetidas.

Usar streaming

Para datos en tiempo real, usa un stream filtrado en lugar de hacer polling.

Supervisar encabezados

Realiza un seguimiento de las solicitudes restantes para evitar alcanzar los límites.

Distribuir solicitudes

Distribuye las solicitudes a lo largo del intervalo de tiempo.

---

Límites de tasa vs. facturación

Los límites de tasa y la facturación son conceptos separados:

Concepto	Propósito
Límites de tasa	Controlan la frecuencia de las solicitudes para mantener la estabilidad del sistema
Facturación por uso	Cobra por los datos obtenidos (pago por uso)

Puedes estar dentro de los límites de tasa y aun así generar costos de uso, o alcanzar los límites de tasa sin que ello implique un costo adicional.

---

Límites de tasa de Enterprise

Los clientes de Enterprise tienen límites de tasa personalizados. Póngase en contacto con su representante de cuenta o solicite acceso a Enterprise.

---

Próximos pasos

Manejo de errores

Gestiona el 429 y otros errores.

Primeros pasos

Conoce los niveles de acceso y las funcionalidades.