instagram/
reels

Raccogli i Reels pubblici di Instagram per uno o più nomi utente e ottieni didascalie, contenuti multimediali, durata, audio, hashtag, menzioni ed engagement visibile in formato normalizzato.

Instagram Reels API

Reels
Dati pubblici
Metadati multimediali
0,52 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
usernamesObbligatorioNomi utente Instagram pubblici senza @, separati da virgole o a capo.
results_limitFacoltativoNumero 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.

  1. Prepara uno o più nomi utente Instagram pubblici senza @.
  2. Invia con POST usernames e un results_limit facoltativo a /v1/instagram/reels.
  3. Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
  4. 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.

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.

Esplora altre piattaforme

Combina i dati di Instagram con i dati pubblici delle altre piattaforme social supportate.

Instagram Reels API — FAQ

Instagram Reels API raccoglie i Reels accessibili pubblicamente per uno o più nomi utente Instagram. Restituisce didascalie, dettagli dell’autore, riferimenti ai contenuti multimediali, durata, audio, hashtag, menzioni e conteggi di engagement visibili in formato normalizzato.

I campi più comuni sono ID del Reel, shortcode, URL, autore, didascalia, timestamp, metriche visibili, riferimenti ai contenuti multimediali, durata, hashtag, menzioni, metadati dell’audio e orario di raccolta.

L’endpoint attuale accetta uno o più nomi utente Instagram pubblici. Non accetta come input della richiesta l’URL o lo shortcode di un singolo Reel.

No. I Reels privati, con restrizioni, rimossi o visibili solo dopo l’accesso possono restituire dati limitati o nessun record, perché l’endpoint raccoglie solo risultati accessibili pubblicamente.

Può restituire riferimenti pubblici ai video quando quegli URL sono esposti dai risultati pubblici dei Reels. Alcuni Reels possono esporre solo metadati o miniature, quindi i client devono gestire i campi multimediali mancanti.

Usa frequenze di richiesta prudenti, pagine più piccole, la continuazione basata su cursore e il backoff dopo risposte 429 o simili che segnalano sovraccarico. Evita di raccogliere ripetutamente dati da un singolo profilo ad alto volume.

Sì, quando i risultati pubblici espongono i dati audio. L’oggetto audio normalizzato può includere ID, titolo, artista e URL.