API de Lugares de una ciudad de Instagram
Lista las ubicaciones de una ciudad del directorio de Instagram, a partir de un city_id (c más dígitos): location_id, name, slug y url, por $0.56 por cada 1000 llamadas.
location_idalimentalocation_info- Sirve el enlace de la página de la ciudad
- Las llamadas fallidas y los resultados vacíos no se cobran
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "instagram", "action": "city_locations", "params": { "city_id": "c2728325" } }2Respuesta JSON
{ "results": [ { "rank": 1, "location_id": "3000346", "name": "St. Patrick's Cathedral", "slug": "st-patricks-cathedral" }, … ], "count": 96 }3Filas
rank location_id name slug 1 3000346 St. Patrick's Cathedral st-patricks-cathedral 2 1176464239075912 New York City - Manhattan - Nyc new-york-city-manhattan-nyc 4CSV
instagram-city_locations-sample.csv rank,location_id,name,slug,url,city_id,city_name,country_code,country_name,platform
city_id. En la misma respuesta vuelve una página de ubicaciones de esa ciudad del directorio, cada fila con location_id, name y slug, que pasan a filas de tabla y a un CSV.Qué datos obtienes
La tabla muestra filas de una llamada real con la ciudad c2728325, capturada el 21 de noviembre de 2026, 07:18 (UTC), que devolvió 96 filas. En tus llamadas recibes estos campos según la tabla de campos.
| rank | location_id | name | slug | url | city_id | city_name | country_code | country_name | platform |
|---|---|---|---|---|---|---|---|---|---|
1 | 3000346 | St. Patrick's Cathedral | st-patricks-cathedral | https://www.instagram.com/explore/locations/3000346/st-patricks-cathedral/ | c2728325 | MidtownEast | US | United States | |
2 | 1176464239075912 | New York City - Manhattan - Nyc | new-york-city-manhattan-nyc | https://www.instagram.com/explore/locations/1176464239075912/new-york-city-manhattan-nyc/ | c2728325 | MidtownEast | US | United States |
Casos de uso
Listar las ubicaciones de una ciudad
Da un
city_idy lee las ubicaciones de esa ciudad en el directorio.Seguir hacia los datos de una ubicación
Pasa
location_idalocation_infopara leer las coordenadas y la categoría.Seguir hacia las publicaciones de una ubicación
Pasa
location_idalocation_postspara ver las publicaciones de esa ubicación.Armar una lista de ubicaciones de una ciudad
Guarda
name,slugyurly enlázalos con las páginas del directorio.
Instagram Graph API frente a EveryInfra
Comparamos la Instagram Graph API oficial y city_locations de EveryInfra en dos puntos: el requisito de cuenta y la revisión de acceso.
| Aspecto | Instagram Graph API | EveryInfra |
|---|---|---|
| Requisito de cuenta | "To use the APIs, your app users must have an Instagram professional account" | La solicitud lleva city_id y una clave de API de EveryInfra. Ni tú ni tus usuarios necesitan una cuenta profesional de Instagram. |
| Revisión de acceso | "Advanced Access is the access level required if your app serves Instagram professional accounts that you don’t own or manage" y "This access level requires App Review and Business Verification." | Envías una clave de API de EveryInfra en la cabecera Authorization: Bearer. No presentas ninguna revisión de app de Meta ni inicias sesión en Instagram. |
Las citas proceden de la documentación para desarrolladores de Meta, comprobadas el 2026-11-22. Esta tabla solo compara las condiciones de acceso. Fuentes oficiales: Instagram Platform overview (actualizada el 2026-10-29)
Límites y detalles a tener en cuenta
city_ides obligatorio:cmás dígitos, por ejemploc2728325, tomado delcity_iddelocation_cities. También sirve el enlace de la página de la ciudad.- El resultado son las ubicaciones de esa ciudad en el directorio de ubicaciones de Instagram. Una ciudad que no está en el directorio devuelve un resultado vacío y no se cobra.
- Una llamada devuelve una página. Si la respuesta trae
next_page_token, envíalo de vuelta sin cambios comopage_tokeny deja iguales los demás parámetros. El token vale 24 horas y cada página cuenta como una llamada. Sinnext_page_token, no se puede seguir paginando. - La última página puede venir incompleta.
city_namees el nombre de la ciudad en el directorio y es igual en todas las filas.- Esta capacidad solo lista ubicaciones. Para coordenadas y categoría, usa
location_info.
Precios
Pagas $0.000556 por llamada, no por fila. Cada página cuenta como una llamada. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 10,000 | $5.56 |
| 100,000 | $55.56 |
| 1,000,000 | $555.56 |
El total se calcula con el precio de lista por llamada.
Ejemplos de código
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "instagram",
"action": "city_locations",
"params": {
"city_id": "c2728325"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Referencia de API
Aquí tienes los parámetros, campos de respuesta, errores y facturación de city_locations; copia la página o ábrela en Markdown para dársela a un asistente de IA.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Instagram: Lugares de una ciudad (instagram/city_locations).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en instagram y action en city_locations, y los parámetros dentro de params.
- Parámetros obligatorios:
- city_id: ID de ciudad de location_cities (c seguida de dígitos, como c2728325), o el enlace de la ciudad.
- Parámetros opcionales:
- page_token: Token de paginación de city_locations. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar los demás parámetros.
- Devuelve una lista de registros. Campos principales de cada registro: rank (Posición desde 1: el orden de esta fila…), location_id (ID del lugar), name, slug (La parte del nombre en el enlace del di…), url, city_id (ID de ciudad, c seguida de dígitos, com…), city_name ((city_locations) Nombre de la ciudad en…), country_code (Código de país de dos letras (ISO 3166-…), country_name (Nombre del país en inglés, como United…).
- Cuerpo de solicitud de ejemplo:
{
"platform": "instagram",
"action": "city_locations",
"params": {
"city_id": "c2728325"
}
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | instagram | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | city_locations | Identificador de la capacidad, valor fijo. |
city_id | body.params | string | Sí | - | ID de ciudad de location_cities (c seguida de dígitos, como c2728325), o el enlace de la ciudad. |
page_token | body.params | string | No | - | Token de paginación de city_locations. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar los demás parámetros. Los tokens duran 24 horas y cada página cuenta como una llamada; la última página no trae next_page_token. |
Ejemplo de respuesta
#{ "id": "req_…", "platform": "instagram", "action": "city_locations", "results": [ { "rank": 1, "location_id": "3000346", "name": "St. Patrick's Cathedral", "slug": "st-patricks-cathedral", "url": "https://www.instagram.com/explore/locations/3000346/st-patricks-cathedral/", "city_id": "c2728325", "city_name": "MidtownEast", "country_code": "US", "country_name": "United States", "platform": "instagram" }, { "rank": 2, "location_id": "1176464239075912", "name": "New York City - Manhattan - Nyc", "slug": "new-york-city-manhattan-nyc", "url": "https://www.instagram.com/explore/locations/1176464239075912/new-york-city-manhattan-nyc/", "city_id": "c2728325", "city_name": "MidtownEast", "country_code": "US", "country_name": "United States", "platform": "instagram" } ], "next_page_token": …, "pagination": { … }, "count": 96, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
rank | Posición desde 1: el orden de esta fila dentro de este resultado. user_search: primero las cuentas que devolvió el cuadro de búsqueda de Instagram (matched_by es search_box), en el orden del cuadro de búsqueda; después los autores de publicaciones encontradas con esta palabra clave, que completan la cantidad (matched_by es post_author); los resultados sin matched_by llevan la posición en que Instagram clasifica la cuenta para esta palabra clave. similar_profiles: el lugar de la cuenta entre las similares, ordenadas por seguidores. likers: el lugar de la cuenta en la lista de «me gusta». |
location_id | ID del lugar. Pásalo a location_info, location_nearby o location_posts. |
name | Nombre del propio objeto, en capacidades de cuentas, productos y negocios. |
slug | La parte del nombre en el enlace del directorio de lugares de Instagram, como st-patricks-cathedral. |
url | Enlace al registro en la plataforma. |
city_id | ID de ciudad, c seguida de dígitos, como c2728325. Pásalo a city_locations. |
city_name | (city_locations) Nombre de la ciudad en el directorio de lugares de Instagram, igual en todas las filas. |
country_code | Código de país de dos letras (ISO 3166-1), como US. |
country_name | Nombre del país en inglés, como United States. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Preguntas frecuentes
¿Qué devuelve la API de ubicaciones de una ciudad de Instagram?
Cada fila es una ubicación: location_id, name, slug y url, más city_id, city_name, country_code, country_name y rank.
¿De dónde saco city_id?
Usa el city_id (c más dígitos) de los resultados de location_cities. También puedes pasar el enlace de la página de la ciudad.
¿Cómo pido la página siguiente?
Cuando la respuesta trae next_page_token, envíalo de vuelta sin cambios como page_token y deja iguales los demás parámetros. Sin next_page_token, no se puede seguir paginando.
¿Cuánto cuesta leer una página?
Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas. Cada página cuenta como una llamada, no cada fila. Las llamadas fallidas y los resultados vacíos no se cobran.
¿Necesito iniciar sesión en Instagram?
No. Envías una clave de API de EveryInfra en la cabecera Authorization: Bearer y la solicitud lleva solo city_id. No hace falta iniciar sesión en Instagram ni un token de acceso.
Capacidades de Instagram relacionadas
Con la misma clave puedes llamar a otras capacidades de Instagram, como location_posts para leer las publicaciones de una ubicación.
- Detalles de la publicación
post$0.56 por cada 1000 llamadasProcesa una o varias URL enurlsy devuelve publicaciones de Instagram con autor, texto, tipo de medio y métricas visibles. - Detalles
profile$0.56 por cada 1000 llamadasResuelve unusernamede Instagram y devuelve nombre, biografía, contadores y señales públicas de cuenta. - Análisis de la cuenta
persona$0.56 por cada 1000 llamadasConsulta medianteusernamelos mismos campos públicos queprofiley añade un objetopersonaescrito por IA con sector, nicho, autenticidad y resumen. - Publicaciones del usuario
user_posts$0.56 por cada 1000 llamadasObtiene publicaciones públicas delusername, con URL, texto, formato y contadores por pieza. - Descubrimiento de contenido
discover$0.56 por cada 1000 llamadasDescubre publicaciones porkeywordy permite elegirresults_type. - Comentarios
comments$0.79 por cada 1000 llamadasLee comentarios de laurlde una publicación, con autor, likes, respuestas y fecha cuando existen. - Reels
reels$1.19 por cada 1000 llamadasConsulta Reels asociados ausernamey devuelve descripción, título, reproducciones, duración y texto cuando está disponible. - Contenido por hashtag
hashtag$0.56 por cada 1000 llamadasBusca contenido delhashtag, aceptando alias compatibles de etiqueta o palabra, y distingue posts de Reels medianteresults_type. - Seguidores
followers$0.56 por cada 1000 llamadasObtiene parausernamecontadores y señales de conexión agregadas. - Lista de seguidores
followers_list$0.56 por cada 1000 llamadasEnumera cuentas seguidoras delusernamecon relación y perfil público cuando están disponibles. - Lista de cuentas seguidas
following_list$0.56 por cada 1000 llamadasLista cuentas seguidas por elusername, conservando privacidad y verificación visibles. - Búsqueda de cuentas
user_search$4.81 por cada 1000 llamadasBusca cuentas de Instagram porkeyword, en el orden en que la búsqueda de Instagram las clasifica para esa palabra (rankdesde 1). - Búsqueda de Reels
reels_search$7.19 por cada 1000 llamadasBusca Reels de Instagram porkeyword, por ejemplo coffee. - Cuentas similares
similar_profiles$8.81 por cada 1000 llamadasLista las cuentas que Instagram sugiere como similares a unusername, por ejemplo nasa, ordenadas por seguidores (rankdesde 1). - Publicaciones etiquetadas
tagged_posts$7.44 por cada 1000 llamadasLista publicaciones públicas de otras cuentas que etiquetan a unusername(también vale la URL del perfil o el ID numérico). - Historias
stories$1.5 por cada 1000 llamadasDevuelve las historias que una cuenta de Instagram tiene activas ahora, a partir de su usuario. - Historias destacadas
highlights$1.6 por cada 1000 llamadasLista las historias destacadas de un perfil de Instagram. - Respuestas a comentarios
comment_replies$0.88 por cada 1000 llamadasLee las respuestas a un comentario de una publicación o Reel de Instagram, con el enlace de la publicación y eliddel comentario que devuelvecomments. - Cuentas que dieron me gusta
likers$1.32 por cada 1000 llamadasLista las cuentas que dieron «me gusta» a una publicación o Reel de Instagram, a partir de suurl. - Publicaciones de un lugar
location_posts$0.56 por cada 1000 llamadasLista las publicaciones etiquetadas en un lugar de Instagram, a partir delocation_id(eliddelocation_detailen una publicación, o el enlace de la página del lugar). - Reels con una misma música
audio_posts$0.56 por cada 1000 llamadasLista los Reels de Instagram que usan una misma música, a partir deaudio_id(elaudio_iddemusicen una publicación, o el enlace de la página del audio). - Exploración
explore$0.56 por cada 1000 llamadasLee una página de las publicaciones que Instagram recomienda en Explore; no necesita ningún parámetro. - Estadísticas de interacción
engagement$0.56 por cada 1000 llamadasCalcula la interacción de una cuenta de Instagram a partir de sus últimas publicaciones, conusername. - Perfil por ID numérico
profile_by_id$0.56 por cada 1000 llamadasConsulta una cuenta de Instagram a partir de suuser_idnumérico. - Acerca de esta cuenta
user_about$0.56 por cada 1000 llamadasLee el panel «Información sobre esta cuenta» de un perfil de Instagram a partir deusername: el mes en que se unió (joined_at), elcountry, cuántas veces cambió de nombre de usuario (former_usernames_count) y cuándo se verificó. - Datos de un lugar
location_info$0.56 por cada 1000 llamadasLee un lugar de Instagram a partir de sulocation_id: nombre, categoría, coordenadas (lat,lng), dirección cuando figura ypost_count. - Reconocimiento de enlaces
resolve_links$0.56 por cada 1000 llamadasConvierte la referencia a una publicación que pasas entext(enlace, shortcode o ID numérico) en sus tres formas:shortcode,media_idyurl. - Código para insertar una publicación
oembed$0.56 por cada 1000 llamadasObtén los datos oEmbed y el código para insertar una publicación o Reel de Instagram a partir de suurl: los mismos campos que el oEmbed oficial de Instagram, conhtmllisto para pegar en una página web. - Traducción de una publicación
post_translation$6.39 por cada 1000 llamadasTraduce el texto de una publicación de Instagram altarget_language(por defectoen), con suurlomedia_id. - Lugares cercanos
location_nearby$0.56 por cada 1000 llamadasLista los lugares que Instagram muestra cerca de un lugar, a partir de sulocation_id: unas 20 filas por llamada, sin página siguiente. - Búsqueda de hashtags
hashtag_search$0.56 por cada 1000 llamadasBusca hashtags de Instagram para unakeyword: los que sugiere el cuadro de búsqueda, con elpost_countde cada uno, de unos pocos a unos 15 por llamada, sin página siguiente. - Historias de un destacado
highlight_stories$0.56 por cada 1000 llamadasLee todas las historias de un destacado de Instagram conhighlight_id(eliddehighlightso un enlace del destacado): hasta 100 historias en una llamada, con los enlaces de los medios,posted_atyduration_seconds. - Traducción de comentarios
comment_translations$6.39 por cada 1000 llamadasTraduce hasta 10 comentarios de una publicación de Instagram, con laurlde la publicación ycomment_ids, altarget_language(por defectoen). - Reels recomendados
recommended_reels$1.18 por cada 1000 llamadasLee los Reels que Instagram recomienda en su página de Reels, 10 por página; no necesita parámetros. - Republicaciones de una cuenta
user_reposts$0.56 por cada 1000 llamadasLista las publicaciones y Reels que una cuenta de Instagram republicó en su perfil, conusername, 12 por página. - Ciudades de un país
location_cities$0.56 por cada 1000 llamadasLista las ciudades del directorio de lugares de Instagram para uncountry_code, 96 por página. - Perfiles en lote
profiles_batch$0.56 por cada 1000 llamadasConsulta hasta 20 cuentas de Instagram a la vez conusernames, cada una como nombre de usuario (por ejemplonatgeo) o enlace de perfil.