API Instagram Recommended Reels

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

Read the Reels Instagram recommends on its Reels page, 10 per page; no input is needed. Each row has the same fields as a post result, except view_count. The list changes from call to call and is not a ranking.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su instagram e action impostato su recommended_reels. Prezzo $1.18 per 1.000 richieste ($0.001181 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 Recommended Reels di EveryInfra (instagram/recommended_reels).

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 recommended_reels, e inserisci i parametri in params.
- Nessun parametro obbligatorio.
- Parametri facoltativi:
  - page_token: Page token for recommended_reels. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged.
- 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, author_username, author_name, posted_at, location, id, image_url; 53 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Esempio di corpo della richiesta:
{
  "platform": "instagram",
  "action": "recommended_reels",
  "params": {}
}
- Prezzo: $1.18 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ìrecommended_reelsIdentificativo della funzionalità, valore fisso.
page_tokenbody.paramsstringNo-Page token for recommended_reels. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping the other inputs unchanged. Tokens last 24 hours and each page is one call; the last page has no next_page_token.

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": "recommended_reels",
  "params": {}
}'

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

#
Acquisita il November 21, 2026 at 07:18 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{  "id": "req_…",  "platform": "instagram",  "action": "recommended_reels",  "results": [    {      "post_id": "Df004fGz-Ig",      "url": "https://www.instagram.com/reel/Df004fGz-Ig/",      "text": "🇰🇷弘大|Odarijip 오다리집|韓星都黎打卡嘅醬蟹老店🦀\n\n弘大必試生醃醬蟹,好多藝人都到訪嘅老牌專門店。\n\n店鋪位於大廈2‑3樓,空間闊落,座位疏落唔擠迫。牆上滿滿明星簽名同打卡相,充滿老店氛圍,燈光柔和,朋友聚餐、約會都合適,整體環境乾淨舒服。\n\n蟹肉滑溜似果凍,肉質飽滿扎實,入口釋放海鮮原生鮮甜,蟹殼內蟹膏滿溢,綿密油潤,鮮味濃郁。醬汁調配得啱啱好,唔會過重掩蓋蟹本身嘅風味。\n將蟹膏、蟹肉撈埋白飯,粒粒飯吸盡鮮香,真正體驗「偷飯賊」嘅威力。\n\n人氣👌高,飯市經常需要輪候,建議早啲到。弘大逛街行程可以bookmark!\n📍Odarijip 弘大…",      "media_type": "video",      "like_count": 1336,      "comment_count": 29,      "author_username": "y•••7",      "author_name": "i•••y",      "posted_at": "2026-11-17T02:15:30+00:00",      "location": "香港",      "id": "•••",      "image_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/905867834_1120715444164288_8231478405717265133_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ig_cache_key=NDAzMjA4MDE0NjUxMjk5NDg0ODExMjA3MTU0Mzc0OTc2MjI%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX…",      "video_url": "https://scontent-lax7-1.cdninstagram.com/o1/v/t2/f2/m86/AQOheRgHDZfLQyMWaSxdUyIfPMIkdGjWOxmBEWiGq1sPvcCfhiM2JzNNqor35cI_6Cd7akhRLuC0SR_nE2_jJ_feHKaTcTm5FI5Zjzo.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-lax7-1.cdninstagram.com&_nc_ohc=ICPFAqdR2-cQ7kNvwF8VIPn&efg=eyJ2ZW5jb2RlX…",      "author_id": "•••",      "width": 1080,      "height": 1920,      "is_comments_disabled": false,      "hashtags": [        "弘大美食",        "Odarijip",        "오다리집"      ],      "product_type": "clips",      "share_count": 2638,      "repost_count": 112,      "duration_sec": 41,      "duration_estimated": true,      "video_url_expires_at": "2026-11-22T17:26:31+00:00",      "video_hd_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQMl_kNdQFW0sBrWxfCE0jgqZLDf0ANbBC-dBhKzbopXTuIx9QXzGk_HhiYguCsoxXwgUqV1LHUlBduGjeCQVQoiKbkhbUkVu09asjtl5lZvOQ.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=gLMVDeP-3aIQ7kNvwHLJFhE&efg=eyJ2Z…",      "video_hd_height": 1920,      "audio_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQNarz1QtNu3JmbGzJrpMQToCXzibhqIsaPuedSxVb1T-IwU4L8A9jkwFby54hwGbJS79qopnmwk-0T1BaGDwADX5R02AWZLleoO61Q.mp4?_nc_cat=105&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=gUNRu21NicEQ7kNvwHWjx-X&efg=eyJ2ZW5jb2RlX…",      "video_hd_expires_at": "2026-11-25T15:21:26+00:00",      "is_paid_partnership": false,      "author_is_verified": true,      "author_is_private": false,      "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",      "music": {        "artist": "yuny1117",        "title": "Original audio",        "audio_id": "29040011078996048",        "is_original": true,        "is_trending": false,        "url": "https://www.instagram.com/reels/audio/29040011078996048/"      },      "platform": "instagram",      "location_detail": {        "id": "•••",        "name": "香港",        "url": "https://www.instagram.com/explore/locations/314055843/"      },      "duration_seconds": 41    },    {      "post_id": "DeQLC8vB-XV",      "url": "https://www.instagram.com/reel/DeQLC8vB-XV/",      "text": "Running Into the Last Light 🐎🌅✨\nDJi drone makes it possible \nA herd of horses runs freely across the glowing green grassland as the horizon burns orange beneath a deep blue sky. With foals keeping pace beside them and endless open land ahead, this is what freedom looks like in mo…",      "media_type": "video",      "like_count": 511179,      "comment_count": 1086,      "author_username": "u•••n",      "author_name": "U•••n",      "posted_at": "2026-10-09T00:00:05+00:00",      "id": "•••",      "image_url": "https://scontent-lax3-2.cdninstagram.com/v/t51.82787-15/842492090_18635881834006763_6532142919362048035_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ig_cache_key=NDAwMzc0ODY0OTg5NjUwMjc0MTI3MTQ0Nzg5MjIyOTg1MTc%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2Rl…",      "video_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m86/AQM2_t64OHeUMHkiRrk_oXg1Fx13dHC8EsQn7qj4IoemJfIvUpgbG3jJW2XmbBs8bY50LXtPWvDOXmiZSLWZDp2wzEkz4BnWJxCfgVw.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=wZRSYNl-XEkQ7kNvwHmXjUk&efg=eyJ2ZW5jb2RlX…",      "author_id": "•••",      "width": 1080,      "height": 1920,      "is_comments_disabled": false,      "hashtags": [        "HorseHerd",        "GrasslandLife",        "skypixel"      ],      "product_type": "clips",      "share_count": 60416,      "repost_count": 18769,      "duration_sec": 8,      "duration_estimated": true,      "video_url_expires_at": "2026-11-22T16:50:32+00:00",      "video_hd_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQPN-g2dLkgxeaSoGKlyRAv2pWmGWM1UkRFftBDUO0jdVuUhnHdK8QcM3DCbtKs8ZnhTj1cCRrKGDsWmGRa8V4tXDKhL55Yxk0zd4Dg.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=C84pV4KywUEQ7kNvwGt_uFU&efg=eyJ2ZW5jb2Rl…",      "video_hd_height": 1920,      "audio_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPDbrFss6LkseyEhe_bmqad9lEJ2BRsKkerSbbg58Yi-ojglE1qQF6hgNhDgLSOxrXDlWa3jQ9pVZZO7ri70bIitcJNpJAwkdyFhwg.mp4?_nc_cat=108&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=A1ZyzcC_ICQQ7kNvwEm4pbF&efg=eyJ2ZW5jb2RlX…",      "video_hd_expires_at": "2026-11-25T18:23:31+00:00",      "is_paid_partnership": false,      "author_is_verified": true,      "author_is_private": false,      "author_avatar_url": "https://scontent-lax3-2.cdninstagram.com/•••",      "music": {        "artist": "usmanaryan",        "title": "Original audio",        "audio_id": "38684869254489915",        "is_original": true,        "is_trending": false,        "url": "https://www.instagram.com/reels/audio/38684869254489915/"      },      "platform": "instagram",      "duration_seconds": 8    }  ],  "next_page_token": …,  "pagination": { … },  "count": 10,  "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.
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.

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