instagram/
location-search

Busque ubicaciones de Instagram por nombre de lugar o por latitud y longitud, con IDs de ubicación, nombres, direcciones, ciudades y coordenadas para consultas posteriores.

Instagram Location Search API

Nombre o coordenadas
IDs de ubicación
Lugares cercanos
0.5 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Instagram Location Search

Instagram mantiene su propio catálogo de lugares, y cada etiqueta de ubicación en una publicación apunta a una entrada de ese catálogo mediante su ID. Buscar en el catálogo por nombre o por un punto del mapa es la forma en que un local, una calle o un par de coordenadas se convierte en el ID que Instagram usa para sus páginas de ubicación y sus publicaciones etiquetadas.

Funcionalidades de la Instagram Location Search API

  • Búsqueda por nombreEscriba el nombre de un lugar, un punto de referencia o una ciudad en query y obtenga las ubicaciones que coinciden, con sus IDs.
  • Búsqueda alrededor de un puntoEnvíe latitud y longitud para listar las ubicaciones alrededor de ese punto, cada una con una etiqueta de distancia en extra.distance.
  • Listo para el siguiente pasoCada coincidencia incluye el ID de ubicación, la URL de la página, el nombre, la dirección, la ciudad, la latitud y la longitud, por lo que puede pasar directamente a una solicitud de detalles o de publicaciones.

Parámetros de la Instagram Location Search API

ParámetrosObligatorioDescripción
queryObligatorio (al menos uno)Nombre de un lugar, punto de referencia o ciudad, de hasta 100 caracteres. Use este campo o latitude y longitude.
latitudeObligatorio (al menos uno)Latitud del punto alrededor del cual se busca, de -90 a 90. Envíela junto con longitude.
longitudeObligatorio (al menos uno)Longitud del punto alrededor del cual se busca, de -180 a 180. Envíela junto con latitude.

Cómo usar la Instagram Location Search API

Busque por nombre o por coordenadas, elija la coincidencia correcta y reutilice su ID.

  1. Decida si va a buscar por el nombre del lugar o por sus coordenadas.
  2. Envíe por POST {"query": "Times Square"} o {"latitude": 40.758, "longitude": -73.9855} a /v1/instagram/location-search.
  3. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y lea results.items.
  4. Elija la coincidencia según su ciudad y sus coordenadas, y conserve su id para 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}.

Casos de uso de la Instagram Location Search API

  • Convertir listas de locales en IDs: Convierta una hoja de cálculo con nombres de tiendas, hoteles o locales en los IDs de ubicación de Instagram que necesita para publicaciones y detalles.
  • Mapeo de un barrio: Busque alrededor de las coordenadas de un campus, un centro comercial o un recinto de eventos para listar las ubicaciones de Instagram cercanas.
  • Depuración de lugares duplicados: Compare nombres y coordenadas para detectar varias ubicaciones de Instagram que apuntan al mismo lugar real y recopile publicaciones de cada una.

Consejos de expertos para la Instagram Location Search API

  • Incluya la ciudad en query cuando el nombre de un lugar sea común, por ejemplo “Central Park New York”.
  • Confirme el resultado correcto por su ciudad y sus coordenadas antes de reutilizar su ID.
  • Cuando sepa exactamente dónde está un lugar, busque por coordenadas; los resultados listan las ubicaciones alrededor de ese punto junto con su distancia.

Además de la Instagram Location Search API, use estas APIs cuando necesite otro tipo de datos públicos de Instagram.

  • Instagram Search API — Busca perfiles públicos por palabra clave o identificador, con identidad y señales visibles de la cuenta.
  • Instagram Hashtag Posts API — Descubre publicaciones públicas por hashtag, con contexto del hashtag de origen, contenido multimedia, creadores, marcas de tiempo e interacción visible.
  • Instagram Reels Search API — Busca Reels públicos por consulta de texto, con descripciones, creadores, contenido multimedia, marcas de tiempo, interacción visible y contexto de la consulta.
  • Instagram Location Info API — Consulta una ubicación por ID o por la URL de su página, con nombre, categoría, teléfono, coordenadas y cantidad de publicaciones etiquetadas.
  • Instagram Location Posts API — Recolecta las publicaciones públicas destacadas o más recientes etiquetadas en una ubicación, con descripciones, autores, interacción y contenido multimedia.
  • Instagram Hashtag Search API — Encuentra hashtags que coinciden con una palabra clave, con nombres de hashtag, IDs, URLs de las páginas de cada hashtag y cantidad de publicaciones públicas.

Explorar otras plataformas

Combine los datos de Instagram con datos públicos de otras plataformas sociales compatibles.

Instagram Location Search API — FAQ

Instagram Location Search API es una interfaz programática para encontrar ubicaciones de Instagram por nombre de lugar o por latitud y longitud. Devuelve IDs de ubicación junto con nombres, URL de las páginas de ubicación, direcciones, ciudades y coordenadas.

Busque el lugar por nombre o por coordenadas; el campo id de cada resultado es el ID de ubicación que Instagram usa para sus páginas de ubicación.

Sí. Envíe latitud y longitud juntas, y la tarea devolverá las ubicaciones alrededor de ese punto.

Cada búsqueda cuesta 0.5 créditos, sin importar cuántas ubicaciones devuelva.