Instagram Location Search
Instagram tient son propre catalogue de lieux, et chaque marqueur de lieu sur une publication pointe vers une entrée de ce catalogue grâce à son ID. Rechercher dans le catalogue par nom ou par un point de la carte est le moyen de transformer un établissement, une rue ou une paire de coordonnées en l’ID qu’Instagram utilise pour ses pages de lieux et ses publications associées.
Fonctionnalités de la Instagram Location Search API
- Recherche par nomSaisissez un nom de lieu, un monument ou une ville dans query et obtenez les lieux correspondants avec leurs ID.
- Recherche autour d’un pointEnvoyez latitude et longitude pour lister les lieux situés autour de cet endroit, chacun avec un libellé de distance dans extra.distance.
- Prêt pour l’étape suivanteChaque résultat comprend l’ID du lieu, l’URL de sa page, son nom, son adresse, sa ville, sa latitude et sa longitude, et peut donc passer directement dans une requête de détails ou de publications.
Paramètres de la Instagram Location Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire (au moins un) | Nom de lieu, monument ou ville, 100 caractères au maximum. Utilisez ce paramètre ou latitude et longitude. |
latitude | Obligatoire (au moins un) | Latitude du point autour duquel chercher, de -90 à 90. À envoyer avec longitude. |
longitude | Obligatoire (au moins un) | Longitude du point autour duquel chercher, de -180 à 180. À envoyer avec latitude. |
Comment utiliser la Instagram Location Search API
Recherchez par nom ou par coordonnées, choisissez le bon résultat et réutilisez son ID.
- Décidez si vous cherchez le lieu par son nom ou par ses coordonnées.
- Envoyez {"query": "Times Square"} ou {"latitude": 40.758, "longitude": -73.9855} en POST à /v1/instagram/location-search.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez results.items.
- Choisissez le résultat d’après sa ville et ses coordonnées, et conservez son id pour Instagram Location Info ou 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}.Cas d’usage de la Instagram Location Search API
- Transformer des listes d’établissements en ID : Convertissez un tableur de noms de magasins, d’hôtels ou de sites en ID de lieux Instagram, nécessaires pour les publications et les détails.
- Cartographier un quartier : Cherchez autour des coordonnées d’un campus, d’un centre commercial ou d’un site d’événement pour lister les lieux Instagram proches.
- Nettoyer les lieux en double : Comparez noms et coordonnées pour repérer plusieurs lieux Instagram qui désignent le même endroit réel, puis collectez les publications de chacun.
Conseils d’expert pour la Instagram Location Search API
- Ajoutez la ville dans query lorsqu’un nom de lieu est courant, par exemple « Central Park New York ».
- Vérifiez le bon résultat d’après sa ville et ses coordonnées avant de réutiliser son ID.
- Si vous savez exactement où se trouve un lieu, cherchez par coordonnées ; les résultats listent les lieux autour de ce point avec leur distance.
API associées
En complément de la Instagram Location Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Instagram.
- Instagram Search API — Recherchez des profils publics par mot-clé ou handle avec identité et signaux de compte visibles.
- Instagram Hashtag Posts API — Découvrez des publications publiques par hashtag avec contexte du hashtag source, médias, créateurs, horodatages et engagement visible.
- Instagram Reels Search API — Recherchez des Reels publics par requête textuelle avec légendes, créateurs, médias, horodatages, engagement visible et contexte de la requête.
- Instagram Location Info API — Consultez un lieu à partir de son ID ou de l’URL de sa page, avec nom, catégorie, téléphone, coordonnées et nombre de publications identifiées.
- Instagram Location Posts API — Collectez les publications publiques les plus populaires ou les plus récentes associées à un lieu, avec légendes, auteurs, engagement et médias.
- Instagram Hashtag Search API — Trouvez les hashtags correspondant à un mot-clé, avec noms, ID, URL des pages de hashtag et nombre de publications publiques.
- 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