Limiti di frequenza dell'API Instagram: chiamate ogni 24 ore e volume dei DM
L'API di Instagram assegna a ogni app un budget di chiamate per ogni account che serve: 4.800 chiamate moltiplicate per le impression dell'account nelle ultime 24 ore mobili. La messaggistica ha tariffe separate per account: 100 messaggi di testo al secondo tramite la Send API, 10 per audio o video, e 750 risposte private all'ora. Oltre il budget, le chiamate falliscono con errore 80002, e l'intestazione X-Business-Use-Case-Usage mostra quanto è stato usato.
easyCoexistence può inoltrare commenti, menzioni e DM di ogni account Instagram al tuo endpoint non appena arrivano, così un agente reagisce agli eventi invece di fare polling, e quando Meta limita una chiamata, Claude, ChatGPT o il tuo codice riceve il codice di errore e il messaggio di Meta.
Chiamate per impression che un'app può fare per un account in 24 ore mobili, messaggistica esclusa.
Risposte private per account ai commenti su post e Reel; i commenti a una diretta consentono 100 al secondo.
Chiamate della Send API per account per testo, link, reazioni e adesivi; audio o video ne consentono 10.
Post pubblicati tramite API per account in un periodo mobile di 24 ore, applicato alla pubblicazione di un container.
Il codice di errore che un'app riceve una volta raggiunto il limite di frequenza Business Use Case di Instagram.
Come conta Instagram le chiamate API?
Per coppia app e account, in 24 ore mobili. Gli endpoint di Instagram rientrano nei limiti di frequenza Business Use Case di Meta, e il numero di chiamate di un'app per un singolo account professionale è limitato a 4.800 volte le impression di quell'account: il numero di volte in cui un suo contenuto è apparso sullo schermo di qualcuno nelle ultime 24 ore. La messaggistica è contata a parte, mentre Business Discovery e Hashtag Search seguono invece i limiti di frequenza Platform di Meta.
L'utilizzo di un account influisce su un altro?
Non con questa formula. Meta mantiene il conteggio per ogni coppia app e utente dell'app, quindi un'app che serve molti account professionali ha un budget separato per ciascuno, dimensionato sulle impression proprie di quell'account. Un account i cui contenuti vengono visti più spesso ottiene più chiamate, mentre uno nuovo o poco attivo ne ottiene meno.
Quali sono i limiti della messaggistica?
Separati dal conteggio di 24 ore, e fissati per account professionale di Instagram e per API:
- Send API: 100 chiamate al secondo per testo, link, reazioni e adesivi, e 10 al secondo per audio o video.
- Risposte private: 750 chiamate all'ora per i commenti a post e Reel, e 100 al secondo per i commenti a una diretta.
- Conversations API: 2 chiamate al secondo.
Dove si inserisce il limite di pubblicazione?
Accanto al budget di chiamate, come conteggio separato dei post. La guida alla pubblicazione di Meta consente 100 post pubblicati tramite API per account in un periodo mobile di 24 ore, verificato quando viene chiamato POST /<IG_ID>/media_publish, e una chiamata oltre il limite fallisce con codice 9, sottocodice 2207042. Ciò che un post può contenere, il numero di container e content_publishing_limit appartengono ai limiti di pubblicazione.
Come segnala Meta l'utilizzo?
In un'intestazione di risposta. Le chiamate soggette ai limiti Business Use Case restituiscono X-Business-Use-Case-Usage, una stringa JSON indicizzata da un ID. Per Instagram il valore di type è instagram; call_count, total_cputime e total_time sono percentuali della quota utilizzata, e le chiamate possono essere limitate quando il tempo CPU o il tempo totale raggiunge 100. estimated_time_to_regain_access indica i minuti che un'app limitata deve attendere prima di poter chiamare di nuovo.
x-business-use-case-usage: {
"<ID>": [
{
"type": "instagram",
"call_count": 28,
"total_cputime": 12,
"total_time": 15,
"estimated_time_to_regain_access": 0
}
]
}Cosa succede al limite?
Le chiamate falliscono finché il conteggio non torna sotto la soglia. Per il limite Business Use Case di Instagram il codice di errore è 80002, e Meta avverte che le chiamate fatte mentre si è limitati si sommano al conteggio, ritardando il momento in cui le chiamate tornano a riuscire. La messaggistica è contata separatamente da questo budget, con le proprie tariffe al secondo e all'ora.
Come restare sotto i limiti?
I consigli stessi di Meta, applicati a Instagram:
- Ricevere commenti, menzioni e messaggi tramite webhook anziché con polling; Meta li raccomanda per ridurre le chiamate necessarie a un'app.
- Distribuire le chiamate in modo uniforme invece di inviarle a raffiche.
- Chiedere solo i campi di cui si ha bisogno ed evitare richieste di dati sovrapposti.
- Contare le chiamate di un batch una a una: Meta conta ogni richiesta al suo interno come una chiamata a sé.
- Fermarsi quando si è limitati, e riprendere dopo
estimated_time_to_regain_access.
Errori comuni
- Riprovare in ciclo una chiamata limitata. Meta conta le chiamate fatte mentre si è limitati, il che ritarda il momento in cui le chiamate tornano a riuscire.
- Fare polling per nuovi commenti o DM. I webhook li consegnano non appena accadono e tengono basso il conteggio delle chiamate.
- Leggere estimated_time_to_regain_access come secondi. Meta lo indica in minuti, quindi un client che aspetta quei secondi richiama mentre è ancora limitato.
- Guardare solo call_count. Anche total_cputime e total_time contano per il throttling, quindi monitorare tutte e tre le percentuali nell'intestazione.
Controlla anche ogni connessione ogni 6 ore. Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e con la prova gratuita di 3 giorni.
Domande frequenti
Quante chiamate API può fare un account Instagram al giorno?
4.800 per ogni impression che i suoi contenuti hanno avuto nelle ultime 24 ore, conteggiate per app e account, quindi un account visto più spesso ottiene più chiamate.
Cos'è l'errore 80002 dell'API Instagram?
È il limite di frequenza Business Use Case di Instagram: l'app ha esaurito il budget di chiamate per quell'account. Smetti di chiamare e aspetta il tempo indicato dall'intestazione di utilizzo.
I DM contano nella formula da 4.800?
No. La messaggistica ne è esclusa e ha tariffe proprie per account, come 100 messaggi di testo al secondo tramite la Send API.
Le risposte private condividono la tariffa dei DM?
No. Meta le assegna una tariffa propria: 750 all'ora per account per i commenti a post e Reel, e 100 al secondo per i commenti a una diretta, separate dalle tariffe della Send API per i DM.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il