API de Datos de un lugar de Instagram

Lee la ficha de una ubicación a partir de su location_id: name, category, lat, lng y post_count, por $0.56 por cada 1000 llamadas.

  • Una ubicación por llamada
  • Sirve el enlace de la página de la ubicación
  • 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_info",
      "params": {
        "location_id": "212988663"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "location_id": "212988663",
        "name": "New York, New York",
        "category": "City",
        "lat": 40.7142,
        …
      }
    }
  3. 3Campos

    location_idnamecategorylat
    212988663New York, New YorkCity40.7142
  4. 4CSV

    instagram-location_info-sample.csv location_id,name,category,lat,lng,address,city,zip,phone,website,post_count,url,platform

La solicitud lleva location_id. Vuelve un objeto JSON con name, category, lat, lng, post_count y más, que pasa a una tabla de campos y a un CSV.

Qué datos obtienes

La tabla muestra una llamada real con la ubicación 212988663, capturada el 21 de noviembre de 2026, 07:18 (UTC), que devolvió un objeto. En tus llamadas recibes estos campos según la tabla de campos. Los datos que la ubicación no tiene, como zip y website, no aparecen.

location_idnamecategorylatlngaddresscityzipphonewebsitepost_counturlplatform
212988663New York, New YorkCity40.7142-74.0064nullnullnullnullnull84324691https://www.instagram.com/explore/locations/212988663/instagram

Casos de uso

  • Crear una ficha de ubicación

    Guarda location_id, name y category como ficha básica de cada ubicación.

  • Poner ubicaciones en un mapa

    Usa lat y lng para situar el punto y name para rotularlo.

  • Comparar la actividad de varias ubicaciones

    Lee post_count para comparar el total de publicaciones de varias ubicaciones.

  • Comprobar la dirección y el sitio web

    Lee address, city y website cuando vengan. No los trates como campos siempre presentes.

Instagram Graph API frente a EveryInfra

Comparamos la Instagram Graph API oficial y location_info de EveryInfra en dos puntos: el alcance de la plataforma y el requisito de cuenta.

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 la ficha de una ubicación de Instagram, que no son datos de ninguna cuenta profesional. No hace falta conectar antes una cuenta de Instagram a tu app.
Requisito de cuenta"To use the APIs, your app users must have an Instagram professional account"La solicitud lleva location_id y una clave de API de EveryInfra. Ni tú ni tus usuarios necesitan una cuenta profesional de 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

  • 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.
  • Una llamada lee una ubicación y devuelve un objeto. No hay paginación.
  • lat y lng son las coordenadas. post_count es el total de publicaciones de la ubicación.
  • zip no aparece cuando la ubicación no lo tiene y website solo viene si existe. address, city y phone también pueden no aparecer, así que no los trates como campos siempre presentes.
  • Un número de ubicación que no existe devuelve 503 y no se cobra.
  • Esta capacidad no devuelve las publicaciones de la ubicación. Para eso usa location_posts.

Precios

Pagas $0.000556 por llamada, no por campo. Una llamada lee una ubicación. 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_info",
  "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_info; 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: Datos de un lugar (instagram/location_info).

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_info, y los parámetros dentro de params.
- Parámetros obligatorios:
  - location_id: ID numérico de un lugar: el id de location_detail en una publicación, o el número del enlace de la página del lugar, como https://www.instagram.com/explore/locations/212988663/. También vale el enlace completo.
- Devuelve un objeto. Campos principales: location_id (ID del lugar), name, category, lat (Latitud), lng (Longitud), address, city, zip ((location_info) Código postal), phone, website, post_count, url.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "location_info",
  "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_infoIdentificador de la capacidad, valor fijo.
location_idbody.paramsstringSí-ID numérico de un lugar: el id de location_detail en una publicación, o el número del enlace de la página del lugar, como https://www.instagram.com/explore/locations/212988663/. También vale el enlace completo.

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). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "instagram",  "action": "location_info",  "results": {    "location_id": "212988663",    "name": "New York, New York",    "category": "City",    "lat": 40.7142,    "lng": -74.0064,    "post_count": 84324691,    "url": "https://www.instagram.com/explore/locations/212988663/",    "platform": "instagram"  },  "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
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.
addressDirección completa tal como la da la plataforma.
cityNombre de la ciudad en el idioma de la plataforma, sin normalizar.
zip(location_info) Código postal; no aparece cuando el lugar no tiene.
phoneTeléfono de contacto tal como lo da la plataforma, sin normalizar el formato.
websiteSitio web externo indicado por la cuenta o el negocio.
post_countTotal de publicaciones. null significa no publicado, no 0.
urlEnlace al registro en la plataforma.
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é campos devuelve la API de ubicaciones de Instagram?

Devuelve un objeto: location_id, name, category, lat, lng, address, city, zip, phone, website, post_count y url. Los datos que la ubicación no ha rellenado no aparecen.

¿De dónde saco location_id?

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 lo traen los resultados de city_locations.

¿Qué es post_count?

Es el total de publicaciones de la ubicación. Para leer esas publicaciones, usa location_posts.

¿Cuánto cuesta leer una ubicación?

Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas, por llamada y no por campo. 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_nearby para listar las ubicaciones cercanas a esta.

Google Analytics solo si aceptas. Privacidad