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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Testo obbligatorio e non vuoto usato per cercare tra i Reels pubblici di Instagram attualmente disponibili. |
results_limit | Facoltativo | Numero massimo di record richiesti per la query; il valore predefinito è 100 e sono accettati numeri interi da 20 a 2.000. |
published_within | Facoltativo | Finestra 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.
- Prepara una query di testo non vuota e scegli una finestra di pubblicazione facoltativa; imposta results_limit da 20 a 2.000.
- Invia con POST query, con i campi facoltativi results_limit e published_within, a /v1/instagram/reels-search.
- Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
- 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.
API correlate
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.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API