Guia 6 min de leitura
O que é a Apify e como usar, passo a passo e sem complicação
Neste artigo
Glossário rápido
As palavras que aparecem neste artigo, em português simples.
- Actor
- Cada ferramenta da loja da Apify. "Rodar um actor" é usar a ferramenta.
- Store
- A loja onde ficam todas as ferramentas, organizadas por assunto.
- Console
- A sua área dentro da Apify, depois de entrar na conta.
- Input
- O formulário que você preenche antes de rodar, por exemplo a lista de CNPJs.
- Start
- O botão que faz a ferramenta começar a trabalhar.
- Run
- Cada vez que você roda a ferramenta. Fica salvo no seu histórico.
- Dataset
- A tabela de resultados. Cada linha é um item encontrado (uma empresa) e cada coluna é uma informação (razão social, endereço).
- Export
- Baixar a tabela de resultados em Excel, CSV ou outro formato.
- API
- O jeito de um sistema conversar com outro sem ninguém clicar em nada, como o seu ERP pedindo dados à Apify.
- Token
- Uma senha só para programas: permite que outro sistema use a sua conta. Quem usa pelo navegador não precisa dele.
Se você caiu aqui, provavelmente alguém mandou você “usar a Apify” ou você viu o nome numa das APIs do brasildados.org e ficou sem saber por onde começar. Este guia é para quem nunca usou: explica o que é, para que serve e como fazer a primeira consulta, sem precisar programar.
Vamos usar como exemplo a consulta de CNPJ: você informa o CNPJ de uma empresa e recebe os dados oficiais da Receita Federal, como razão social, endereço e situação.
O que é a Apify
A Apify é um site onde você usa ferramentas prontas que buscam dados para você. Tem ferramenta para consultar CNPJ, para achar licitações abertas, para baixar notas fiscais, para coletar avaliações de produtos e para milhares de outras tarefas.
Pense nela como uma loja de aplicativos, só que cada “aplicativo” faz uma pesquisa por você. Em vez de abrir o site da Receita Federal, digitar um CNPJ, resolver o captcha, copiar os dados e repetir isso cem vezes, você entrega a lista de CNPJs para a ferramenta e recebe tudo pronto numa planilha.
As ferramentas rodam nos computadores da Apify, não no seu. Você não instala nada: usa tudo pelo navegador. A Apify é em inglês e tem alguns termos próprios; o glossário no começo deste artigo traduz cada um.
Para que serve a Apify no dia a dia
Alguns exemplos do que dá para fazer com as ferramentas do brasildados.org, todas com dados públicos:
- Completar um cadastro de clientes: subir uma planilha com CNPJs e receber de volta razão social, endereço, telefone e atividade de cada empresa.
- Checar um fornecedor antes de fechar contrato: ver se tem dívida com o governo, processos ou punições. O checklist para saber se uma empresa é confiável mostra como.
- Achar licitações abertas no seu ramo, em todo o Brasil.
- Baixar notas fiscais eletrônicas a partir da chave de acesso.
Como criar a conta na Apify
- Acesse a página de cadastro da Apify.
- Clique em Continue with Google, Continue with GitHub ou informe seu e-mail.
- Confirme o e-mail, se tiver usado essa opção. Pronto, você está no Console, a sua área na Apify.
A conta é grátis e não pede cartão de crédito. Todo mês você ganha US$5 de crédito para usar nas ferramentas, o que dá para testar à vontade e para um uso leve no dia a dia.
Como fazer sua primeira consulta, sem programar
1. Abra a ferramenta
Entre na página da consulta de CNPJ na Apify. Toda ferramenta tem uma página assim, com a explicação do que ela faz e o botão azul Try for free (“experimente grátis”).
A página da ferramenta na loja. O botão azul Try for free abre o formulário na sua conta.
2. Preencha o formulário
Clique em Try for free. Abre o formulário (a aba Input). Nesta ferramenta só existe um campo: a lista de CNPJs. Cole um por linha, com ou sem pontos e barras. Cabem até 500 por vez.
Cada campo do formulário vem explicado na própria página: o que preencher, se é obrigatório e um exemplo.
3. Clique em Start
A ferramenta começa a trabalhar. Para poucos CNPJs, leva alguns segundos. Você acompanha o andamento na tela.
4. Veja e baixe o resultado
Quando terminar, aparece a tabela de resultados (o dataset). Cada linha é uma empresa, e as colunas trazem razão social, nome fantasia, situação na Receita, endereço, telefone, atividade e mais. Clique em Export e escolha Excel para baixar a planilha.
Um detalhe sobre privacidade: quando o resultado traz sócios que são pessoas físicas, o CPF vem mascarado, como manda a LGPD.
O que é o token da Apify e quando você precisa dele
Até aqui você usou tudo pelo navegador e não precisou de token. Ele só entra quando você quer que outro programa faça as consultas sozinho, sem você abrir a Apify. Por exemplo:
- o sistema da empresa consultar o CNPJ automaticamente toda vez que um cliente novo é cadastrado;
- uma automação no n8n ou no Make buscar licitações toda manhã;
- o ChatGPT ou o Claude fazerem consultas enquanto você conversa com eles.
Nesses casos, o programa precisa provar que tem permissão para usar a sua conta. O token é essa prova: uma espécie de senha só para programas.
Onde encontrar o token
- Entre na sua conta da Apify.
- No menu da esquerda, clique em Settings (configurações).
- Abra a aba API & Integrations.
- Em Personal API tokens, copie o token que já existe ou clique em Create new token para criar outro.
Ao criar um token novo, dê um nome que lembre onde ele vai ser usado, como “sistema de cadastro” ou “automação de licitações”. Assim, se precisar cancelar um, você sabe qual é. Dá também para definir uma data de validade e limitar o que o token pode fazer.
Trate o token como a senha do banco: não mande por WhatsApp, não cole em planilha compartilhada e não apareça com ele num print. Se ele vazar, volte em API & Integrations e troque por um novo.
Para quem programa: a mesma consulta por API
Se você (ou o time de TI) vai integrar a consulta a um sistema, toda ferramenta tem uma aba API com exemplos prontos em várias linguagens.
A aba API traz o código de exemplo já com o nome da ferramenta.
A chamada mais simples é esta, com o token enviado no cabeçalho Authorization (nunca no endereço):
curl -X POST "https://api.apify.com/v2/actors/brasildados~brazil-enrich-data-lead-by-cnpj/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"cnpjs": ["33.000.167/0001-01"]}'A resposta é a mesma tabela de resultados, em formato JSON. Essa chamada espera a consulta terminar por até 5 minutos; para listas muito grandes, a Apify tem um modo em que você inicia a consulta e busca o resultado depois. Cada página de API do brasildados.org traz o exemplo em sete linguagens.
Próximos passos
Agora que você sabe usar uma ferramenta, todas as outras funcionam do mesmo jeito: abrir, preencher, Start, baixar. Algumas ideias para continuar:
- Tem uma planilha com muitos CNPJs? Use o enriquecimento de lista de CNPJ e receba todos completos de uma vez (abrir na Apify).
- Vai fechar negócio com uma empresa nova? Siga o checklist para saber se uma empresa é confiável.
- Quer fazer essas consultas conversando com o ChatGPT ou o Claude? Veja o que é MCP e como ligar a IA a esses dados.
- Quer ver tudo o que existe? A lista de todas as APIs do brasildados.org está organizada por assunto.
Teste as ferramentas deste artigo
Todas rodam pelo navegador, sem programar, com o crédito grátis de US$5 por mês.
Busca de Empresas por CNPJ
Dados cadastrais completos, score cadastral, sócios e contatos de qualquer CNPJ brasileiro.
Enriquecimento de Lista de CNPJs
Suba uma lista de CNPJs e receba cada um completo: razão social, endereço, contato, porte e quadro societário.
Perguntas frequentes
A Apify é gratuita?
A conta é gratuita e vem com US$5 de crédito todo mês, renovado automaticamente, sem precisar cadastrar cartão. Esse crédito cobre testes e uso leve. Se você usar mais do que isso, paga só a diferença, sem mensalidade obrigatória.
Preciso saber programar para usar a Apify?
Não. Toda ferramenta da Apify tem um formulário: você preenche, clica em Start e baixa o resultado em Excel ou CSV. Programação só entra se você quiser que outro sistema, como um ERP ou CRM, faça as consultas sozinho.
O que é um actor na Apify?
Actor é o nome que a Apify dá para cada ferramenta da loja. Cada uma faz um trabalho específico, como consultar CNPJ, buscar licitações ou coletar avaliações, e devolve o resultado numa tabela que você pode baixar.
O que é dataset na Apify?
Dataset é a tabela de resultados de uma execução. Cada linha é um item encontrado, por exemplo uma empresa, e cada coluna é uma informação, como razão social ou endereço. Você baixa essa tabela em Excel, CSV ou outros formatos.
Onde fica o token da API da Apify?
Depois de entrar na conta, vá em Settings e depois na aba API & Integrations. O token aparece em Personal API tokens, e é ali também que você cria tokens novos ou cancela um que tenha vazado.
A Apify é segura?
A Apify é uma empresa europeia que atende milhares de clientes, inclusive grandes empresas. O cuidado principal fica do seu lado: trate o token como uma senha, não compartilhe em mensagem, print ou planilha, e cancele qualquer token que tenha sido exposto.
Teste as APIs com US$5 de crédito grátis todo mês
Crie sua conta na Apify, gere o token e rode qualquer API deste artigo pelo navegador ou pelo seu código. Sem cartão para começar.