instagram/
audio-reels

Raccogli i Reels pubblici di Instagram per ID audio numerici noti, con didascalie, identità del creator, media, engagement visibile, timestamp e contesto dell’audio di origine.

Instagram Audio Reels API

Ricerca per ID audio
Record di Reel pubblici
Limiti per audio
0,5 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 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

ParametriObbligatorioDescrizione
audio_idsObbligatorioUno o più ID audio di Instagram noti, come stringhe numeriche non vuote, separati da virgole o da a capo.
results_limitFacoltativoNumero 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.

  1. Prepara uno o più ID audio di Instagram noti, come stringhe numeriche non vuote.
  2. Invia con POST audio_ids, con un results_limit per audio facoltativo, a /v1/instagram/audio-reels.
  3. Interroga /v1/tasks/{task_id} finché lo status è succeeded o failed.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

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

Instagram Audio Reels API — FAQ

Instagram Audio Reels API è un’interfaccia programmatica per raccogliere i Reels pubblici di Instagram associati agli ID audio numerici inviati. Restituisce identità normalizzata dei Reel, didascalie, creator, media, timestamp, engagement visibile e contesto dell’audio di origine.

Invia un array non vuoto di stringhe numeriche che rappresentano ID audio di Instagram noti. L’endpoint non converte titoli di brani, nomi di artisti o parole chiave in ID.

results_limit accetta interi da 20 a 2.000 e ha come valore predefinito 100. Si applica separatamente a ogni ID audio, mentre la raccolta di ciascuna fonte si ferma anche alla fine del feed o al limite di 100 pagine.

Un record può includere ID del Reel, URL, testo della didascalia, ID del creator, nome utente, nome, avatar, riferimenti ai media, created_at, collected_at, conteggi visibili di Mi piace, commenti, visualizzazioni e riproduzioni, oltre a extra.audio_id.

No. I risultati sono limitati dal numero richiesto per audio, dal feed pubblico restituito dalla fonte e dal limite di raccolta di 100 pagine; anche i campi pubblici non disponibili possono restare null o assenti.

La fatturazione è di 0,5 crediti per ogni record normalizzato restituito, senza costo base. Le stime moltiplicano il results_limit per audio per il numero di ID audio inviati, mentre l’utilizzo finale segue i record effettivamente salvati.