Encontrar códigos CNAE por atividade

GET/v1/cnaesPública, sem chave

Traduz as palavras de uma atividade ("restaurante", "dentista", "pet shop") em subclasses da CNAE 2.3, para usar no filtro cnae de /v1/buscar. Procura primeiro em categorias curadas com sinônimos do dia a dia (origem categoria, que pode reunir vários códigos) e depois no índice oficial de atividades do IBGE (origem ibge, um código). Dígitos buscam pelo código ("5611", "5611-2/01"). Quando nenhuma categoria tem todas as palavras, devolve as que têm a palavra da atividade e marca aproximado; um nome de empresa não devolve nada. Rota pública: não usa chave nem cota, e não consulta a base.

Parâmetros

qstring · queryobrigatório
Atividade, profissão ou código CNAE.
De 1 a 100 caracteres.
limitinteger · query
Entre 1 e 10. Padrão: 10.
completarboolean · query
Para digitação: a última palavra pode estar incompleta (restau).
Padrão: false.

Resposta

Sugestões, a melhor primeiro; lista vazia quando nada corresponde.

itemsarray de objeto
- rotulostring
  Nome da categoria curada ou descrição oficial da subclasse.
- codigosarray de string
  Subclasses CNAE 2.3; envie-as em cnae separadas por vírgula.
- descricoesarray de string
  Descrição oficial de cada código, na mesma ordem.
- origemstring
  Valores: categoria, ibge.
- termostringopcional
  Sinônimo ou atividade do IBGE que correspondeu à consulta.
- notastringopcional
- aproximadobooleanopcional
  Nenhuma categoria tem todas as palavras; esta tem a palavra da atividade.
metaobjeto
- fontearray de string
- classificacaostring

Erros

Status	Quando	Código
422	Parâmetro inválido.

Formatos de erro em Erros; o que conta na cota em Autenticação e cota.

curl -G https://api.fonteza.com.br/v1/cnaes \
  --data-urlencode "q=restaurante"

import requests

resposta = requests.get(
    "https://api.fonteza.com.br/v1/cnaes",
    params={"q": "restaurante"},
    timeout=30,
)
resposta.raise_for_status()
dados = resposta.json()

const url = new URL("https://api.fonteza.com.br/v1/cnaes");
url.search = new URLSearchParams({ q: "restaurante" });
const resposta = await fetch(url);
if (!resposta.ok) throw new Error(`${resposta.status}: ${await resposta.text()}`);
const dados = await resposta.json();

Resposta 200

{
  "items": [
    {
      "rotulo": "Restaurantes",
      "codigos": [
        "5611201"
      ],
      "descricoes": [
        "Restaurantes e similares"
      ],
      "origem": "categoria",
      "termo": "restaurante",
      "nota": "Pizzarias, churrascarias e japoneses não têm código próprio: todos são restaurantes."
    },
    {
      "rotulo": "Hotéis",
      "codigos": [
        "5510801"
      ],
      "descricoes": [
        "Hotéis"
      ],
      "origem": "ibge",
      "termo": "hotel com ou sem serviço de restaurante"
    }
  ],
  "meta": {
    "fonte": [
      "IBGE/CNAE 2.3",
      "Fonteza/categorias"
    ],
    "classificacao": "CNAE 2.3 subclasses"
  }
}