Rookie API

Documentação da API

Endpoints disponíveis, autenticação, formato de retorno e exemplos práticos.

Token de acesso

Obtenha seu token via suporte no Telegram para autenticar as requisições.

REST via HTTP

Uma URL simples com GET. Funciona em qualquer linguagem com suporte HTTP.

Resposta JSON

Todos os endpoints retornam JSON estruturado, pronto para processar.

Autenticação

Todas as requisições exigem um token de acesso no caminho da URL. O token identifica sua conta e controla quais bases de dados você pode consultar.

Como obter seu token? Entre em contato com o suporte técnico via Telegram. O token é fornecido após validação da conta.

Estrutura de Requisição

As chamadas seguem o formato abaixo. Substitua os parâmetros pelos valores reais.

GET https://api.rookiedev.com/{token}/{database}/{valor}

# Exemplo real
GET https://api.rookiedev.com/MeuToken/cpf_serpro/123.456.789-00

# Python
import requests
r = requests.get("https://api.rookiedev.com/MeuToken/cpf_serpro/12345678900")
print(r.json())

# JavaScript
fetch("https://api.rookiedev.com/MeuToken/cpf_serpro/12345678900")
  .then(r => r.json())
  .then(data => console.log(data));

Formato de Retorno

Todos os endpoints retornam application/json. O campo resultado contém os dados. Campos sem informação retornam "sem informação".

Atenção: Certifique-se de tratar os campos opcionais, pois alguns podem ser arrays vazios ou null dependendo da base consultada.

GET

CPF

Consulta completa de pessoa física — dados cadastrais, endereços, telefones, e-mails, parentes, veículos e score.

GET /{token}/cpf_serpro · cpf_receita · cpf_privado/{cpf}

{
  "resultado": {
    "status": "OK",
    "cpf": "123.456.789-00",
    "nome": "JOÃO DA SILVA",
    "nascimento": "15/04/1990",
    "sexo": ["M"],
    "nacionalidade": "BRASILEIRO",
    "obito": "NÃO",
    "cbo": "sem informação",
    "pis": "sem informação",
    "filiacao": {
      "mae": "MARIA DA SILVA",
      "pai": "PEDRO DA SILVA"
    },
    "registro_geral": {
      "documento": "1234567",
      "orgao_emissor": "SSP",
      "uf_emissao": "SP"
    },
    "enderecos": [{
      "logradouro": "RUA DAS FLORES",
      "numero": "100",
      "bairro": "CENTRO",
      "cidade": "SÃO PAULO",
      "uf": "SP",
      "cep": "01310-100"
    }],
    "telefones": [{
      "ddd": "11",
      "numero": "99999-0000"
    }],
    "email": [{
      "email": "joao@email.com",
      "pessoal": "SIM",
      "email_score": "85"
    }],
    "parentes": [{
      "cpf": "987.654.321-00",
      "nome": "ANA DA SILVA",
      "vinculo": "FILHA"
    }],
    "veiculos": [{
      "placa": "XYZ1A23",
      "modelo": "TOYOTA/COROLLA",
      "doc": "123.456.789-00"
    }],
    "titulo_eleitor": {
      "documento": "1234 5678 9012",
      "zona": "001",
      "secao": "0012"
    },
    "poder_aquisitivo": {
      "renda": "R$ 5.000,00",
      "faixa": "C"
    },
    "score": {
      "CSB8": "720",
      "FAIXA_CSB8": "BOM",
      "CSBA": "680",
      "FAIXA_CSBA": "REGULAR"
    },
    "mosaic": {
      "cd_mosaic": "A1",
      "cd_mosaic_novo": "B2",
      "cd_mosaic_secundario": "C3"
    }
  }
}

// Retorno da base Receita Federal
{ "resultado": { ... } }

// Retorno da base privada
{ "resultado": { ... } }

GET

Nome

Consulta por nome completo. Retorna lista de pessoas correspondentes com dados cadastrais.

GET /{token}/nome_unificado · nome_privado/{nome completo}

// Cadastro Unificado — retorna array de resultados
{
  "resultado": [
    {
      "cpf": "123.456.789-00",
      "nome": "JOÃO DA SILVA",
      "nascimento": "15/04/1990",
      "uf": "SP"
    }
  ]
}

// Base Privada
{ "resultado": [ ... ] }

GET

Placa

Dados completos do veículo — proprietário, histórico, débitos, restrições e informações técnicas.

GET /{token}/placa_denatran · placa_detran/{placa}

{
  "Resultado": {
    "dados_veiculo": {
      "placa": "XYZ1A23",
      "chassi": "9ABCDEF1234567890",
      "marca_modelo": "TOYOTA/COROLLA SEG",
      "ano_fabricacao": "2021",
      "ano_modelo": "2022",
      "cor_veiculo": "PRATA",
      "combustivel": "GASOLINA",
      "potencia": "153",
      "motor": "2ZR-FE",
      "tipo_veiculo": "AUTOMÓVEL",
      "situacao_veiculo": "EM CIRCULAÇÃO",
      "municipio": "SÃO PAULO",
      "uf_placa": "SP"
    },
    "dados_proprietario": {
      "nome_proprietario": "JOÃO DA SILVA",
      "doc_proprietario": "321.654.987-00",
      "endereco_proprietario": {
        "endereco": "AVENIDA PAULISTA",
        "numero": "1000",
        "bairro": "BELAVISTA",
        "municipio": "SÃO PAULO",
        "uf_endereco": "SP"
      }
    },
    "restricoes": [
      { "descricao": "ALIENAÇÃO FIDUCIÁRIA" }
    ],
    "debitos": [
      { "tipo": "ipva",          "valor": "R$ 1.230,00" },
      { "tipo": "licenciamento", "valor": "R$ 145,00"   },
      { "tipo": "multa",         "valor": "R$ 320,50"   },
      { "tipo": "seguro",        "valor": "R$ 90,00"    }
    ]
  }
}

// DETRAN Estadual
{ "Resultado": { ... } }

GET

CNPJ

Dados da empresa, sócios, situação cadastral e regime tributário diretamente da Receita Federal.

GET /{token}/cnpj_receita · cnpj_simples/{cnpj}

// Receita Federal — dados da empresa
{ "resultado": { ... } }

// Simples Nacional
{ "resultado": { ... } }

GET

Telefone

Titular do número, operadora e dados cadastrais vinculados via ANATEL ou base privada.

GET /{token}/telefone_anatel · telefone_privado/{ddd+numero}

// ANATEL
{ "resultado": { ... } }

// Base Privada
{ "resultado": { ... } }

GET

CEP

Logradouro, bairro, cidade e UF a partir de um CEP via base dos Correios.

GET /{token}/cep_correios/{cep}

{
  "resultado": {
    "cep":        "01310-100",
    "logradouro": "AVENIDA PAULISTA",
    "bairro":     "BELA VISTA",
    "cidade":     "SÃO PAULO",
    "uf":         "SP",
    "ibge":       "3550308"
  }
}

GET

Email

Validação e score de e-mail, verificação de blacklist e vínculo com titular.

GET /{token}/email_antispam · email_validador/{email}

// Antispam
{ "resultado": { ... } }

// Validador Comercial
{ "resultado": { ... } }

GET

Foto

Retorna foto biométrica vinculada ao CPF via banco biométrico nacional.

GET /{token}/foto_biometria/{cpf}

{
  "resultado": {
    "cpf":   "123.456.789-00",
    "nome":  "JOÃO DA SILVA",
    "foto":  "data:image/jpeg;base64,/9j/4AAQ...",
    "fonte": "BIOMETRIA_NACIONAL"
  }
}

Precisa de ajuda?

Nossa equipe de suporte está disponível no Telegram para tirar dúvidas e fornecer tokens de acesso.

Falar com suporte