Rate Limits de la X API

Los rate limits controlan el número de solicitudes que puedes hacer a cada endpoint. Superar los límites da como resultado un error 429 hasta que se restablezca la ventana.

Cómo funcionan los rate limits

Concepto	Descripción
Ventana de tiempo	Normalmente 15 minutos o 24 horas
Límites por usuario	Aplican con OAuth 1.0a o tokens de usuario OAuth 2.0
Límites por app	Aplican con Bearer Token (app-only)
Por endpoint	Cada endpoint tiene sus propios límites

Consultar tus límites

Las cabeceras de respuesta muestran tu estado actual de rate limit:

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

Cabecera	Descripción
`x-rate-limit-limit`	Máximo de solicitudes permitidas
`x-rate-limit-remaining`	Solicitudes restantes en la ventana
`x-rate-limit-reset`	Timestamp Unix cuando se restablece la ventana

Tablas de rate limit

Consulta el rate limit para cada endpoint a continuación. También puedes ver estos límites en la Developer Console.

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

Posts (25 endpoints)

Tweets lookup

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

Recent search

Método	Endpoint	Por App	Por Usuario	Notas
GET	`/2/tweets/search/recent`	450/15min	300/15min	10 por defecto, 100 máx. resultados; 512 longitud de consulta

Full-archive search

Método	Endpoint	Por App	Por Usuario	Notas
GET	`/2/tweets/search/all`	1/sec, 300/15min	1/sec	10 por defecto, 500 máx. resultados; 1024 longitud de consulta

Post counts

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

Filtered stream

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

Manage posts

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

Timelines

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

Likes lookup

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

Manage likes

Método	Endpoint	Por App	Por Usuario
POST	`/2/users/:id/likes`	—	50/15min, 1,000/24hrs
DELETE	`/2/users/:id/likes/:tweet_id`	—	50/15min, 1,000/24hrs

Retweets lookup

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	100 máx. resultados

Manage retweets

Método	Endpoint	Por App	Por Usuario
POST	`/2/users/:id/retweets`	—	50/15min
DELETE	`/2/users/:id/retweets/:tweet_id`	—	50/15min

Hide replies

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

Users (14 endpoints)

Users lookup

Método	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

Search users

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

Follows lookup

Método	Endpoint	Por App	Por Usuario
GET	`/2/users/:id/following`	300/15min	300/15min
GET	`/2/users/:id/followers`	300/15min	300/15min

Manage follows

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

Blocks lookup

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

Mutes lookup

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

Manage mutes

Método	Endpoint	Por App	Por Usuario
POST	`/2/users/:id/muting`	—	50/15min
DELETE	`/2/users/:source_user_id/muting/:target_user_id`	—	50/15min

Spaces (6 endpoints)

Spaces lookup

Método	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

Search Spaces

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

Direct Messages (8 endpoints)

Direct Messages lookup

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

Manage Direct Messages

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

Lists (14 endpoints)

Lists lookup

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

List Tweets lookup

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

List member lookup

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

Manage Lists

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

Manage List members

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

Manage List follows

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

Pinned Lists

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

Bookmarks (5 endpoints)

Bookmarks lookup

Método	Endpoint	Por App	Por Usuario
GET	`/2/users/:id/bookmarks`	—	180/15min
GET	`/2/users/:id/bookmarks/folders`	50/15min	50/15min
GET	`/2/users/:id/bookmarks/folders/:folder_id`	50/15min	50/15min

Manage Bookmarks

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

Compliance (3 endpoints)

Batch compliance

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	—

Usage (1 endpoint)

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

Trends (2 endpoints)

Personalized Trends

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

Trends by WOEID

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

Communities (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 máx. resultados

Analytics (1 endpoint)

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

Media (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

Activity & Webhooks

Método	Endpoint	Por App	Por Usuario	Notas
GET	`/2/activity/stream`	450/15min	—	2 conexiones; 250 posts/sec
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/15min	—
GET	`/2/news/:id`	200/15min	—
GET	`/2/news/search`	200/15min	200/15min
POST	`/2/users/:id/dm/block`	25/15min, 1,000/24hrs	10/15min, 400/24hrs
POST	`/2/users/:id/dm/unblock`	25/15min, 1,000/24hrs	10/15min, 400/24hrs
GET	`/2/users/by/username/:username/tweets`	1,500/15min	900/15min
GET	`/2/users/by/username/:username/mentions`	450/15min	180/15min
GET	`/2/users/:id/following/spaces`	300/15min	300/15min
GET	`/2/tweets/:id/retweets`	75/15min	75/15min
DELETE	`/2/connections/all`	25/15min	25/15min

Gestión de rate limits

Cuando alcanzas un rate limit, recibirás una respuesta 429:

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

Estrategia de recuperación

Consulta x-rate-limit-reset para saber cuándo se restablece la ventana
Espera hasta ese momento antes de reintentar
Usa backoff exponencial si es necesario

Ejemplo

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

Buenas prácticas

Cachea las respuestas

Almacena los resultados localmente para reducir solicitudes repetidas.

Usa streaming

Para datos en tiempo real, usa filtered stream en lugar de polling.

Monitoriza las cabeceras

Sigue las solicitudes restantes para evitar alcanzar los límites.

Distribuye las solicitudes

Distribuye las solicitudes a lo largo de la ventana de tiempo.

Rate limits vs. facturación

Los rate limits y la facturación son cosas separadas:

Concepto	Propósito
Rate limits	Controlar la frecuencia de solicitudes para la estabilidad del sistema
Facturación de uso	Cobrar por los datos recuperados (pago por uso)

Puedes estar dentro de los rate limits pero aún así incurrir en costos de uso, o alcanzar los rate limits sin costo adicional.

Rate limits Enterprise

Los clientes Enterprise tienen rate limits personalizados. Contacta a tu gerente de cuenta o solicita acceso Enterprise.

​Cómo funcionan los rate limits

​Consultar tus límites

​Tablas de rate limit

​Posts (25 endpoints)

​Tweets lookup

​Recent search

​Full-archive search

​Post counts

​Filtered stream

​Manage posts

​Timelines

​Likes lookup

​Manage likes

​Retweets lookup

​Manage retweets

​Hide replies

​Users (14 endpoints)

​Users lookup

​Search users

​Follows lookup

​Manage follows

​Blocks lookup

​Mutes lookup

​Manage mutes

​Spaces (6 endpoints)

​Spaces lookup

​Search Spaces

​Direct Messages (8 endpoints)

​Direct Messages lookup

​Manage Direct Messages

​Lists (14 endpoints)

​Lists lookup

​List Tweets lookup

​List member lookup

​Manage Lists

​Manage List members

​Manage List follows

​Pinned Lists

​Bookmarks (5 endpoints)

​Bookmarks lookup

​Manage Bookmarks

​Compliance (3 endpoints)

​Batch compliance

​Usage (1 endpoint)

​Trends (2 endpoints)

​Personalized Trends

​Trends by WOEID

​Communities (2 endpoints)

​Analytics (1 endpoint)

​Media (8 endpoints)

​Activity & Webhooks

​Otros endpoints

​Gestión de rate limits

​Estrategia de recuperación

​Buenas prácticas

Cachea las respuestas

Usa streaming

Monitoriza las cabeceras

Distribuye las solicitudes

​Rate limits vs. facturación

​Rate limits Enterprise

​Próximos pasos

Gestión de errores

Primeros pasos

Cómo funcionan los rate limits

Consultar tus límites

Tablas de rate limit

Posts (25 endpoints)

Tweets lookup

Recent search

Full-archive search

Post counts

Filtered stream

Manage posts

Timelines

Likes lookup

Manage likes

Retweets lookup

Manage retweets

Hide replies

Users (14 endpoints)

Users lookup

Search users

Follows lookup

Manage follows

Blocks lookup

Mutes lookup

Manage mutes

Spaces (6 endpoints)

Spaces lookup

Search Spaces

Direct Messages (8 endpoints)

Direct Messages lookup

Manage Direct Messages

Lists (14 endpoints)

Lists lookup

List Tweets lookup

List member lookup

Manage Lists

Manage List members

Manage List follows

Pinned Lists

Bookmarks (5 endpoints)

Bookmarks lookup

Manage Bookmarks

Compliance (3 endpoints)

Batch compliance

Usage (1 endpoint)

Trends (2 endpoints)

Personalized Trends

Trends by WOEID

Communities (2 endpoints)

Analytics (1 endpoint)

Media (8 endpoints)

Activity & Webhooks

Otros endpoints

Gestión de rate limits

Estrategia de recuperación

Buenas prácticas

Rate limits vs. facturación

Rate limits Enterprise

Próximos pasos