API Instagram Reel con un brano musicale

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Normale
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Normale

Ultime 24 ore

Ultimi 30 giorni

Elenca i Reel di Instagram che usano un brano musicale, a partire da audio_id (l'audio_id in music di un post, o il link di una pagina audio). Ogni riga è un Reel con didascalia, numero di riproduzioni, like, commenti, durata in secondi, autore, data di pubblicazione e link del video, oltre a audio_info con titolo, artista e numero di Reel del brano. Una pagina per chiamata, fino a 12 Reel; limit non ha effetto. Passa il next_page_token della risposta precedente come page_token per la pagina successiva; l'ultima pagina non ne ha. I link dei video sono firmati e scadono.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su instagram e action impostato su audio_posts. Prezzo $0.56 per 1.000 richieste ($0.000556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Prompt per l'AI

#
Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Instagram Reel con un brano musicale di EveryInfra (instagram/audio_posts).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su instagram e action su audio_posts, e inserisci i parametri in params.
- Parametri obbligatori:
  - audio_id: Il brano per audio_posts: l'audio_id in music di un post o di un Reel, o il link di una pagina audio, ad esempio https://www.instagram.com/reels/audio/<number>/. Restituisce i Reel che usano quel brano.
- Parametri facoltativi:
  - page_token: Token di pagina per user_posts, tagged_posts, comments, followers_list, user_search, similar_profiles, comment_replies, likers, location_posts, audio_posts e explore. Omettilo per la prima pagina.
- Restituisce un elenco di record. Campi principali di ogni record: post_id (Shortcode del post: la parte del link d…), url, text, media_type (Solo due valori: video (video), like_count, comment_count, view_count, author_username, author_name, posted_at, location, id; 55 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Esempio di corpo della richiesta:
{
  "platform": "instagram",
  "action": "audio_posts",
  "params": {
    "audio_id": "29431066483154650"
  }
}
- Prezzo: $0.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìinstagramIdentificativo della piattaforma, valore fisso.
actionbodystringSìaudio_postsIdentificativo della funzionalità, valore fisso.
audio_idbody.paramsstringSì-Il brano per audio_posts: l'audio_id in music di un post o di un Reel, o il link di una pagina audio, ad esempio https://www.instagram.com/reels/audio/<number>/. Restituisce i Reel che usano quel brano. Passa l'ID come stringa. Un valore che non può essere letto viene rifiutato prima di qualsiasi addebito.
page_tokenbody.paramsstringNo-Token di pagina per user_posts, tagged_posts, comments, followers_list, user_search, similar_profiles, comment_replies, likers, location_posts, audio_posts e explore. Omettilo per la prima pagina; poi ripassa il next_page_token esattamente come l'hai ricevuto, senza cambiare gli altri parametri (tranne limit, se presente). Ogni pagina è una chiamata; i token durano 24 ore. Se non c'è next_page_token non ci sono altre pagine: pagination.stop_reason è end_of_list alla fine dell'elenco, oppure depth_limit se questa esecuzione non può andare più in profondità; in tal caso possono restare dati.

Esempi di codice

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "audio_posts",
  "params": {
    "audio_id": "29431066483154650"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

#
Non è ancora disponibile una risposta di esempio per questi parametri. Questa anteprima mostra la struttura e i campi della risposta secondo la definizione dell'API, con … come segnaposto; non è il risultato di una chiamata reale.
json
{  "id": "req_…",  "platform": "instagram",  "action": "audio_posts",  "results": [    {      "post_id": …,      "url": …,      "text": …,      "media_type": …,      "like_count": …,      "comment_count": …,      "view_count": …,      "author_username": …,      "author_name": …,      "posted_at": …,      "location": …,      "id": …,      "image_url": …,      "video_url": …,      "author_id": …,      "width": …,      "height": …,      "is_comments_disabled": …,      "author_follower_count": …,      "hashtags": …,      "top_comments": …,      "product_type": …,      "play_count": …,      "fb_play_count": …,      "fb_like_count": …,      "fb_comment_count": …,      "share_count": …,      "repost_count": …,      "duration_sec": …,      "duration_seconds": …,      "duration_estimated": …,      "image_count": …,      "video_count": …,      "video_url_expires_at": …,      "video_hd_url": …,      "video_hd_height": …,      "audio_url": …,      "video_hd_expires_at": …,      "is_paid_partnership": …,      "is_pinned": …,      "likes_hidden": …,      "caption_is_edited": …,      "accessibility_caption": …,      "author_is_verified": …,      "author_is_private": …,      "author_avatar_url": …,      "posted_at_estimated": …,      "mentions": …,      "tagged_users": …,      "coauthors": …,      "sponsors": …,      "media": …,      "music": …,      "platform": …,      "location_detail": …,      "audio_info": …    }  ],  "next_page_token": …,  "pagination": { … },  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campi della risposta

#

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

CampoSignificato
post_idShortcode del post: la parte del link dopo /p/ o /reel/ (non un ID numerico).
urlLink al record sulla piattaforma.
textTesto del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma).
media_typeSolo due valori: video (video; anche i Reels sono video) e image (immagini; anche i post carosello sono registrati come image e, quando è presente product_type, un product_type uguale a carousel_container indica un carosello).
like_countLike. null significa che la piattaforma o questa funzionalità non li rende noti; non equivale a 0.
comment_countCommenti. null significa non resi noti, non 0.
view_countVisualizzazioni o riproduzioni. null significa non rese note, non 0.
author_usernameUsername dell'autore (@handle), di solito utilizzabile negli URL.
author_nameNome visualizzato dell'autore.
posted_atData e ora di pubblicazione in formato ISO 8601, UTC (ad esempio 2026-08-07T12:34:56+00:00). Le stringhe non standard della piattaforma vengono passate così come sono, quindi esegui il parsing in modo difensivo. null significa che la piattaforma non le rende note.
locationDescrizione della località passata così com'è; il formato varia in base alla piattaforma.
idID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse.
image_urlLink all'immagine. Le funzionalità con più immagini possono restituire un array image_urls.
video_urlURL del file video: l'mp4 completo con audio, riproducibile direttamente. Per un post carosello con video è il primo video; assente se il post non è un video. Il link è firmato e scade; quando è presente video_url_expires_at, fai riferimento a quello.
author_idID univoco dell'autore sulla piattaforma.
widthLarghezza dell'immagine o del video originale, in pixel.
heightAltezza dell'immagine o del video originale, in pixel.
is_comments_disabledIndica se i commenti sono disattivati nel post.
author_follower_countNumero di follower dell'autore. null significa non reso noto.
hashtagsHashtag presenti nel testo, in ordine di apparizione; assente se non ce ne sono.
top_commentsAlcuni commenti mostrati sotto il post; ogni elemento contiene il testo (text) e l'autore del commento (author_username). Assente se non ce ne sono.
product_typeFormato del contenuto secondo la classificazione di Instagram: feed (post normale), clips (Reels), carousel_container (carosello), longform (video lungo).
play_countNumero di riproduzioni.
fb_play_countNumero di riproduzioni su Facebook, quando l'autore ha pubblicato questo post anche su Facebook; compare solo in questi post.
fb_like_countNumero di Mi piace su Facebook, quando l'autore ha pubblicato questo post anche su Facebook; compare solo in questi post.
fb_comment_countNumero di commenti su Facebook, quando l'autore ha pubblicato questo post anche su Facebook; compare solo in questi post.
share_countCondivisioni. null significa non rese note, non 0.
repost_countRepost (distinti dai post con citazione). null significa non resi noti.
duration_secDurata, in secondi.
duration_secondsDurata in secondi. null per i contenuti che non sono video o audio.
duration_estimatedtrue significa che duration_sec è un numero intero di secondi letto dal link del video, con uno scarto massimo di 1 secondo rispetto alla durata esatta. Compare solo quando la durata è stata letta in questo modo.
image_countNumero di immagini: 1 per un post con una sola immagine; per un post carosello, il numero di immagini che contiene, video esclusi.
video_countNumero di video in un post carosello; presente solo nei post carosello.
video_url_expires_atOra di scadenza di video_url, ISO 8601, UTC.
video_hd_urlTraccia video alla massima qualità: solo immagine, senza audio. Scade; l'ora di scadenza è in video_hd_expires_at. Per un video con audio, uniscila con audio_url (ad esempio combinando le due tracce con ffmpeg), oppure usa direttamente video_url.
video_hd_heightAltezza dell'immagine di video_hd_url, in pixel.
audio_urlTraccia audio del video, solo audio; scade all'incirca nello stesso momento di video_hd_url (vedi video_hd_expires_at). Assente quando il video non ha una traccia audio separata (ad esempio un video muto).
video_hd_expires_atOra di scadenza di video_hd_url, ISO 8601, UTC; audio_url scade all'incirca nello stesso momento.
is_paid_partnershipIndica se il post è contrassegnato come "Partnership pagata" ("Paid partnership"). Compare solo quando la pagina fornisce questa informazione e può essere false.
is_pinnedIndica se l'elemento è fissato. Post (user_posts, tagged_posts, recent_posts e altre azioni che restituiscono post, come location_posts, audio_posts ed explore): fissati dall'autore nella griglia del profilo o nella scheda Reels; compare solo se fissato, con valore true. Commenti (comments): fissati dall'autore del post; compare solo se fissato, con valore true. Storie in evidenza (highlights): indica se è fissata per prima nella barra delle storie in evidenza del profilo.
likes_hiddenL'autore ha nascosto il numero di Mi piace. Compare solo se nascosto, con valore true; in tal caso like_count di solito è assente.
caption_is_editedLa didascalia è stata modificata. Compare solo se modificata, con valore true.
accessibility_captionDescrizione dell'immagine generata automaticamente da Instagram (testo alternativo, in inglese).
author_is_verifiedIndica se l'account dell'autore ha il badge di verifica. Compare in user_posts, tagged_posts, location_posts, audio_posts, explore, stories e comment_replies, e nelle righe post, discover, reels, hashtag e reels_search quando ha un valore.
author_is_privateIndica se l'account dell'autore è privato.
author_avatar_urlURL dell'avatar dell'autore; link firmato con scadenza.
posted_at_estimatedtrue significa che la pagina non ha fornito l'ora di pubblicazione e posted_at è l'ora di caricamento ricavata dall'ID numerico del post (id); di solito coincide con l'ora di pubblicazione ed è anteriore a essa per i post programmati. Compare solo quando è stimata (frequente in tagged_posts).
mentionsUsername menzionati con @ nel testo, come array.
tagged_usersUsername delle persone taggate nelle immagini o nei video, come array; per un post carosello contano i tag su tutti gli elementi.
coauthorsCoautori: username degli account indicati insieme all'autore in questo post, come array.
sponsorsUsername degli account dei brand indicati nella partnership pagata, come array.
mediaOgni elemento di un post carosello, una voce per elemento: type (image o video), image_url (URL dell'immagine, per un video l'immagine di copertina; link firmato con scadenza), video_url (solo video; mp4 con audio), width e height (pixel). Presente solo nei post carosello.
musicMusica usata dal post o dal Reel, come oggetto: artist e title; alcuni contengono anche audio_id (ID della musica), is_original (true per un audio originale registrato dall'autore, false per un brano della libreria musicale), is_explicit (se un brano della libreria è contrassegnato come esplicito), is_trending (se l'audio originale è di tendenza; solo audio originale) e url (la pagina Instagram di questa musica). Per un audio originale, title di solito è Original audio e artist è lo username del suo autore. Assente se non c'è musica.
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).
location_detailDettagli del luogo associato al post, come oggetto: id (ID del luogo), name (nome del luogo, uguale a location), short_name, city, address, lat, lng, url (la pagina Instagram di questo luogo); ciascuno compare solo se disponibile. Assente se il post non ha un luogo.
audio_info(audio_posts) Il brano richiesto, uguale in ogni riga, come oggetto: audio_id, title, artist, reels_count (numero di Reel che lo usano) e url (la pagina Instagram di questo brano); ciascun campo compare solo quando disponibile.

Errori e addebiti

#
401
Chiave mancante o non valida.
402
Saldo insufficiente. Effettua prima una ricarica.
422
Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429
Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503
Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota
Nessun dato. Nessun addebito.

Errori

Google Analytics: serve il consenso Privacy