// docs

Casa dos Dados PDP (CNPJ)

Extrai dados cadastrais completos de empresa na Casa dos Dados a partir de um CNPJ.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Nesta documentação, os exemplos de output são preenchidos intencionalmente com valores não nulos para facilitar integração.

Chamada HTTP

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "casadosdados.com.br",
  "type": "pdp",
  "cnpj": "30.853.473/0001-00"
}'

Chamada MCP

A mesma seam também aparece no MCP hospedado como uma tool dedicada. Os argumentos reaproveitam os campos do extract, mas target e type já ficam fixos pela tool.

Ver guia completo do MCP

Endpoint

POST /v1/mcp

Tool name

casadosdados_com_br_pdp

Auth

Bearer ou X-API-Key

casadosdados_com_br_pdp tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "casadosdados_com_br_pdp",
    "arguments": {
      "cnpj": "30.853.473/0001-00",
      "executionId": "exec_example_123"
    }
  }
}

Possibilidades de input

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo	Tipo	Status	Regra	Default	Exemplo
cnpj CNPJ brasileiro usado na Casa dos Dados PDP. O backend normaliza a pontuação e consulta a empresa pelo número.	string (14 dígitos)	Obrigatório	CNPJ brasileiro com 14 digitos. Pontuacao e mascaras sao aceitas e removidas no backend.	-	30.853.473/0001-00
target Fonte alvo da extração.	enum	Obrigatório	Sempre obrigatorio no payload e deve ser casadosdados.com.br.	-	mercadolivre.com.br
type Tipo da extração: pdp, idp, plp, review ou places.	enum	Obrigatório	Sempre obrigatorio no payload e deve ser pdp.	-	pdp

Exemplos de request

Consulta por CNPJ

Informe o CNPJ com ou sem pontuação. O backend normaliza o número, faz a busca e abre a primeira página detalhada com match exato.

Consulta por CNPJ

{
  "target": "casadosdados.com.br",
  "type": "pdp",
  "cnpj": "30.853.473/0001-00"
}

Schema de response (leaf paths)

Mapa de paths de saída com tipo esperado para esta API.

responseSchema

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.source": "string",
  "data.type": "string",
  "data.parser": "string",
  "data.cnpj": "string",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.searchUrl": "string",
  "data.detailUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.searchTotal": "number",
  "data.matchedSearchResult.cnpj": "string",
  "data.matchedSearchResult.razao_social": "string",
  "data.matchedSearchResult.situacao_cadastral.situacao_atual": "string",
  "data.identifiedCompaniesCount": "number",
  "data.sameRegionCompanies[].cnpj": "string",
  "data.sameRegionCompanies[].razao_social": "string",
  "data.data.cnpj": "string",
  "data.data.razao_social": "string",
  "data.data.nome_fantasia": "string",
  "data.data.filial_numero": "number",
  "data.data.matriz_filial": "string",
  "data.data.situacao_cadastral.situacao_atual": "string",
  "data.data.endereco.municipio": "string",
  "data.data.endereco.uf": "string",
  "data.data.atividade_principal.codigo": "string",
  "data.data.atividade_principal.descricao": "string",
  "data.data.atividade_secundaria[].codigo": "string",
  "data.data.quadro_societario[].nome": "string",
  "data.data.contato_telefonico[].completo": "string",
  "data.data.contato_email[].email": "string",
  "data.data.simples.optante": "boolean",
  "data.data.mei.optante": "boolean",
  "data.data.versao": "string"
}

Exemplo de response

responseExample

{
  "requestId": "66666666-1111-4111-8111-666666666666",
  "executionId": "66666666-2222-4222-8222-666666666666",
  "data": {
    "source": "casadosdados.com.br",
    "type": "pdp",
    "parser": "nuxt_data",
    "cnpj": "30853473000100",
    "url": "https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100",
    "requestUrl": "https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100",
    "searchUrl": "https://casadosdados.com.br/solucao/cnpj?q=30853473000100",
    "detailUrl": "https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100",
    "extractedAt": "2026-03-13T12:00:00.000Z",
    "searchTotal": 1,
    "searchResults": [
      {
        "cnpj": "30853473000100",
        "razao_social": "ESTACAO RODO LANCHONETE LTDA",
        "nome_fantasia": "",
        "situacao_cadastral": {
          "situacao_atual": "ATIVA"
        }
      }
    ],
    "matchedSearchResult": {
      "cnpj": "30853473000100",
      "razao_social": "ESTACAO RODO LANCHONETE LTDA",
      "nome_fantasia": "",
      "situacao_cadastral": {
        "situacao_atual": "ATIVA"
      }
    },
    "identifiedCompaniesCount": 70350113,
    "sameRegionCompanies": [
      {
        "cnpj": "65617434000180",
        "razao_social": "65.617.434 MAMADU QUEBE JUNIOR",
        "nome_fantasia": ""
      }
    ],
    "data": {
      "cnpj": "30853473000100",
      "cnpj_raiz": "30853473",
      "filial_numero": 1,
      "razao_social": "ESTACAO RODO LANCHONETE LTDA",
      "nome_fantasia": "",
      "matriz_filial": "MATRIZ",
      "situacao_cadastral": {
        "situacao_atual": "ATIVA",
        "motivo": "SEM MOTIVO",
        "data": "2018-06-25T00:00:00Z"
      },
      "endereco": {
        "cep": "80060090",
        "logradouro": "AVENIDA PRESIDENTE AFFONSO CAMARGO",
        "numero": "330",
        "bairro": "JARDIM BOTANICO",
        "municipio": "CURITIBA",
        "uf": "PR"
      },
      "atividade_principal": {
        "codigo": "5611203",
        "descricao": "Lanchonetes, casas de chá, de sucos e similares"
      },
      "atividade_secundaria": [
        {
          "codigo": "4723700",
          "descricao": "Comércio varejista de bebidas"
        }
      ],
      "quadro_societario": [
        {
          "nome": "CLAUDIA NICOLAU",
          "qualificacao_socio": "Sócio-Administrador"
        }
      ],
      "contato_telefonico": [
        {
          "completo": "41-992285958",
          "ddd": "41",
          "numero": "992285958",
          "tipo": "celular"
        }
      ],
      "contato_email": [
        {
          "email": "CLAUCLAUNIC@HOTMAIL.COM",
          "valido": true,
          "dominio": "HOTMAIL.COM"
        }
      ],
      "simples": {
        "optante": true,
        "data_opcao_simples": "2018-06-25T00:00:00Z"
      },
      "mei": {
        "optante": false,
        "cpf": "37412564803"
      },
      "versao": "v3"
    }
  }
}

Referência completa de campos

Path	Tipo	Descrição	Exemplo
data.cnpj	string	CNPJ normalizado (somente digitos) usado na consulta.	30853473000100
data.data.atividade_principal.codigo	string	Codigo CNAE principal.	5611203
data.data.atividade_principal.descricao	string	Descricao textual da atividade principal.	Lanchonetes, casas de chá, de sucos e similares
data.data.atividade_secundaria[].codigo	string	Codigo CNAE de uma atividade secundaria.	4723700
data.data.cnpj	string	CNPJ da empresa retornada no payload detalhado.	30853473000100
data.data.contato_email[].email	string	Endereco de email identificado para a empresa.	CLAUCLAUNIC@HOTMAIL.COM
data.data.contato_telefonico[].completo	string	Telefone completo identificado para a empresa.	41-992285958
data.data.endereco.municipio	string	Municipio do endereco cadastrado.	CURITIBA
data.data.endereco.uf	string	UF do endereco cadastrado.	PR
data.data.filial_numero	number	Numero da filial no cadastro da empresa.	1
data.data.matriz_filial	string	Indicacao de matriz ou filial.	MATRIZ
data.data.mei.optante	boolean	Indica se a empresa consta como optante do MEI.	false
data.data.nome_fantasia	string	Nome fantasia informado na pagina, quando existente.
data.data.quadro_societario[].nome	string	Nome de um socio ou representante listado.	CLAUDIA NICOLAU
data.data.razao_social	string	Razao social completa da empresa.	ESTACAO RODO LANCHONETE LTDA
data.data.simples.optante	boolean	Indica se a empresa consta como optante do Simples.	true
data.data.situacao_cadastral.situacao_atual	string	Situacao cadastral atual da empresa.	ATIVA
data.data.versao	string	Versao do payload exibido pela fonte.	v3
data.detailUrl	string	URL detalhada resolvida a partir do primeiro resultado exato da busca.	https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100
data.extractedAt	string (iso datetime)	Timestamp ISO da extracao.	2026-03-13T12:00:00.000Z
data.identifiedCompaniesCount	number	Contador agregado exibido pela pagina detalhada da Casa dos Dados.	70350113
data.matchedSearchResult.cnpj	string	CNPJ do resultado de busca que bateu exatamente com a consulta.	30853473000100
data.matchedSearchResult.razao_social	string	Razao social do match exato encontrado na busca.	ESTACAO RODO LANCHONETE LTDA
data.matchedSearchResult.situacao_cadastral.situacao_atual	string	Situacao cadastral do resultado encontrado ainda na etapa de busca.	ATIVA
data.parser	string	Parser utilizado para decodificar a pagina da Casa dos Dados.	nuxt_data
data.requestUrl	string	URL efetivamente usada para extrair a pagina detalhada.	https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100
data.sameRegionCompanies[].cnpj	string	CNPJ de uma empresa listada na mesma regiao da pagina consultada.	65617434000180
data.sameRegionCompanies[].razao_social	string	Razao social de uma empresa listada na mesma regiao.	65.617.434 MAMADU QUEBE JUNIOR
data.searchTotal	number	Total de resultados retornados na busca da Casa dos Dados.	1
data.searchUrl	string	URL de busca gerada a partir do CNPJ informado.	https://casadosdados.com.br/solucao/cnpj?q=30853473000100
data.source	string	Fonte da extracao.	casadosdados.com.br
data.type	string	Tipo do seam retornado.	pdp
data.url	string	URL canonica da pagina detalhada da empresa encontrada.	https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100
executionId	string (uuid)	ID unico da execucao usado para deduplicacao e rastreio interno.	66666666-2222-4222-8222-666666666666
requestId	string (uuid)	ID unico da requisicao HTTP.	66666666-1111-4111-8111-666666666666

Erros comuns

Status	errorCode	Quando acontece
400	INVALID_PAYLOAD	JSON inválido ou violação das regras de validação do payload.
401	UNAUTHORIZED	Header Authorization ausente ou token/chave inválida.
402	INSUFFICIENT_CREDITS	Saldo de créditos insuficiente para a API solicitada.
403	FORBIDDEN	Usuário sem acesso ou API temporariamente desabilitada.
409	EXECUTION_CONFLICT	executionId conflita com uma execução em estado incompatível.
429	RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS	Limite de taxa ou limite de requisições em voo excedido.
5xx	UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR	Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.