Comece pelo recorte que você precisa

Uma listagem de empresas é mais útil quando responde a uma pergunta específica. Defina a UF, o município, o CNAE ou a situação cadastral que faz sentido para sua pesquisa. A API exige pelo menos um filtro.

O filtro de município usa o código TOM da Receita Federal, não o código IBGE. Essa diferença é importante: um código com o formato errado pode produzir uma busca vazia ou inválida. No hub, a seleção por cidade já corresponde ao código esperado.

Monte a primeira chamada

Para listar empresas ativas em Botucatu, por exemplo, use uf=SP, municipio=6249 e situacao=2. Você também pode acrescentar cnae com os sete dígitos da atividade. Confira os códigos no catálogo antes de montar um recorte diferente.

bash
curl 'https://api.apifordevs.com/api/v1/cnpj?uf=SP&municipio=6249&situacao=2&limit=10'

Percorra os resultados com cursor

  1. Leia a lista em data[0].results.
  2. Guarde next_cursor depois de processar a página.
  3. Envie esse valor em cursor, mantendo os filtros originais.
  4. Encerre quando next_cursor vier vazio.

O cursor não é um número de página. Evite alterá-lo manualmente ou tentar consultar várias páginas por índices inventados. Processar cada lote antes de avançar facilita retomar uma coleta interrompida.

Enriqueça sem perder a referência

A listagem fornece um resumo. Para os campos completos de uma empresa, consulte o CNPJ retornado na API de cadastro. Guarde a competência da base e respeite os limites: aumentar o paralelismo não substitui o controle de taxa.

Se seu objetivo é conhecer um mercado local, comece com uma amostra pequena. Valide os filtros e a qualidade do recorte antes de incorporar os dados ao CRM.

DO CONCEITO À INTEGRAÇÃO

O próximo passo está na API.

Conheça os campos, os exemplos e as regras de cada serviço antes de integrar.

Conhecer o produto