Limites de taux

Comprendre les limites de taux de l’API pour l’ensemble des produits pour développeurs de X

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

Concept	Description
Fenêtre temporelle	La plupart des limites se réinitialisent toutes les 15 minutes
Limites par utilisateur	S’appliquent lorsque vous utilisez OAuth 1.0a ou des jetons utilisateur OAuth 2.0
Limites par App	S’appliquent lorsque vous utilisez l’authentification Jeton Bearer (App uniquement)
Spécifiques à l’endpoint	Chaque 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ête	Description
x-rate-limit-limit	Nombre maximal de requêtes autorisées dans la fenêtre actuelle
x-rate-limit-remaining	Requêtes restantes dans la fenêtre actuelle
x-rate-limit-reset	Horodatage 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 :

• Limites de taux de X API v2
• Limites de taux de X Ads API