instagram/
search

Cerca i profili Instagram pubblici per parola chiave o handle e ottieni identità normalizzata, biografie, immagini del profilo, verifica, privacy e conteggi visibili dell’account.

Instagram Search API

Ricerca di profili
Scoperta
Dati pubblici
0,54 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 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

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave, handle o frase di ricerca del profilo.
results_limitFacoltativoNumero 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.

  1. Prepara una parola chiave, un handle o una frase di ricerca del profilo non vuota.
  2. Invia con POST query e un results_limit facoltativo a /v1/instagram/search.
  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 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.

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.

Esplora altre piattaforme

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

Instagram Search API — FAQ

Instagram Search API trova i profili Instagram visibili pubblicamente a partire da una parola chiave o da un handle. Restituisce identità normalizzata, biografie, immagini del profilo, segnali di verifica e privacy e conteggi visibili dell’account.

La query cerca tra i risultati dei profili pubblici per parola chiave, handle, nome o frase che descrive l’account. Usa un handle specifico quando vuoi un insieme di risultati più ristretto.

L’endpoint attuale cerca solo risultati di utenti e profili pubblici. Non restituisce record di post, Reels, storie o hashtag.

I campi più comuni sono ID del profilo, nome utente, nome visualizzato, URL canonico, avatar, biografia, verifica, privacy, conteggi visibili di follower, seguiti e post, e orario di raccolta.

results_limit imposta il numero massimo di record di profilo richiesti. È un limite e non una garanzia, perché la classifica della ricerca e la disponibilità pubblica possono produrre meno risultati.

Classifica della ricerca, handle rinominati, profili privati o rimossi e disponibilità temporanea dei risultati pubblici possono ridurre o cambiare l’insieme restituito. Prova una query più specifica e considera i campi facoltativi del profilo come valori che possono essere nulli.

Usa il nome utente restituito con Instagram Posts, Reels o Followers Count API quando ti servono record di contenuti pubblici o metriche di conteggio aggiornate.