API consulta CPF, CNPJ, CEP, telefone e RG
Use cpfbuscas.fs.kg na sua integração
Se você usava .com ou .net, altere apenas a URL base. Sua chave Bearer, seu plano, a validade e os limites continuam os mesmos. Não é preciso criar outra chave nem pagar novamente.
https://cpfbuscas.fs.kg/api/v1
Mantenha os caminhos /query/<módulo> após essa base e o cabeçalho Authorization: Bearer SUA_CHAVE. Valide sua conexão em GET /api/v1/me antes de consultar.
Os endereços .com e .net estão indisponíveis no momento. Use HTTPS e evite repetir consultas automaticamente após um timeout.
Resposta rápida: a API consulta CPF, CNPJ, CEP, telefone e RG do CPF Buscas entrega dados em JSON por endpoints REST. Você valida CPF, consulta CNPJ, localiza endereço por CEP, identifica telefones, confere RG e usa módulos de API OSINT para enriquecimento e investigação digital.
Este guia reúne a api consulta cpf e também cobre api consulta telefone, api consulta cep, api consulta cnpj, api consulta rg e api osint.
Referência completa da API REST do CPF Buscas, com autenticação Bearer, exemplos de requisição, parâmetros, códigos de erro e boas práticas de LGPD.
Publicado em 10/11/2026 · Atualizado em 22/11/2026 · Leitura de 8 min · Base URL /api/v1
Equipe de Engenharia do CPF Buscas
Especialistas em APIs de dados, integração e conformidade com a LGPD. Conteúdo revisado pelo time de Compliance.
Módulos de consulta da API
Os endpoints seguem o padrão GET /api/v1/query/<modulo>, retornam JSON e exigem o header Authorization: Bearer. Veja abaixo os módulos mais usados.
API consulta CPF
Consulte CPF e receba dados cadastrais, situação, score, renda, endereços, telefones, e-mails e vínculos. Use GET /api/v1/query/cpf para validação de cadastro e enriquecimento.
API consulta CNPJ
Valide empresas e obtenha razão social, nome fantasia, CNAE, situação cadastral, sócios, capital social e endereço. Ideal para onboarding, análise de crédito e prevenção a fraudes.
API consulta CEP
Retorne endereço completo, bairro, cidade e UF a partir do CEP, além de cruzamentos com e-mails e telefones vinculados. Use para preencher cadastros e validar dados de entrega.
Ver endpoints de CEP →API consulta telefone
Identifique operadora, DDD, telefones vinculados a um CPF e busque pessoas por número. Ajuda em verificação de contato, antifraude e recuperação de cadastro.
Ver endpoints de telefone →API consulta RG
Consulte RG e documentos associados, como título de eleitor, PIS, NIS e CNH, quando disponíveis nas bases integradas. Útil para KYC e conferência de identidade.
Ver endpoints de documentos →API OSINT
Inteligência de fontes abertas com reconhecimento de alvo, busca por e-mail, dorks, inteligência de IP, leads, permutação de nomes, vazamentos, Wi-Fi e usuário social. Use com finalidade legítima e base legal (LGPD).
Ver endpoints de OSINT →| Consulta | Endpoint | Retorno principal |
|---|---|---|
| API consulta CPF | /api/v1/query/cpf | Dados cadastrais, score, renda, endereços, telefones e vínculos. |
| API consulta CNPJ | /api/v1/query/cnpj | Razão social, CNAE, situação, sócios, capital e endereço. |
| API consulta CEP | /api/v1/query/cep | Endereço completo, bairro, cidade, UF e cruzamentos. |
| API consulta telefone | /api/v1/query/telefone | Telefones, operadora, DDD e vínculos com CPF. |
| API consulta RG | /api/v1/query/rg | RG e documentos associados (título, PIS, NIS, CNH). |
| API OSINT | /api/v1/query/osint_recon | Reconhecimento de alvo, e-mail, IP, dorks, leads e usuário social. |
Respostas rápidas sobre a API
Como fazer API consulta CPF?
Envie GET /api/v1/query/cpf?cpf=00000000000 com o header Bearer. O retorno traz dados cadastrais, score, renda, endereços e telefones quando disponíveis.
Como fazer API consulta CNPJ?
Use GET /api/v1/query/cnpj?cnpj=00000000000000 para obter razão social, CNAE, situação cadastral, sócios e endereço da empresa.
Como fazer API consulta CEP?
Chame GET /api/v1/query/cep?cep=00000000 para receber endereço completo, bairro, cidade e UF, além de cruzamentos com e-mails e telefones.
Como fazer API consulta telefone?
Use GET /api/v1/query/telefone?telefone=11999999999 para identificar operadora, DDD e vínculos do número com um CPF.
Como fazer API consulta RG?
Chame GET /api/v1/query/rg?rg=000000000 para consultar RG e documentos associados, como título de eleitor, PIS, NIS e CNH.
O que é API OSINT?
É a camada de inteligência de fontes abertas: reconhecimento de alvo, busca por e-mail, inteligência de IP, dorks, leads, permutação de nomes e usuário social, sempre com finalidade legítima.
Começando
Contrate um plano de API, crie sua chave no painel e envie o cabeçalho Authorization nas consultas.
https://cpfbuscas.fs.kg/api/v1
Autenticação
Guarde sua chave em ambiente seguro e envie no cabeçalho de cada requisição protegida.
Authorization: Bearer SUA_CHAVE
Accept: application/json
Nos parâmetros, use req para obrigatório e opc para opcional.
Endereço temporário da API
A URL base atual é https://cpfbuscas.fs.kg/api/v1. Atualize a variável de ambiente ou a configuração da URL base no seu servidor. Mantenha o token Bearer e os caminhos dos endpoints.
curl 'https://cpfbuscas.fs.kg/api/v1/me' \
-H 'Authorization: Bearer SUA_CHAVE' \
-H 'Accept: application/json'
Esse endpoint valida a autenticação e informa a assinatura sem realizar uma consulta de dados. Não exponha sua chave em JavaScript público, URLs ou capturas de tela.
Os domínios .com e .net estão indisponíveis no momento. Não os configure como fallback. A troca de domínio não renova cotas nem altera o início ou o vencimento do plano.
Códigos de erro
| HTTP | O que conferir |
|---|---|
| 401 | Chave ausente, inválida ou revogada. |
| 403 | Acesso ou assinatura sem permissão. |
| 404 | Endpoint não encontrado. |
| 422 | Campos req ou formato inválido. |
| 429 | Limite de uso atingido. Aguarde a renovação. |
| 503 | Serviço temporariamente indisponível. |
Consultas básicas
3 endpoints neste módulo.
/api/v1/query/cpf
CPF
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cpf?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/nome
Nome
Parâmetros
nomerequfopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nome?nome=SEU_NOME" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/telefone
Telefone
Parâmetros
telefonereq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/telefone?telefone=SEU_TELEFONE" \
-H "Authorization: Bearer SUA_CHAVE"
Empresas e negócios
3 endpoints neste módulo.
/api/v1/query/cnpj
CNPJ
Parâmetros
cnpjreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cnpj?cnpj=SEU_CNPJ" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/cnpj_base
CNPJ por base
Parâmetros
cnpjreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cnpj_base?cnpj=SEU_CNPJ" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/empresas_cpf
Empresas por CPF
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/empresas_cpf?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
Documentos
5 endpoints neste módulo.
/api/v1/query/rg
RG
Parâmetros
rgreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/rg?rg=SEU_RG" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/titulo
Título de eleitor
Parâmetros
tituloreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/titulo?titulo=SEU_TITULO" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/pis
PIS
Parâmetros
pisreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/pis?pis=SEU_PIS" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/nis
NIS
Parâmetros
nisreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nis?nis=SEU_NIS" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/cnh
CNH
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cnh?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
Relações
2 endpoints neste módulo.
/api/v1/query/parentes
Parentes
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/parentes?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/vizinhos
Vizinhos
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/vizinhos?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
Localização
6 endpoints neste módulo.
/api/v1/query/cep
CEP
Parâmetros
cepreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cep?cep=SEU_CEP" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/cep2
CEP emails
Parâmetros
cepreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cep2?cep=SEU_CEP" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/cep3
CEP telefones
Parâmetros
cepreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cep3?cep=SEU_CEP" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/cep4
CEP + nome
Parâmetros
cepreqnomeopclimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cep4?cep=SEU_CEP" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/endereco
Endereço
Parâmetros
ufreqlogradouroreqcidadeopclimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/endereco?uf=SEU_UF&logradouro=SEU_LOGRADOURO" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/estado
Estado
Parâmetros
ufreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/estado?uf=SEU_UF" \
-H "Authorization: Bearer SUA_CHAVE"
Busca por nome
6 endpoints neste módulo.
/api/v1/query/nome2
Nome base 2
Parâmetros
nomereq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nome2?nome=SEU_NOME" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/nome3
Nome + CPF parcial
Parâmetros
nomereqcpfopccpf_meioopclimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nome3?nome=SEU_NOME" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/nome4
Nome + cidade
Parâmetros
nomereqcidadereqlimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nome4?nome=SEU_NOME&cidade=SEU_CIDADE" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/nome5
Nome + ano
Parâmetros
nomereqanoreqlimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nome5?nome=SEU_NOME&ano=SEU_ANO" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/nome6
Nome + filiação e nascimento
Parâmetros
nomereqmaeopcnascopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nome6?nome=SEU_NOME" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/mae
Busca pelo nome da mãe
Parâmetros
maereqlimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/mae?mae=SEU_MAE" \
-H "Authorization: Bearer SUA_CHAVE"
Contato
5 endpoints neste módulo.
/api/v1/query/email
Parâmetros
emailreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/email?email=SEU_EMAIL" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/telefone_ddd
Telefones por DDD
Parâmetros
dddreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/telefone_ddd?ddd=SEU_DDD" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/telefone_full
Telefone completo
Parâmetros
phonereq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/telefone_full?phone=SEU_PHONE" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/telefone_cpf
Telefones por CPF
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/telefone_cpf?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/operadora
Operadora
Parâmetros
telefonereq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/operadora?telefone=SEU_TELEFONE" \
-H "Authorization: Bearer SUA_CHAVE"
Financeiro
7 endpoints neste módulo.
/api/v1/query/score
Score
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/score?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/renda
Renda
Parâmetros
ufopcsexoopcidade_minopcidade_maxopcminopcmaxopclimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/renda" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/gerador
Busca por filtros
Parâmetros
ufopcsexoopcidade_minopcidade_maxopcrenda_minopcrenda_maxopclimitopcformatopcrawopccursoropc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/gerador" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/cbo
CBO
Parâmetros
cboreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cbo?cbo=SEU_CBO" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/profissao
Profissão
Parâmetros
profissaoreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/profissao?profissao=SEU_PROFISSAO" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/bin
BIN
Parâmetros
binreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/bin?bin=SEU_BIN" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/banco
Banco
Parâmetros
codigoreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/banco?codigo=SEU_CODIGO" \
-H "Authorization: Bearer SUA_CHAVE"
Fotos
5 endpoints neste módulo.
/api/v1/query/foto
Foto geral
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/foto?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/foto_sp
Foto SP
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/foto_sp?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/foto_ma
Foto MA
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/foto_ma?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/foto_ro
Foto RO
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/foto_ro?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/foto_all
Foto todas as bases
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/foto_all?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
Veículos e outros
5 endpoints neste módulo.
/api/v1/query/placa
Placa
Parâmetros
placareq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/placa?placa=SEU_PLACA" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/random
Pessoa aleatória
Parâmetros
ufopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/random" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/veiculos_busca
Busca de veículos
Parâmetros
marcaopcufopcano_minopcano_maxopcmodeloopclimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/veiculos_busca" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/veiculos_placamassa
Consulta em lote por placas
Parâmetros
placasreq
Exemplo de requisição
curl -X POST "https://cpfbuscas.fs.kg/api/v1/query/veiculos_placamassa?placas=SEU_PLACAS" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/veiculos_cpf
Veículos por CPF
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/veiculos_cpf?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
Profissional e veículos
3 endpoints neste módulo.
/api/v1/query/profissionais
Profissionais
Parâmetros
nomeopcemailopcprofissaoopclimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/profissionais" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/universitarios
Universitários
Parâmetros
nomereq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/universitarios?nome=SEU_NOME" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/geo
Geo
Parâmetros
cepreqlimitopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/geo?cep=SEU_CEP" \
-H "Authorization: Bearer SUA_CHAVE"
Consultas públicas
2 endpoints neste módulo.
/api/v1/query/processos
Processos judiciais
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/processos?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/sancoes
Sanções e cadastros públicos
Parâmetros
cpfreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/sancoes?cpf=SEU_CPF" \
-H "Authorization: Bearer SUA_CHAVE"
OSINT
10 endpoints neste módulo.
/api/v1/query/osint_recon
Reconhecimento de alvo
Parâmetros
alvoreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_recon?alvo=SEU_ALVO" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/osint_vazamentos
Busca por email
Parâmetros
emailreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_vazamentos?email=SEU_EMAIL" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/osint_dorks
Busca avançada
Parâmetros
termoreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_dorks?termo=SEU_TERMO" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/osint_wifi
Busca de rede Wi-Fi
Parâmetros
bssidopctermoopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_wifi" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/osint_leads
Busca de leads
Parâmetros
qreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_leads?q=SEU_Q" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/osint_permutar
Permutação de nomes
Parâmetros
nomereqdominioopc
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_permutar?nome=SEU_NOME" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/osint_ipintel
Inteligência de IP
Parâmetros
ipreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_ipintel?ip=SEU_IP" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/osint_insta
Busca por usuário social
Parâmetros
usernamereq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_insta?username=SEU_USERNAME" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/osint_spotify
Busca por usuário de música
Parâmetros
qreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_spotify?q=SEU_Q" \
-H "Authorization: Bearer SUA_CHAVE"
/api/v1/query/osint_google
Busca por email
Parâmetros
emailreq
Exemplo de requisição
curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_google?email=SEU_EMAIL" \
-H "Authorization: Bearer SUA_CHAVE"
Segurança, LGPD e uso responsável
A API consulta CPF, CNPJ, CEP, telefone, RG e OSINT deve ser usada com finalidade legítima, base legal e controles de segurança. Aplique minimização de dados, registre a origem das consultas e limite o acesso por chave.
- Use os dados apenas para a finalidade informada ao titular.
- Mantenha política de retenção e descarte seguro das respostas.
- Restrinja chaves por ambiente e monitore erros 401, 403 e 429.
- Não use os módulos de OSINT para assédio, vigilância ilegal ou discriminação.
Saiba mais na Lei Geral de Proteção de Dados (LGPD) e na ANPD.
Planos, limites e testes
O limite de requisições depende do plano contratado. Respostas 429 indicam cota excedida; valide a chave com GET /api/v1/me antes de retomar a integração.
Compare os planos da API, crie sua conta em /cadastro e veja a visão geral em /api. Configure sua integração no domínio temporário documentado acima.
Perguntas frequentes e Q&A sobre a API
Como consultar CPF usando a API do CPF Buscas?
Crie uma chave no painel, envie o header Authorization: Bearer SUA_CHAVE e faça GET /api/v1/query/cpf?cpf=00000000000. A resposta é um JSON com os dados disponíveis na base.
A API também consulta CNPJ e CEP?
Sim. Use /api/v1/query/cnpj para empresas e sócios e /api/v1/query/cep para endereço completo, bairro, cidade, UF e cruzamentos.
A API consulta telefone e RG?
Sim. /api/v1/query/telefone traz telefones, operadora e vínculos com CPF; /api/v1/query/rg consulta RG e documentos associados, como título de eleitor, PIS, NIS e CNH quando disponíveis.
O que é API OSINT?
É o conjunto de endpoints de inteligência de fontes abertas do CPF Buscas, com reconhecimento de alvo, busca por e-mail, inteligência de IP, dorks, leads, permutação de nomes, vazamentos e usuário social. O uso deve ter finalidade legítima e respeitar a LGPD.
Qual é o limite de requisições da API?
O limite depende do plano contratado. Respostas 429 indicam cota excedida; valide sua chave com GET /api/v1/me e compare os planos em /planos.
Como devo autenticar as requisições para os endpoints protegidos?
Contrate um plano de API, crie sua chave no painel e envie o cabeçalho Authorization: Bearer SUA_CHAVE em cada requisição protegida. A documentação também indica Accept: application/json e recomenda guardar a chave em local seguro.
A mudança para o .net muda minha conta, minha chave ou minha cota?
Use https://cpfbuscas.fs.kg/api/v1 como base atual. Sua conta, chave, plano e limites continuam os mesmos. A mudança de endereço não renova a cota nem altera a validade da assinatura.
O que significa receber HTTP 429 ou HTTP 503?
HTTP 429 indica que o limite de uso foi atingido e é preciso aguardar a renovação da cota. HTTP 503 indica que o serviço está fora do ar. A troca de domínio não contorna esses limites. Os domínios antigos não devem ser usados como fallback no momento.
Há algum cuidado especial ao repetir requisições após timeout?
Sim. Valide a chave com GET /api/v1/me antes de retomar a integração e não repita POST por conta própria após timeout sem checar o resultado anterior, para evitar duplicidade ou inconsistência.
Como identificar quais campos são obrigatórios em cada endpoint?
Cada seção de endpoint lista os campos com marcação req ou opc, como cpf (req), nome (req) ou limit (opc). Campos marcados como req precisam ser enviados; caso contrário, a API pode retornar HTTP 422 por campo faltando ou formato inválido.