Listar categorías y oficios

Valores de los filtros category y trade.

GEThttps://findbytown.com/api/v1/categoriesSin cuota

Parámetros

Nombre	Tipo	Descripción
locale	en \| fr \| es	Idioma de las etiquetas y los nombres de categoría: en, fr o es. Por defecto, el idioma de tu cuenta.

Ejemplos

curl "https://findbytown.com/api/v1/categories?locale=en" \
  -H "Authorization: Bearer fbt_EXAMPLE_not_a_real_key_0000"

const res = await fetch("https://findbytown.com/api/v1/categories?locale=en", {
  headers: { Authorization: "Bearer fbt_EXAMPLE_not_a_real_key_0000" },
});
const body = await res.json();
if (!res.ok) throw new Error(body.error);
console.log(body);

import requests

res = requests.get(
    "https://findbytown.com/api/v1/categories?locale=en",
    headers={"Authorization": "Bearer fbt_EXAMPLE_not_a_real_key_0000"},
)
body = res.json()
if not res.ok:
    raise RuntimeError(body["error"])
print(body)

Respuesta

Ejemplo con valores ficticios:

{
  "data": {
    "categories": [
      {
        "slug": "construction",
        "label": "Construction",
        "count": 1200
      }
    ],
    "trades": [
      {
        "key": "plumber",
        "label": "Plumber"
      }
    ]
  }
}

Errores

Código	Estado HTTP	Significado
validation_error	400	Falta un parámetro o su formato es incorrecto. details indica cuál.
unknown_parameter	400	Este endpoint no reconoce un parámetro de consulta, normalmente por un error de escritura. details indica cuál.
use_reveal_endpoint	400	Has enviado reveal= en una lectura. Las lecturas nunca gastan cuota: usa el endpoint de revelación.
missing_api_key	401	No hay cabecera Authorization, o está vacía.
invalid_api_key	401	La clave no existe o ha sido revocada.
plan_without_api	403	El plan actual de la cuenta no incluye la API. Se aplica desde el momento en que termina un plan.
suspended	403	La cuenta está suspendida. Sus claves vuelven a funcionar si se levanta la suspensión.
rate_limited	429	Demasiadas solicitudes este minuto. Espera los segundos que indica Retry-After.
blocked	429	El acceso a los datos de empresas está temporalmente en pausa por uso automatizado, como recorrer ids. Retry-After indica el tiempo restante. Escribe a soporte si es un error.
internal_error	500	Algo ha fallado por nuestra parte. Indica requestId al escribir a soporte.

Volver a findbytown