Limites de débit
Combien de requêtes par minute et par seconde, ce que coûte chaque opération, et comment réagir à un 429.
Les limites protègent la plateforme. Elles se comptent par compte (par agence pour une connexion d'agence), toutes clés et connexions du compte réunies, sur deux fenêtres : la minute, et la seconde (la rafale). Le mode test a ses propres compteurs : vos essais ne prennent rien au budget réel. Le connecteur IA a aussi les siens.
| Offre | Par minute | Par seconde |
|---|---|---|
| Essential | 120 | 10 |
| Pro | 300 | 20 |
| Team (par siège) | 300 | 20 |
| Connexion d'agence (tous ses comptes) | 1000 | 40 |
Ce que coûte une opération
Une requête coûte 1, sauf celles qui font travailler davantage la plateforme :
| Opération | Coût |
|---|---|
POST /v1/imports | 10 |
POST /v1/webhook_endpoints/{id}/deliveries/{delivery_id}/retry | 5 |
POST /v1/webhook_endpoints/{id}/test | 5 |
PUT /v1/prospects | 3 |
GET /v1/conversations | 2 |
POST /v1/prospects/search | 2 |
Les en-têtes
Chaque réponse dit où vous en êtes :
RateLimit-Policy: les deux fenêtres, par exemple"minute";q=300;w=60, "burst";q=20;w=1.RateLimit: ce qui reste dans la minute et les secondes avant sa remise à zéro, par exemple"minute";r=287;t=42.X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset: les mêmes valeurs, pour les outils qui lisent ces noms (X-RateLimit-Resetcompte des secondes, pas une date).Retry-After, sur un refus : les secondes à attendre.- Sur un refus de la limite par seconde, ces en-têtes décrivent la fenêtre de la seconde :
RateLimit: "burst";r=0;t=1,X-RateLimit-Limitvaut la limite par seconde,Retry-After: 1.
Au-delà : 429
Au-delà, la requête est refusée avec 429 rate_limited et Retry-After, et rien n'est fait. Attendez le délai, puis reprenez : les SDK le font pour vous. Lisez plutôt par pages de 100 et suivez les changements avec updated_since ou les webhooks que de relire tout en boucle.
Les limites d'envoi sont autre chose
Le nombre d'invitations et de messages par jour, les horaires d'envoi et les pauses qui protègent le compte LinkedIn ne passent jamais par un 429 : un envoi au-delà est programmé (202, status: "scheduled", scheduled_at) ou refusé avec un code qui le dit (daily_cap_reached, sends_paused). Voir les règles de Lidmeo.