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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio (almeno uno) | Nome di un luogo, punto di riferimento o città, fino a 100 caratteri. Usa questo parametro oppure latitude e longitude. |
latitude | Obbligatorio (almeno uno) | Latitudine del punto attorno a cui cercare, da -90 a 90. Inviala insieme a longitude. |
longitude | Obbligatorio (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.
- Decidi se cercare per nome del luogo o per le sue coordinate.
- Invia con POST {"query": "Times Square"} oppure {"latitude": 40.758, "longitude": -73.9855} a /v1/instagram/location-search.
- Interroga GET /v1/tasks/{task_id} finché status è succeeded e leggi results.items.
- 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.
API correlate
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.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Comments API
- Instagram Profiles 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 Account Age Checker API