instagram/
reels-search

Cerca i Reels pubblici di Instagram con una query di testo e ottieni record normalizzati con didascalie, creator, contenuti multimediali, timestamp, engagement visibile e contesto della query.

Instagram Reels Search API

Scoperta tramite query di testo
Record dei Reels
Finestra di pubblicazione
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 Reels Search

I Reels di Instagram sono video brevi pubblici con didascalie, identità del creator, contenuti multimediali, orari di pubblicazione, tipi di prodotto di origine ed engagement visibile. Questi segnali di contenuto e prestazioni supportano il monitoraggio degli argomenti, la ricerca specifica per query, la mappatura dei creator e l’analisi comparativa.

Funzionalità della Instagram Reels Search API

  • Scoperta dei Reels tramite query di testoTrova i Reels pubblici a partire da una frase di ricerca significativa, senza partire da un profilo, un hashtag, un ID audio o un URL di contenuto già noti.
  • Controllo della finestra di pubblicazioneLimita la scoperta all’ultima ora, all’ultimo giorno, all’ultima settimana, all’ultimo mese o all’ultimo anno quando l’attività richiede un intervallo di tempo preciso.
  • Record di contenuti e creatorRicevi in un unico formato identità del Reel, URL canonici, didascalie, dettagli dell’autore, riferimenti ai contenuti multimediali, orari di pubblicazione ed engagement visibile.
  • Raccolta limitata e senza duplicatiImposta ogni attività da 20 a 2.000 record: identificatori stabili dei Reels eliminano i duplicati e ogni elemento salvato conserva la query di origine.

Parametri della Instagram Reels Search API

ParametriObbligatorioDescrizione
queryObbligatorioTesto obbligatorio e non vuoto usato per cercare tra i Reels pubblici di Instagram attualmente disponibili.
results_limitFacoltativoNumero massimo di record richiesti per la query; il valore predefinito è 100 e sono accettati numeri interi da 20 a 2.000.
published_withinFacoltativoFinestra di pubblicazione facoltativa: hour, day, week, month o year.

Come usare la Instagram Reels Search API

Invia una ricerca di Reels come attività asincrona, interroga il relativo ID attività e leggi i record normalizzati con la paginazione a cursore.

  1. Prepara una query di testo non vuota e scegli una finestra di pubblicazione facoltativa; imposta results_limit da 20 a 2.000.
  2. Invia con POST query, con i campi facoltativi results_limit e published_within, a /v1/instagram/reels-search.
  3. Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
  4. Leggi data.results.items da /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/reels-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$INSTAGRAM_REELS_QUERY\",\"results_limit\":20,\"published_within\":\"week\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

Casi d’uso della Instagram Reels Search API

  • Dataset di Reels per query: Combina ID dei Reels, URL, didascalie, contenuti multimediali, autori ed extra.search_query in una raccolta tracciabile su un singolo argomento.
  • Monitoraggio degli argomenti recenti: Usa una finestra di pubblicazione insieme a created_at ed engagement visibile per esaminare i Reels apparsi di recente per una query ricorrente.
  • Scoperta di creator all’interno di un argomento: Usa ID, nomi utente, nomi e avatar normalizzati degli autori per mappare i creator presenti nell’insieme di Reels corrispondenti.
  • Confronto tra formati di contenuto: Confronta didascalie, metadati dei contenuti multimediali, tipi di prodotto di origine e metriche visibili sui Reels restituiti per la stessa query.

Consigli degli esperti per la Instagram Reels Search API

  • Usa una frase di query mirata e non composta da soli spazi, così dopo la rimozione degli spazi iniziali e finali l’attività parte da un termine di ricerca significativo.
  • Mantieni coerenti query, published_within e results_limit quando confronti esecuzioni ricorrenti, perché i risultati della ricerca pubblica attuale possono cambiare.
  • Conserva extra.search_query e gli ID stabili dei Reels quando unisci pagine di risultati o più attività, così provenienza della query e deduplicazione restano chiare.
  • Nel codice a valle considera didascalie, campi del creator, contenuti multimediali, timestamp, tipi di prodotto e contatori visibili come valori che possono essere nulli.

Oltre alla Instagram Reels Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Instagram.

  • Instagram Search API — Cerca profili pubblici per parola chiave o handle con identità e segnali visibili dell’account.
  • Instagram Comments API — Raccoglie commenti pubblici, autori, date, Mi piace e risposte dagli URL dei post.
  • Instagram Hashtag Posts API — Scopre i post pubblici per hashtag con contesto dell’hashtag di origine, media, creator, date ed engagement visibile.
  • 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.
  • Instagram Location Info API — Consulta un luogo tramite ID o URL della sua pagina, con nome, categoria, telefono, coordinate e numero di post taggati.

Esplora altre piattaforme

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

Instagram Reels Search API — FAQ

Instagram Reels Search API è un’interfaccia programmatica per trovare i Reels pubblici di Instagram a partire da una query di testo inviata. Restituisce identità del Reel, didascalie, creator, contenuti multimediali, timestamp, engagement visibile e contesto della query, in formato normalizzato.

query è obbligatoria e deve contenere testo diverso dai soli spazi. results_limit accetta da 20 a 2.000 e vale 100 per impostazione predefinita; published_within accetta hour, day, week, month o year.

Un risultato può contenere ID e URL del Reel, didascalia, identità dell’autore, conteggi di Mi piace, commenti, visualizzazioni e riproduzioni, riferimenti ai contenuti multimediali, created_at, collected_at, extra.search_query e tipo di prodotto di origine.

results_limit è un massimo e non una garanzia. L’insieme di risultati pubblici disponibili può cambiare da un’esecuzione all’altra, e all’interno di un’attività i Reels duplicati con lo stesso identificatore stabile vengono rimossi.

Ogni risultato normalizzato salvato costa 0,5 crediti, senza costo base per l’attività. La stima iniziale usa results_limit o il suo valore predefinito di 100, mentre l’utilizzo finale segue i record effettivamente salvati; un’attività senza record salvati non ha alcun costo per i risultati.