Passer au contenu principal
Les limites de taux contrôlent le nombre de requêtes API que vous pouvez effectuer sur une période donnée. Elles garantissent une utilisation équitable et la stabilité du système au sein de l’ensemble de la plateforme.

​
Limites de taux par produit

Chaque produit de la X API dispose de son propre mécanisme de limitation de taux :

X API v2

Limites par endpoint appliquées sur des fenêtres de 15 minutes. Consultez les tableaux détaillés et les conseils de reprise.

Enterprise API

Limites personnalisées définies par votre contrat d’entreprise et votre offre de données.

X Ads API

Limites spécifiques aux endpoints de gestion des publicités et d’analytics.

​
Fonctionnement des limites de taux

ConceptDescription
Fenêtre temporelleLa plupart des limites se réinitialisent toutes les 15 minutes
Limites par utilisateurS’appliquent lorsque vous utilisez OAuth 1.0a ou des jetons utilisateur OAuth 2.0
Limites par AppS’appliquent lorsque vous utilisez l’authentification Jeton Bearer (App uniquement)
Spécifiques à l’endpointChaque endpoint a sa propre limite

​
Vérifier vos limites

Chaque réponse d’API inclut des en-têtes indiquant l’état actuel de votre limitation de débit : 
x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800
En-têteDescription
x-rate-limit-limitNombre maximal de requêtes autorisées dans la fenêtre actuelle
x-rate-limit-remainingRequêtes restantes dans la fenêtre actuelle
x-rate-limit-resetHorodatage Unix auquel la limite est réinitialisée

​
Erreurs liées aux limites de débit

Lorsque vous dépassez une limite de débit, vous recevrez une réponse 429 Too Many Requests : 
{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}

​
Bonnes pratiques

Mettre en cache les réponses

Stockez localement les réponses de l’API afin de réduire les requêtes répétées pour les mêmes données.

Utiliser un backoff exponentiel

En cas de limitation de débit, attendez avant de réessayer. Doublez le temps d’attente à chaque nouvelle tentative.

Vérifier les en-têtes

Surveillez les en-têtes de limitation de débit afin d’anticiper et d’éviter d’atteindre les limites.

Utiliser le streaming

Pour les données en temps réel, utilisez un flux filtré au lieu de sonder les points de terminaison de recherche.

​
Étapes suivantes

Pour consulter des tableaux détaillés des limites de taux par endpoint, rendez-vous sur la page des limites de taux pour votre API spécifique :