Instagram Reels
I Reels di Instagram sono post video brevi con didascalie, contesto del creator, contenuti multimediali, audio, durata, hashtag, menzioni, numero di riproduzioni ed engagement visibile. Questi segnali creativi e di prestazioni supportano la ricerca sui formati, il confronto tra creator, la revisione delle campagne e l’analisi delle tendenze.
Funzionalità della Instagram Reels API
- Raccolta dei Reels di un profiloRaccogli i Reels pubblici di uno o più nomi utente Instagram con un unico formato di risposta normalizzato.
- Campi di contenuto, media ed engagementRestituisce didascalie, timestamp, riproduzioni, Mi piace, commenti, condivisioni, durata, miniature, riferimenti ai video, hashtag, menzioni e metadati dell’audio.
- Limite dei risultati richiestiUsa results_limit per limitare il numero di Reels richiesti in ogni richiesta.
- Confine dei dati pubbliciI Reels privati, con restrizioni, rimossi o visibili solo dopo l’accesso restano fuori dall’ambito dei risultati.
Parametri della Instagram Reels API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Nomi utente Instagram pubblici senza @, separati da virgole o a capo. |
results_limit | Facoltativo | Numero massimo di record che l’attività di raccolta deve richiedere. Deve essere un numero intero positivo. |
Come usare la Instagram Reels API
Invia i nomi utente pubblici come attività asincrona, interroga il relativo ID attività e leggi i record normalizzati dei Reels con la paginazione a cursore.
- Prepara uno o più nomi utente Instagram pubblici senza @.
- Invia con POST usernames e un results_limit facoltativo a /v1/instagram/reels.
- Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
- Leggi /v1/tasks/{task_id}?limit=50 e segui results.next_cursor quando ci sono altri record.
curl -X POST "https://api.socq.ai/v1/instagram/reels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["natgeo"],"results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Casi d’uso della Instagram Reels API
- Ricerca sulle prestazioni dei Reels: Raccogli riproduzioni, Mi piace, commenti, condivisioni, didascalie e timestamp pubblici per confrontare le prestazioni dei video brevi.
- Scoperta di creator: Esamina i Reels pubblici dei profili pertinenti, poi arricchisci i creator selezionati con le API dei profili o della cronologia dei post.
- Monitoraggio delle campagne: Segui i Reels pubblici legati a un lancio, a un hashtag, a una tendenza musicale, a un brief per creator o a un formato di contenuto ricorrente.
- Flussi di lavoro per archivi multimediali: Salva metadati dei Reels pubblici, miniature, URL di origine, durata, dettagli dell’audio e orari di raccolta per sistemi di revisione o reportistica.
- Analisi dell’audio: Usa i campi audio pubblici, quando disponibili, a supporto di clustering per argomento, revisione della moderazione o analisi creativa.
Consigli degli esperti per la Instagram Reels API
- Conserva ID stabili dei Reels, shortcode, URL e ID attività, così le attività di raccolta possono essere ripetute e verificate.
- Usa valori prudenti di results_limit e una logica di backoff quando raccogli elenchi estesi di Reels di profili pubblici.
- Aspettati che alcuni Reels pubblici non includano contatori, riferimenti ai video o dettagli dell’audio, a seconda della disponibilità della fonte.
- Usa la Search API per scoprire i profili e la Reels API per i Reels pubblici dei nomi utente selezionati.
- Evita di progettare flussi di lavoro basati su account privati, Reels con restrizioni o campi visibili solo dopo l’accesso.
API correlate
Oltre alla Instagram Reels API, usa queste API quando ti serve un altro tipo di dati pubblici di Instagram.
- Instagram Posts API — Raccoglie post pubblici, media, hashtag, menzioni, date ed engagement a partire dal nome utente.
- Instagram Comments API — Raccoglie commenti pubblici, autori, date, Mi piace e risposte dagli URL dei post.
- Instagram Profiles API — Recupera identità del profilo pubblico, bio, link, flag dell’account, categorie e conteggi visibili a partire dal nome utente.
- Instagram Tagged Posts API — Raccoglie i post pubblici che taggano i profili selezionati con autori, media, menzioni, contesto degli utenti taggati ed engagement.
- Instagram Transcript API — Estrae testo della trascrizione, lingua, formato, URL della fonte e shortcode dagli URL pubblici di post o Reels.
- Instagram Audio Reels API — Raccoglie i Reels pubblici a partire da un ID audio numerico noto con didascalie, creator, media, date, engagement visibile e contesto dell’audio di origine.
- Instagram Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API