Skip to main content
POST
La versión granular de conteo por entidad. En lugar de conteos regresa cada lugar individual con su marca, institución, coordenadas y categorías, y solo incluye lugares activos. Acepta el mismo geo_filter de tres modos (radio, dirección, entidad) y además un objeto filters para acotar por catálogo.
  • category_ids, brand_ids e institution_ids incluyen solo esas categorías, marcas o instituciones.
  • exclude_category_ids, exclude_brand_ids y exclude_institution_ids hacen lo contrario, todo excepto lo listado.
Los filtros se combinan con lógica AND. Resuelve los IDs en los catálogos.
La paginación va en el cuerpo (page, page_size), con un máximo de 500 resultados por página.

Autorizaciones

Authorization
string
header
requerido

Token de autenticación. Formato requerido: Token tu-token (la palabra Token, un espacio y tu token). Solicita tu token escribiendo a contacto@tukanmx.com.

Cuerpo

application/json
geo_filter
object

Filtro geográfico. Modos disponibles: radio (latitude, longitude, radius_km), dirección (address, radius_km) o polígono (entity_type, entity_codes).

filters
object

Filtros opcionales de inclusión/exclusión. Se combinan con lógica AND.

page
integer
predeterminado:1
page_size
integer
predeterminado:100
Rango requerido: x <= 500

Respuesta

Lista de lugares obtenida exitosamente

count
integer
page
integer
page_size
integer
geo_context
object | null
results
object[]