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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio (al menos uno) | Nombre de un lugar, punto de referencia o ciudad, de hasta 100 caracteres. Use este campo o latitude y longitude. |
latitude | Obligatorio (al menos uno) | Latitud del punto alrededor del cual se busca, de -90 a 90. Envíela junto con longitude. |
longitude | Obligatorio (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.
- Decida si va a buscar por el nombre del lugar o por sus coordenadas.
- Envíe por POST {"query": "Times Square"} o {"latitude": 40.758, "longitude": -73.9855} a /v1/instagram/location-search.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y lea results.items.
- 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.
APIs relacionadas
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.
- 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