{ "openapi": "3.0.1", "info": { "title": "Brazil CNPJ Receita Federal Crawler", "description": "[💰 $0.99 / 1K] Look up Brazilian companies from the Receita Federal CNPJ registry. Search by CNPJ, state, activity (CNAE), city, or legal form. Get name, status, address, contacts, capital, activities, tax flags, and partners (QSA).", "version": "1.0", "x-build-id": "GxeoHEJjVo2SYUsiD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~brazil-cnpj-receita-federal-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-brazil-cnpj-receita-federal-crawler", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/solidcode~brazil-cnpj-receita-federal-crawler/runs": { "post": { "operationId": "runs-sync-solidcode-brazil-cnpj-receita-federal-crawler", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/solidcode~brazil-cnpj-receita-federal-crawler/run-sync": { "post": { "operationId": "run-sync-solidcode-brazil-cnpj-receita-federal-crawler", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "cnpjs": { "title": "CNPJ numbers", "type": "array", "description": "Look up specific companies directly by their CNPJ (the 14-digit Brazilian company tax ID). Paste one or more — with or without punctuation, e.g. '11.222.333/0001-81' or '11222333000181'. When you provide CNPJs here, the filters below are ignored and only these companies are returned.", "items": { "type": "string" } }, "state": { "title": "State (UF)", "enum": [ "", "AC", "AL", "AP", "AM", "BA", "CE", "DF", "ES", "GO", "MA", "MT", "MS", "MG", "PA", "PB", "PR", "PE", "PI", "RJ", "RN", "RS", "RO", "RR", "SC", "SP", "SE", "TO" ], "type": "string", "description": "Discover companies registered in this Brazilian state. Only used when no CNPJ numbers are given above. Leave on 'All states' to search across the whole country.", "default": "" }, "activityCode": { "title": "Activity code (CNAE)", "type": "string", "description": "Keep only companies in this business activity. Enter a CNAE code such as '6201500' (software development) or '4711301' (supermarkets). Matches the company's primary or secondary activity. Leave blank for any activity." }, "city": { "title": "City", "type": "string", "description": "Keep only companies in this city. Enter the city name, e.g. 'SAO PAULO' or 'RIO DE JANEIRO' (accents are optional). Leave blank for any city." }, "legalFormCode": { "title": "Legal form code", "type": "string", "description": "Keep only companies of a specific legal form (natureza jurídica). Enter the code, e.g. '2062' for a limited liability company (Sociedade Empresária Limitada) or '2135' for a sole proprietor (Empresário Individual). Leave blank for any legal form." }, "status": { "title": "Registration status", "enum": [ "", "ATIVA", "SUSPENSA", "INAPTA", "BAIXADA", "NULA" ], "type": "string", "description": "Keep only companies with this registration status. 'Active' returns operating companies only. 'Any status' also includes suspended, closed, and ineligible registrations.", "default": "" }, "maxResults": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "How many companies to collect. The actor stops once this number is reached but keeps the full last page, so results may slightly overshoot. Set to 0 to collect as many as possible. CNPJ lookups always return every company you list, regardless of this cap. Note for bulk discovery: the public company directory returns up to about 20 companies per filter combination, so a single broad filter (e.g. just one state) returns roughly 20 companies even if you ask for more. To collect larger volumes, combine several filters (state + activity + city) to run many targeted searches, or paste CNPJ numbers directly above — direct lookups have no such limit.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }