Brazil CNPJ registry data API: the official API or an Apify Actor?

Brazil CNPJ registry has a public official API. 1 Apify Actor in this catalogue return Brazil CNPJ registry data over HTTP too: send the input to Apify's run-sync endpoint with your token and get the records back as JSON, from $0.40 a run plus $0.99 per 1,000 results at Store prices (plus platform usage). One answers a single request directly in server mode.

Side by side

Receita Federal CNPJ open data (Dados Abertos)Apify Actors (1)
AccessPublic, self-serveApify API token (any account)
What you getReceita Federal publishes the CNPJ registry as free monthly bulk files on its file repository (arquivos.receitafederal.gov.br, folder Dados/Cadastros/CNPJ, latest folder 2026-10), linked from the dados.gov.br dataset…Rows defined by each Actor's published schema; up to 11 fields per record
PriceFree; the open data files need no key.From $0.40 a run plus $0.99 per 1,000 results (Store price, Free plan), plus platform usage
LimitsFiles are released monthly as bulk archives; Receita Federal offers no public per-record query API. Limits are not published.Synchronous calls wait up to 300 s; longer runs go asynchronous
DocsReceita Federal CNPJ open data (Dados Abertos)Apify API: run-sync

Official API facts checked 2026-11-11. CNPJ data is published as government open data; partner records contain personal data subject to Brazil's LGPD; not legal advice.

Which Actor for which job

All of them list $0.99 per 1,000 results on the Store, plus a start fee per run.

ActorReturnsFields includeCall it
Brazilian CNPJ Bulk Lookup & Partner Records Scraper One record per Brazilian company, with Receita Federal status, CNAE activities, address, Simples/MEI, tax history and full… cnpj, razaoSocial, nomeFantasia One request · Apify

Call Brazilian CNPJ Bulk Lookup & Partner Records Scraper

Server mode is on for this Actor (checked 2026-11-12): one request returns the results in the response. Set APIFY_TOKEN first; runs bill to that account.

curl (GET)

Actor on Apify
curl -H "Authorization: Bearer $APIFY_TOKEN" \
  "https://dataspryva--brazilian-cnpj-bulk-lookup-and-partner-records.apify.actor/?mode=lookup&cnpjs=18236120000158"

Generated from the Actor's published schema and checked, not executed.

Same data, other routes

When a call fails

Why does the workflow or script stop with HTTP 408?

The synchronous endpoint waits at most 300 seconds. After that it answers 408 while the run keeps going in Apify. Lower the result limit, or start the run asynchronously, wait for it to finish and then read its dataset.

Source: Apify API: run Actor synchronously and get dataset items

What do 400, 401, 402 and 403 from the Apify API mean?

Read error.type in the response body. 400 is invalid Actor input. 401 (user-or-token-not-found) means a token reached Apify but it is wrong or revoked. 402 with x402-payment-required means no token reached Apify at all: the n8n credential or the Authorization: Bearer header is missing, and Apify is offering its pay-per-run x402 route for agents instead; any other 402 is an exhausted usage limit on the account that pays for the run. 403 is a token without permission for that Actor or storage.

Source: Apify API: authentication; Apify documentation: agentic payments with x402; Apify API: run Actor synchronously and get dataset items

Why does a server-mode request answer 429?

If no Actor run can take the request within 2 minutes, Apify answers 429; the first response must also arrive within 5 minutes. Retry after a short pause, and send one request at a time while you test.

Source: Apify documentation: Standby mode

How do I authenticate server-mode requests?

Send Authorization: Bearer with your Apify API token. A token query parameter also works and is stripped before the request reaches the Actor, but a header keeps the token out of logs and browser history.

Source: Apify documentation: Standby mode

Questions

Is there an official Brazil CNPJ registry API?

Receita Federal publishes the CNPJ registry as free monthly bulk files on its file repository (arquivos.receitafederal.gov.br, folder Dados/Cadastros/CNPJ, latest folder 2026-10), linked from the dados.gov.br dataset page. The Conecta gov.br Consulta CNPJ API is for public administration bodies. Free; the open data files need no key.

How much does Brazil CNPJ registry data cost through an Apify Actor?

The Actors listed here charge from $0.40 a run plus $0.99 per 1,000 results on the Apify Store (Free plan), checked 2026-11-12, billed to the Apify account whose token makes the call. Actor start events and platform usage can add to that.

Can I get Brazil CNPJ registry data as JSON in one HTTP request?

Yes. Brazilian CNPJ Bulk Lookup & Partner Records Scraper has server mode on: a GET or POST to the Actor's own URL returns the results in the response. Every other Actor here works through POST /v2/actors/<id>/run-sync-get-dataset-items, which waits up to 300 seconds for the run.

Can an AI agent use the same Brazil CNPJ registry data?

Yes. The Brazil CNPJ registry MCP page bundles these Actors into one Apify MCP URL for Claude, Cursor, ChatGPT, VS Code and Codex.

Is it allowed to collect Brazil CNPJ registry data?

CNPJ data is published as government open data; partner records contain personal data subject to Brazil's LGPD; not legal advice. Read Brazil CNPJ registry's terms before you build on the data.