instagram/
location-search

Cerca le località di Instagram per nome del luogo o per latitudine e longitudine, con ID delle località, nomi, indirizzi, città e coordinate per le ricerche successive.

Instagram Location Search API

Nome o coordinate
ID delle località
Luoghi vicini
0,5 crediti per richiesta
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 Location Search

Instagram mantiene un proprio catalogo di luoghi e ogni tag di località su un post rimanda a una voce di quel catalogo tramite il suo ID. Cercare nel catalogo per nome o per un punto sulla mappa è il modo in cui un locale, una strada o una coppia di coordinate diventa l’ID che Instagram usa per le pagine delle località e per i post taggati.

Funzionalità della Instagram Location Search API

  • Ricerca per nomeScrivi in query il nome di un luogo, di un punto di riferimento o di una città e ottieni le località corrispondenti con i loro ID.
  • Ricerca attorno a un puntoInvia latitudine e longitudine per elencare le località intorno a quel punto, ciascuna con un’etichetta di distanza in extra.distance.
  • Pronto per il passo successivoOgni risultato include ID della località, URL della pagina, nome, indirizzo, città, latitudine e longitudine, così può passare direttamente a una richiesta di dettagli o di post.

Parametri della Instagram Location Search API

ParametriObbligatorioDescrizione
queryObbligatorio (almeno uno)Nome di un luogo, punto di riferimento o città, fino a 100 caratteri. Usa questo parametro oppure latitude e longitude.
latitudeObbligatorio (almeno uno)Latitudine del punto attorno a cui cercare, da -90 a 90. Inviala insieme a longitude.
longitudeObbligatorio (almeno uno)Longitudine del punto attorno a cui cercare, da -180 a 180. Inviala insieme a latitude.

Come usare la Instagram Location Search API

Cerca per nome o per coordinate, scegli il risultato giusto e riutilizza il suo ID.

  1. Decidi se cercare per nome del luogo o per le sue coordinate.
  2. Invia con POST {"query": "Times Square"} oppure {"latitude": 40.758, "longitude": -73.9855} a /v1/instagram/location-search.
  3. Interroga GET /v1/tasks/{task_id} finché status è succeeded e leggi results.items.
  4. Scegli il risultato in base a città e coordinate e conserva il suo id per Instagram Location Info o Instagram Location Posts.
curl -X POST "https://api.socq.ai/v1/instagram/location-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Times Square"}'

# To search around a point instead: -d '{"latitude":40.758,"longitude":-73.9855}'
# Matching locations are returned by GET /v1/tasks/{task_id}.

Casi d’uso della Instagram Location Search API

  • Trasformare elenchi di locali in ID: Converti un foglio di calcolo di nomi di negozi, hotel o locali negli ID di località di Instagram che ti servono per post e dettagli.
  • Mappare un quartiere: Cerca attorno alle coordinate di un campus, di un centro commerciale o di un’area di eventi per elencare le località di Instagram vicine.
  • Ripulire i luoghi duplicati: Confronta nomi e coordinate per individuare più località di Instagram che puntano allo stesso luogo reale, poi raccogli i post di ciascuna.

Consigli degli esperti per la Instagram Location Search API

  • Includi la città in query quando il nome di un luogo è comune, per esempio “Central Park New York”.
  • Conferma il risultato giusto in base a città e coordinate prima di riutilizzare il suo ID.
  • Quando sai esattamente dove si trova un luogo, cerca per coordinate; i risultati elencano le località attorno a quel punto insieme alla loro distanza.

Oltre alla Instagram Location 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 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 Location Posts API — Raccoglie i post pubblici più popolari o più recenti taggati in un luogo, con didascalie, autori, engagement e media.
  • Instagram Hashtag Search API — Trova gli hashtag che corrispondono a una parola chiave, con nomi, ID, URL delle pagine degli hashtag e numero di post pubblici.

Esplora altre piattaforme

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

Instagram Location Search API — FAQ

Instagram Location Search API è un’interfaccia programmatica per trovare le località di Instagram per nome del luogo o per latitudine e longitudine. Restituisce gli ID delle località insieme a nomi, URL delle pagine delle località, indirizzi, città e coordinate.

Cerca il luogo per nome o per coordinate; il campo id di ogni risultato è l’ID della località che Instagram usa per le pagine delle località.

Sì. Invia insieme latitudine e longitudine e l’attività restituisce le località attorno a quel punto.

Ogni ricerca costa 0,5 crediti, indipendentemente da quante località restituisce.