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_id alimenta location_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
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "city_locations",
      "params": {
        "city_id": "c2728325"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "rank": 1,
          "location_id": "3000346",
          "name": "St. Patrick's Cathedral",
          "slug": "st-patricks-cathedral"
        },
        …
      ],
      "count": 96
    }
  3. 3Filas

    ranklocation_idnameslug
    13000346St. Patrick's Cathedralst-patricks-cathedral
    21176464239075912New York City - Manhattan - Nycnew-york-city-manhattan-nyc
  4. 4CSV

    instagram-city_locations-sample.csv rank,location_id,name,slug,url,city_id,city_name,country_code,country_name,platform

La solicitud lleva 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.

ranklocation_idnameslugurlcity_idcity_namecountry_codecountry_nameplatform
13000346St. Patrick's Cathedralst-patricks-cathedralhttps://www.instagram.com/explore/locations/3000346/st-patricks-cathedral/c2728325MidtownEastUSUnited Statesinstagram
21176464239075912New York City - Manhattan - Nycnew-york-city-manhattan-nychttps://www.instagram.com/explore/locations/1176464239075912/new-york-city-manhattan-nyc/c2728325MidtownEastUSUnited Statesinstagram

Casos de uso

  • Listar las ubicaciones de una ciudad

    Da un city_id y lee las ubicaciones de esa ciudad en el directorio.

  • Seguir hacia los datos de una ubicación

    Pasa location_id a location_info para leer las coordenadas y la categoría.

  • Seguir hacia las publicaciones de una ubicación

    Pasa location_id a location_posts para ver las publicaciones de esa ubicación.

  • Armar una lista de ubicaciones de una ciudad

    Guarda name, slug y url y 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.

AspectoInstagram Graph APIEveryInfra
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_id es obligatorio: c más dígitos, por ejemplo c2728325, tomado del city_id de location_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 como page_token y deja iguales los demás parámetros. El token vale 24 horas y cada página cuenta como una llamada. Sin next_page_token, no se puede seguir paginando.
  • La última página puede venir incompleta.
  • city_name es 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.

LlamadasCosto
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

#
bash
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.

POST

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

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-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.
platformbodystringSíinstagramIdentificador de la plataforma, valor fijo.
actionbodystringSícity_locationsIdentificador de la capacidad, valor fijo.
city_idbody.paramsstringSí-ID de ciudad de location_cities (c seguida de dígitos, como c2728325), o el enlace de la ciudad.
page_tokenbody.paramsstringNo-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

#
Obtenida el 21 de noviembre de 2026, 07:18 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "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.

CampoSignificado
rankPosició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_idID del lugar. Pásalo a location_info, location_nearby o location_posts.
nameNombre del propio objeto, en capacidades de cuentas, productos y negocios.
slugLa parte del nombre en el enlace del directorio de lugares de Instagram, como st-patricks-cathedral.
urlEnlace al registro en la plataforma.
city_idID 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_codeCódigo de país de dos letras (ISO 3166-1), como US.
country_nameNombre del país en inglés, como United States.
platformIdentificador 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.

Errores

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.

Con la misma clave puedes llamar a otras capacidades de Instagram, como location_posts para leer las publicaciones de una ubicación.

Google Analytics solo si aceptas. Privacidad