Instagram Search
I risultati di Instagram Search sono profili pubblici associati a un nome, una parola chiave o un argomento, con nomi utente, biografie, immagini del profilo, verifica, privacy e segnali visibili dell’account. Questi record supportano la scoperta di creator, la ricerca sui brand, la selezione del pubblico e l’arricchimento dei profili.
Funzionalità della Instagram Search API
- Ricerca di profili per parola chiaveCerca i profili Instagram pubblici per parola chiave, handle, nome o frase che descrive l’account.
- Identità e conteggi del profiloRestituisce nome utente, nome visualizzato, biografia, URL del profilo, avatar, verifica, privacy e campi dei conteggi visibili per ogni profilo trovato.
- Schema del profilo coerenteRestituisce la stessa forma normalizzata del profilo per parole chiave generiche, nomi e ricerche con handle esatto.
- Limite dei risultati richiestiUsa results_limit per impostare il numero massimo di record di profilo richiesti per una ricerca.
- Confine dei dati pubbliciI dati di profili privati, con restrizioni, rimossi o visibili solo dopo l’accesso restano fuori dall’ambito della risposta.
Parametri della Instagram Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Parola chiave, handle o frase di ricerca del profilo. |
results_limit | Facoltativo | Numero massimo di record che l’attività di raccolta deve richiedere. Deve essere un numero intero positivo. |
Come usare la Instagram Search API
Invia una query di ricerca di profili come attività asincrona, interroga il relativo ID attività e leggi i risultati normalizzati dei profili con la paginazione a cursore.
- Prepara una parola chiave, un handle o una frase di ricerca del profilo non vuota.
- Invia con POST query e un results_limit facoltativo a /v1/instagram/search.
- Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
- Leggi /v1/tasks/{task_id}?limit=50 e segui results.next_cursor quando ci sono altri profili.
curl -X POST "https://api.socq.ai/v1/instagram/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"sustainable travel","results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Casi d’uso della Instagram Search API
- Scoperta di creator: Trova i profili pubblici legati a una parola chiave, un handle, una categoria o una frase di campagna prima di un arricchimento più approfondito.
- Arricchimento degli account: Ottieni identità pubblica, biografia, verifica, privacy e campi dei conteggi visibili per i risultati di ricerca selezionati.
- Scoperta di brand: Trova i profili pubblici di brand e organizzazioni legati a un nome, a una categoria di prodotto o a una frase di mercato.
- Directory di ricerca: Crea elenchi verificabili di profili Instagram pubblici per ricerca, qualificazione del contatto o analisi interne.
- Flussi di selezione dei profili: Scegli i profili pertinenti, poi richiama le API dei post, dei Reels o del conteggio dei follower per ottenere record pubblici più approfonditi.
Consigli degli esperti per la Instagram Search API
- Considera le risposte 429 un normale segnale di sovraccarico nei flussi di ricerca; usa il backoff e finestre di risultati più piccole invece di riprovare in modo aggressivo.
- Salva ID attività, ID stabili dei profili, nomi utente e URL canonici, così le ricerche possono essere ripetute e verificate.
- Usa i risultati di ricerca per scoprire i profili, poi richiama le API dei post, dei Reels o del conteggio dei follower quando il tuo flusso richiede record più approfonditi.
- Non includere nelle ipotesi di integrazione i dati privati, visibili solo dopo l’accesso o di proprietà dell’account, a meno che la documentazione pubblicata dell’API non li supporti esplicitamente.
- Ripulisci i termini di ricerca forniti dagli utenti prima di inviarli in qualsiasi pipeline di produzione.
API correlate
Oltre alla Instagram Search 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 Profiles API — Recupera identità del profilo pubblico, bio, link, flag dell’account, categorie e conteggi visibili a partire dal nome utente.
- Instagram Hashtag Posts API — Scopre i post pubblici per hashtag con contesto dell’hashtag di origine, media, creator, date ed engagement visibile.
- Instagram Reels Search API — Cerca Reels pubblici per testo con didascalie, creator, media, date, engagement visibile e contesto della query.
- 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 Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info 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