instagram/
trending-reels

Raccogli l’insieme attuale di Reel esposto dal feed di tendenza senza selettori, con didascalie, autori, contenuti multimediali, timestamp ed engagement visibile.

Instagram Trending Reels API

Nessun selettore in input
Istantanea attuale del feed
Record normalizzati dei Reel
0,5 crediti per risultato
Pronto
README

A cura di SocQ · Aggiornato il

Instagram Trending Reels

I Reels di tendenza di Instagram sono video brevi pubblici proposti in un feed di scoperta attuale, con didascalie, identità del creator, contenuti multimediali, timestamp e segnali di engagement visibili. Questi record istantanei supportano la revisione creativa, il monitoraggio della scoperta, il confronto tra contenuti e la successiva ricerca sui Reels.

Funzionalità della Instagram Trending Reels API

  • Istantanea del feed senza selettoriAcquisisci l’insieme attuale di Reel esposto dal feed di tendenza senza fornire query, account, hashtag, regione o filtro per data.
  • Record normalizzati dei ReelRicevi in un unico formato identità del Reel, URL pubblici, didascalie, contesto dell’autore, metadati dei contenuti multimediali, timestamp e conteggi visibili di Mi piace, commenti, visualizzazioni e riproduzioni.
  • Eliminazione dei duplicatiUnifica le righe ripetute del feed per ID del Reel, chiave primaria o shortcode prima che i record normalizzati vengano salvati.

Parametri della Instagram Trending Reels API

Pronto per l’invio

Questo endpoint non richiede parametri nella richiesta. Invia l’oggetto JSON vuoto così com’è.

{}

Come usare la Instagram Trending Reels API

Invia un oggetto JSON vuoto come attività asincrona, interroga il relativo ID attività e leggi i record dell’istantanea salvata con la paginazione a cursore dei risultati.

  1. Prepara un oggetto JSON vuoto.
  2. Invia con POST il corpo della richiesta a /v1/instagram/trending-reels.
  3. Interroga /v1/tasks/{task_id} finché lo stato diventa 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/trending-reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della Instagram Trending Reels API

  • Inventario attuale della scoperta: Salva ID dei Reel, URL pubblici, didascalie, identità dei creator e orari di raccolta come registro consultabile dell’istantanea attuale del feed.
  • Revisione creativa dei video brevi: Esamina testo delle didascalie, contesto degli autori, miniature, riferimenti ai video, dimensioni e durata per valutare gli esempi creativi presenti in una singola istantanea.
  • Confronto dell’engagement all’interno di un’istantanea: Confronta Mi piace, commenti, visualizzazioni, riproduzioni e orari di creazione visibili sui Reels restituiti dalla stessa attività di raccolta.

Consigli degli esperti per la Instagram Trending Reels API

  • Invia solo un oggetto vuoto; i campi query, region, username, hashtag, date e results_limit vengono rifiutati.
  • Considera ogni risposta come l’istantanea del feed definita dalla fonte al momento della raccolta, non come una formula di classifica ufficiale né come una dichiarazione di copertura globale o regionale.
  • Non richiedere una pagina successiva a monte; results.next_cursor prosegue solo tra i record già salvati per l’attività completata.
  • Quando conservi istantanee ripetute, deduplica tra le attività con ID o URL stabili dei Reel, perché l’eliminazione dei duplicati si applica all’interno di ogni risposta del feed.
  • Salva collected_at con ogni risultato quando costruisci una tua serie temporale, perché questo endpoint non fornisce istantanee storiche né pianificazione.
  • Gestisci didascalie, campi dell’autore, contatori, contenuti multimediali, URL e orari di creazione come campi pubblici che possono essere nulli.

Oltre alla Instagram Trending 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 Trending Reels API — FAQ

Instagram Trending Reels API è un’interfaccia programmatica per raccogliere l’insieme pubblico attuale di Reel esposto dal feed di tendenza, senza selettori in input. Restituisce identità normalizzata del Reel, didascalie, autori, contenuti multimediali, timestamp ed engagement visibile.

L’input del contenuto è un oggetto JSON vuoto; i campi query, region, username, hashtag, date e results_limit non sono accettati.

Tendenza indica l’insieme attuale di Reel restituito dal feed di scoperta configurato al momento della raccolta. L’endpoint non pubblica una formula di classifica e non dichiara copertura globale, personalizzazione regionale né ordine stabile.

Un record normalizzato può contenere ID e URL del Reel, testo della didascalia, ID, nome utente, nome e avatar dell’autore, conteggi visibili di Mi piace, commenti, visualizzazioni e riproduzioni, metadati dei contenuti multimediali, created_at, collected_at e tipo di prodotto.

Non è accettato alcun results_limit né alcun parametro di continuazione a monte, e il raccoglitore effettua una sola richiesta al feed. L’endpoint dei risultati dell’attività può comunque paginare i record già salvati con limit e results.next_cursor.

No. Ogni attività acquisisce il feed esposto al momento della raccolta; conserva i risultati con collected_at se la tua applicazione ha bisogno di confronti tra istantanee raccolte in modo indipendente.

La fatturazione è di 0,5 crediti per ogni record normalizzato restituito, senza costo base. L’invio usa una stima di 20 record, mentre l’utilizzo finale segue i record effettivamente restituiti.