curl "https://client.tukanmx.com/tukan-atlas/brands/?name=bbva" \
-H "Authorization: Token $API_TUKAN"
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.get(
"https://client.tukanmx.com/tukan-atlas/brands/",
headers=headers,
params={"name": "bbva"},
)
resp.raise_for_status()
for marca in resp.json()["results"]:
print(marca["brand_id"], marca["name"], marca["main_category"])
{
"count": 1,
"page": 1,
"page_size": 100,
"results": [
{
"brand_id": 2637,
"name": "BBVA",
"name_en": "BBVA",
"institution_id": "BBA830831LJ2.MX",
"main_category": "bank"
}
]
}
Catálogos
Marcas
Las marcas comerciales registradas en Atlas y sus IDs para filtrar lugares.
GET
/
brands
/
curl "https://client.tukanmx.com/tukan-atlas/brands/?name=bbva" \
-H "Authorization: Token $API_TUKAN"
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.get(
"https://client.tukanmx.com/tukan-atlas/brands/",
headers=headers,
params={"name": "bbva"},
)
resp.raise_for_status()
for marca in resp.json()["results"]:
print(marca["brand_id"], marca["name"], marca["main_category"])
{
"count": 1,
"page": 1,
"page_size": 100,
"results": [
{
"brand_id": 2637,
"name": "BBVA",
"name_en": "BBVA",
"institution_id": "BBA830831LJ2.MX",
"main_category": "bank"
}
]
}
Las más de 260 marcas comerciales cuyos establecimientos están mapeados en Atlas, de OXXO a BBVA.
Cada marca pertenece a una institución y tiene una categoría principal.
El uso típico de este catálogo es resolver el
brand_id que necesitas para los filtros de listado por entidad: busca la marca por nombre, toma su ID y úsalo en filters.brand_ids.
curl "https://client.tukanmx.com/tukan-atlas/brands/?name=bbva" \
-H "Authorization: Token $API_TUKAN"
import os
import requests
headers = {"Authorization": f"Token {os.environ['API_TUKAN']}"}
resp = requests.get(
"https://client.tukanmx.com/tukan-atlas/brands/",
headers=headers,
params={"name": "bbva"},
)
resp.raise_for_status()
for marca in resp.json()["results"]:
print(marca["brand_id"], marca["name"], marca["main_category"])
{
"count": 1,
"page": 1,
"page_size": 100,
"results": [
{
"brand_id": 2637,
"name": "BBVA",
"name_en": "BBVA",
"institution_id": "BBA830831LJ2.MX",
"main_category": "bank"
}
]
}
Autorizaciones
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.
Parámetros de consulta
Número de página
Resultados por página
Búsqueda global en name, name_en e institution_id
Ejemplo:
"farmacia"
ID exacto de la marca
Ejemplo:
1
Filtro por nombre en español (coincidencia parcial)
Ejemplo:
"ahorro"
Filtro por nombre en inglés (coincidencia parcial)
Marcas de una institución específica
Ejemplo:
"FAR970429SE2.MX"
¿Esta página le ayudó?