API Instagram Recommended Reels
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
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
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | instagram | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | recommended_reels | Identificativo della funzionalità, valore fisso. |
page_token | body.params | string | No | - | 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
#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
#{ "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.
| Campo | Significato |
|---|---|
post_id | Shortcode del post: la parte del link dopo /p/ o /reel/ (non un ID numerico). |
url | Link al record sulla piattaforma. |
text | Testo 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_type | Solo 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_count | Like. null significa che la piattaforma o questa funzionalità non li rende noti; non equivale a 0. |
comment_count | Commenti. null significa non resi noti, non 0. |
author_username | Username dell'autore (@handle), di solito utilizzabile negli URL. |
author_name | Nome visualizzato dell'autore. |
posted_at | Data 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. |
location | Descrizione della località passata così com'è; il formato varia in base alla piattaforma. |
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
video_url | URL 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_id | ID univoco dell'autore sulla piattaforma. |
width | Larghezza dell'immagine o del video originale, in pixel. |
height | Altezza dell'immagine o del video originale, in pixel. |
is_comments_disabled | Indica se i commenti sono disattivati nel post. |
author_follower_count | Numero di follower dell'autore. null significa non reso noto. |
hashtags | Hashtag presenti nel testo, in ordine di apparizione; assente se non ce ne sono. |
top_comments | Alcuni 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_type | Formato del contenuto secondo la classificazione di Instagram: feed (post normale), clips (Reels), carousel_container (carosello), longform (video lungo). |
play_count | Numero di riproduzioni. |
fb_play_count | Numero di riproduzioni su Facebook, quando l'autore ha pubblicato questo post anche su Facebook; compare solo in questi post. |
fb_like_count | Numero di Mi piace su Facebook, quando l'autore ha pubblicato questo post anche su Facebook; compare solo in questi post. |
fb_comment_count | Numero di commenti su Facebook, quando l'autore ha pubblicato questo post anche su Facebook; compare solo in questi post. |
share_count | Condivisioni. null significa non rese note, non 0. |
repost_count | Repost (distinti dai post con citazione). null significa non resi noti. |
duration_sec | Durata, in secondi. |
duration_seconds | Durata in secondi. null per i contenuti che non sono video o audio. |
duration_estimated | true 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_count | Numero di immagini: 1 per un post con una sola immagine; per un post carosello, il numero di immagini che contiene, video esclusi. |
video_count | Numero di video in un post carosello; presente solo nei post carosello. |
video_url_expires_at | Ora di scadenza di video_url, ISO 8601, UTC. |
video_hd_url | Traccia 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_height | Altezza dell'immagine di video_hd_url, in pixel. |
audio_url | Traccia 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_at | Ora di scadenza di video_hd_url, ISO 8601, UTC; audio_url scade all'incirca nello stesso momento. |
is_paid_partnership | Indica se il post è contrassegnato come "Partnership pagata" ("Paid partnership"). Compare solo quando la pagina fornisce questa informazione e può essere false. |
is_pinned | Indica 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_hidden | L'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_edited | La didascalia è stata modificata. Compare solo se modificata, con valore true. |
accessibility_caption | Descrizione dell'immagine generata automaticamente da Instagram (testo alternativo, in inglese). |
author_is_verified | Indica 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_private | Indica se l'account dell'autore è privato. |
author_avatar_url | URL dell'avatar dell'autore; link firmato con scadenza. |
posted_at_estimated | true 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). |
mentions | Username menzionati con @ nel testo, come array. |
tagged_users | Username delle persone taggate nelle immagini o nei video, come array; per un post carosello contano i tag su tutti gli elementi. |
coauthors | Coautori: username degli account indicati insieme all'autore in questo post, come array. |
sponsors | Username degli account dei brand indicati nella partnership pagata, come array. |
media | Ogni 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. |
music | Musica 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. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
location_detail | Dettagli 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.