instagram/
location-search

Recherchez des lieux Instagram par nom ou par latitude et longitude, et obtenez des ID de lieux avec noms, adresses, villes et coordonnées pour vos recherches suivantes.

Instagram Location Search API

Nom ou coordonnées
ID de lieux
Lieux à proximité
0,5 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
queryObligatoire (au moins un)Nom de lieu, monument ou ville, 100 caractères au maximum. Utilisez ce paramètre ou latitude et longitude.
latitudeObligatoire (au moins un)Latitude du point autour duquel chercher, de -90 à 90. À envoyer avec longitude.
longitudeObligatoire (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.

  1. Décidez si vous cherchez le lieu par son nom ou par ses coordonnées.
  2. Envoyez {"query": "Times Square"} ou {"latitude": 40.758, "longitude": -73.9855} en POST à /v1/instagram/location-search.
  3. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez results.items.
  4. 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.

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.

Explorer d’autres plateformes

Combinez les données Instagram avec les données publiques d’autres plateformes sociales prises en charge.

Instagram Location Search API — FAQ

Instagram Location Search API est une interface programmatique qui trouve des lieux Instagram à partir d’un nom de lieu ou d’une latitude et d’une longitude. Elle renvoie des ID de lieux accompagnés des noms, des URL des pages de lieux, des adresses, des villes et des coordonnées.

Recherchez le lieu par nom ou par coordonnées ; le champ id de chaque résultat est l’ID de lieu qu’Instagram utilise pour ses pages de lieux.

Oui. Envoyez latitude et longitude ensemble, et la tâche renvoie les lieux autour de ce point.

Chaque recherche coûte 0,5 crédit, quel que soit le nombre de lieux renvoyés.