Instagram Audio Reels
I Reels di Instagram con un audio sono video brevi pubblici associati a un identificatore audio condiviso, con didascalie, identità del creator, riferimenti ai media, timestamp ed engagement visibile. I loro record collegati alla fonte supportano la verifica della partecipazione, la ricerca creativa e il confronto dell’attività pubblica dei Reel tra diversi ID audio.
Funzionalità della Instagram Audio Reels API
- Mirare a ID audio notiInvia uno o più ID audio numerici di Instagram per raccogliere i Reels pubblici associati proprio a quegli identificatori, invece di cercare per titolo o artista.
- Raccolta indipendente per audioElabora ogni ID audio con il proprio results_limit, la propria sequenza di cursori e la deduplicazione dei record all’interno dell’input, così ogni fonte ha una raccolta con un limite.
- Record di Reel collegati alla fonteRicevi ID dei Reel, URL, didascalie, identità del creator, media, timestamp, engagement visibile e la provenienza extra.audio_id, tutti normalizzati.
Parametri della Instagram Audio Reels API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
audio_ids | Obbligatorio | Uno o più ID audio di Instagram noti, come stringhe numeriche non vuote, separati da virgole o da a capo. |
results_limit | Facoltativo | Numero massimo di record richiesti per ogni ID audio; il valore predefinito è 100 e accetta interi da 20 a 2.000. |
Come usare la Instagram Audio Reels API
Invia ID audio noti come attività asincrona, interroga il relativo ID attività e leggi i record dei Reel normalizzati con la paginazione a cursore.
- Prepara uno o più ID audio di Instagram noti, come stringhe numeriche non vuote.
- Invia con POST audio_ids, con un results_limit per audio facoltativo, a /v1/instagram/audio-reels.
- Interroga /v1/tasks/{task_id} finché lo status è succeeded o failed.
- Leggi /v1/tasks/{task_id}?limit=50 e segui results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/instagram/audio-reels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio_ids":["123456789012345"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Instagram Audio Reels API
- Verifica della partecipazione a un audio: Raggruppa per extra.audio_id gli URL dei Reel pubblici, le didascalie, i creator e i timestamp, per esaminare la partecipazione visibile attorno a un audio noto.
- Ricerca di esempi creativi: Costruisci un insieme di revisione collegato alla fonte con didascalie, identità dei creator, riferimenti ai media e URL originali dei Reel associati a ID audio selezionati.
- Confronto dell’engagement visibile: Confronta Mi piace, commenti, visualizzazioni e riproduzioni disponibili tra i Reels raccolti, mantenendo l’ID audio che ha prodotto ogni record.
Consigli degli esperti per la Instagram Audio Reels API
- Risolvi e verifica gli ID audio prima di inviarli: questo endpoint accetta identificatori numerici e non cerca l’audio per titolo del brano, artista o parola chiave.
- Pianifica volume e crediti stimati per ogni ID audio, perché results_limit si applica in modo indipendente a ciascun identificatore inviato.
- Quando combini raccolte ripetute, deduplica per ID stabile del Reel o URL canonico, tenendo extra.audio_id per l’attribuzione della fonte.
- Considera facoltativi contatori, media, campi del creator e timestamp, e interpreta la raccolta come limitata dal tetto per audio, dalla fine del feed o dal limite di 100 pagine, e non come un archivio storico completo.
API correlate
Oltre alla Instagram Audio 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 Reels API — Raccoglie Reels pubblici, media, audio, hashtag, menzioni ed engagement a partire dal nome utente.
- Instagram Comments API — Raccoglie commenti pubblici, autori, date, Mi piace e risposte dagli URL dei post.
- 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 Post Info API — Consulta URL pubblici noti di post, Reel o IGTV storici con didascalie, identità dell’autore, media, date, engagement visibile e contesto dell’input.
- Instagram Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Highlight Items 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