API de Lugares cercanos de Instagram

Lista las ubicaciones cercanas a un location_id: cada fila trae name, category, lat, lng y post_count, y algunas también price_range y hours_status, por $0.56 por cada 1000 llamadas.

  • Todas las filas en una respuesta, sin página siguiente
  • origin marca la ubicación consultada
  • 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": "location_nearby",
      "params": {
        "location_id": "212988663"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "rank": 1,
          "location_id": "105978888134411",
          "name": "Long Island City",
          "category": "Government Building"
        },
        …
      ],
      "count": 20
    }
  3. 3Filas

    ranklocation_idnamecategory
    1105978888134411Long Island CityGovernment Building
    2106075139432188New York, N.Y.Government organization
  4. 4CSV

    instagram-location_nearby-sample.csv rank,location_id,name,category,lat,lng,post_count,post_count_label,price_range,hours_status,thumbnail_url,url,platform,origin

La solicitud lleva location_id. En la misma respuesta vuelven las ubicaciones cercanas, cada fila con name, lat, lng y más, que pasan a filas de tabla y a un CSV.

Qué datos obtienes

La tabla muestra filas de una llamada real con la ubicación 212988663, capturada el 21 de noviembre de 2026, 07:18 (UTC), que devolvió 20 filas. En tus llamadas recibes estos campos según la tabla de campos. El objeto origin es la ubicación consultada y es igual en todas las filas.

ranklocation_idnamecategorylatlngpost_countpost_count_labelprice_rangehours_statusthumbnail_urlurlplatformorigin
1105978888134411Long Island CityGovernment Building40.714199791679-74.00640606880222002.2K postsnullnullhttps://scontent-lax7-1.cdninstagram.com/v/t51.82787-15/894460983_17948449221127280_215263549254016924_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=110&_nc_map=urlgen_bucketless&ig_cache_key=NDAzMTk4MzE0NDE1NTc3ODIyMzE3OTQ4NDQ5MjE1MTI3Mjgw.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3R…https://www.instagram.com/explore/locations/105978888134411/long-island-city/instagram{"location_id":"212988663","name":"New York, New York","lat":40.7142,"lng":-74.0064}
2106075139432188New York, N.Y.Government organization40.716666666667-7414000001.4M postsnullnullhttps://scontent-lax7-1.cdninstagram.com/v/t51.71878-15/916393440_1696283865348282_5708378039583168201_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=110&_nc_map=urlgen_bucketless&ig_cache_key=NDAzNTEzNDEwNDI4MDk0MTk1MA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnh…https://www.instagram.com/explore/locations/106075139432188/new-york-ny/instagram{"location_id":"212988663","name":"New York, New York","lat":40.7142,"lng":-74.0064}

Casos de uso

  • Encontrar lugares similares cerca

    Lee category para elegir, entre las ubicaciones cercanas, las del mismo tipo.

  • Mapear los alrededores de un lugar

    Usa lat y lng de cada fila para situar los puntos y origin para marcar el centro.

  • Comparar la actividad de los lugares cercanos

    Lee post_count para ver qué lugares cercanos tienen más publicaciones.

  • Ver el nivel de precio y si está abierto

    Lee price_range y hours_status cuando vengan.

Instagram Graph API frente a EveryInfra

Comparamos la Instagram Graph API oficial y location_nearby de EveryInfra en un punto: el alcance de la plataforma.

AspectoInstagram Graph APIEveryInfra
Alcance de la plataforma"The Instagram Platform is a collection of APIs that allows your app to access data for Instagram professional accounts, including business and creator accounts."Lee las ubicaciones cercanas a una ubicación, que no son datos de ninguna cuenta profesional. No hace falta conectar antes una cuenta de Instagram a tu app.

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

  • location_id es obligatorio. Usa el id de location_detail de una publicación, o el número del enlace de la página de la ubicación. También puedes pasar el enlace.
  • Todas las filas vuelven en una respuesta y no hay página siguiente. El número de filas cambia según la ubicación.
  • Para algunas ubicaciones Instagram no da lugares cercanos. La llamada devuelve entonces un resultado vacío y no se cobra.
  • price_range y hours_status no aparecen cuando no hay nada que mostrar.
  • post_count_label es el número de publicaciones tal como lo escribe la página de Instagram, por ejemplo 2.2K posts.
  • origin es la ubicación consultada y es igual en todas las filas.

Precios

Pagas $0.000556 por llamada, no por fila. No hay paginación: todas las filas llegan en 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": "location_nearby",
  "params": {
    "location_id": "212988663"
  }
}'

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 location_nearby; 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 cercanos (instagram/location_nearby).

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 location_nearby, y los parámetros dentro de params.
- Parámetros obligatorios:
  - location_id: ID numérico de un lugar, como el id de location_detail en una publicación, o el enlace de la página del lugar (https://www.instagram.com/explore/locations/212988663/); también vale el enlace.
- 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, category, lat (Latitud), lng (Longitud), post_count, post_count_label (El número de publicaciones tal como lo…), price_range ((location_nearby) Rango de precios tal…), hours_status ((location_nearby) Estado de apertura ta…), thumbnail_url, url; 13 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "location_nearby",
  "params": {
    "location_id": "212988663"
  }
}
- 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ílocation_nearbyIdentificador de la capacidad, valor fijo.
location_idbody.paramsstringSí-ID numérico de un lugar, como el id de location_detail en una publicación, o el enlace de la página del lugar (https://www.instagram.com/explore/locations/212988663/); también vale el enlace.

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": "location_nearby",  "results": [    {      "rank": 1,      "location_id": "105978888134411",      "name": "Long Island City",      "category": "Government Building",      "lat": 40.714199791679,      "lng": -74.006406068802,      "post_count": 2200,      "post_count_label": "2.2K posts",      "thumbnail_url": "https://scontent-lax7-1.cdninstagram.com/v/t51.82787-15/894460983_17948449221127280_215263549254016924_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=110&_nc_map=urlgen_bucketless&ig_cache_key=NDAzMTk4MzE0NDE1NTc3ODIyMzE3OTQ4NDQ5MjE1MTI3Mjgw.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3R…",      "url": "https://www.instagram.com/explore/locations/105978888134411/long-island-city/",      "platform": "instagram",      "origin": {        "location_id": "212988663",        "name": "New York, New York",        "lat": 40.7142,        "lng": -74.0064      }    },    {      "rank": 2,      "location_id": "106075139432188",      "name": "New York, N.Y.",      "category": "Government organization",      "lat": 40.716666666667,      "lng": -74,      "post_count": 1400000,      "post_count_label": "1.4M posts",      "thumbnail_url": "https://scontent-lax7-1.cdninstagram.com/v/t51.71878-15/916393440_1696283865348282_5708378039583168201_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=110&_nc_map=urlgen_bucketless&ig_cache_key=NDAzNTEzNDEwNDI4MDk0MTk1MA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnh…",      "url": "https://www.instagram.com/explore/locations/106075139432188/new-york-ny/",      "platform": "instagram",      "origin": {        "location_id": "212988663",        "name": "New York, New York",        "lat": 40.7142,        "lng": -74.0064      }    }  ],  "count": 20,  "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.
categoryNombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas.
latLatitud.
lngLongitud.
post_countTotal de publicaciones. null significa no publicado, no 0.
post_count_labelEl número de publicaciones tal como lo escribe Instagram, como 2.2K posts.
price_range(location_nearby) Rango de precios tal como lo escribe Instagram, como $$; no aparece cuando no hay.
hours_status(location_nearby) Estado de apertura tal como lo escribe Instagram; no aparece cuando no hay.
thumbnail_urlEnlace a la miniatura, con menos resolución que image_url.
urlEnlace al registro en la plataforma.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
origin(location_nearby) El lugar que consultaste, igual en todas las filas: location_id, name, lat, lng.

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 cercanas de Instagram?

Cada fila es una ubicación cercana: location_id, name, category, lat, lng, post_count y url, y algunas filas traen también price_range y hours_status.

¿Se puede paginar?

No. Una llamada devuelve todas las filas y no hay next_page_token. El número de filas cambia según la ubicación.

¿Qué indica rank?

rank es el orden de la fila dentro de este resultado, empezando en 1.

¿Cuánto cuesta leer las ubicaciones cercanas?

Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas, por llamada y no por 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 location_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_info para leer los datos de una ubicación cercana.

Google Analytics solo si aceptas. Privacidad