Endereço temporário do CPF Buscas: cpfbuscas.fs.kg. Use sua conta de sempre.
CPF Buscas
Documentação para desenvolvedores

API consulta CPF, CNPJ, CEP, telefone e RG

Domínio temporário da API

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

CB

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.

Ver endpoints de CPF →

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 →
ConsultaEndpointRetorno principal
API consulta CPF/api/v1/query/cpfDados cadastrais, score, renda, endereços, telefones e vínculos.
API consulta CNPJ/api/v1/query/cnpjRazão social, CNAE, situação, sócios, capital e endereço.
API consulta CEP/api/v1/query/cepEndereço completo, bairro, cidade, UF e cruzamentos.
API consulta telefone/api/v1/query/telefoneTelefones, operadora, DDD e vínculos com CPF.
API consulta RG/api/v1/query/rgRG e documentos associados (título, PIS, NIS, CNH).
API OSINT/api/v1/query/osint_reconReconhecimento 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.

Base URL 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

HTTPO que conferir
401Chave ausente, inválida ou revogada.
403Acesso ou assinatura sem permissão.
404Endpoint não encontrado.
422Campos req ou formato inválido.
429Limite de uso atingido. Aguarde a renovação.
503Serviço temporariamente indisponível.

Consultas básicas

3 endpoints neste módulo.

GET /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"
GET /api/v1/query/nome

Nome

Parâmetros

  • nomereq
  • ufopc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nome?nome=SEU_NOME" \
  -H "Authorization: Bearer SUA_CHAVE"
GET /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.

GET /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"
GET /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"
GET /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.

GET /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"
GET /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"
GET /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"
GET /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"
GET /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.

GET /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"
GET /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.

GET /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"
GET /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"
GET /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"
GET /api/v1/query/cep4

CEP + nome

Parâmetros

  • cepreq
  • nomeopc
  • limitopc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/cep4?cep=SEU_CEP" \
  -H "Authorization: Bearer SUA_CHAVE"
GET /api/v1/query/endereco

Endereço

Parâmetros

  • ufreq
  • logradouroreq
  • cidadeopc
  • limitopc

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"
GET /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.

GET /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"
GET /api/v1/query/nome3

Nome + CPF parcial

Parâmetros

  • nomereq
  • cpfopc
  • cpf_meioopc
  • limitopc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nome3?nome=SEU_NOME" \
  -H "Authorization: Bearer SUA_CHAVE"
GET /api/v1/query/nome4

Nome + cidade

Parâmetros

  • nomereq
  • cidadereq
  • limitopc

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"
GET /api/v1/query/nome5

Nome + ano

Parâmetros

  • nomereq
  • anoreq
  • limitopc

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"
GET /api/v1/query/nome6

Nome + filiação e nascimento

Parâmetros

  • nomereq
  • maeopc
  • nascopc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/nome6?nome=SEU_NOME" \
  -H "Authorization: Bearer SUA_CHAVE"
GET /api/v1/query/mae

Busca pelo nome da mãe

Parâmetros

  • maereq
  • limitopc

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.

GET /api/v1/query/email

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"
GET /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"
GET /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"
GET /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"
GET /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.

GET /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"
GET /api/v1/query/renda

Renda

Parâmetros

  • ufopc
  • sexoopc
  • idade_minopc
  • idade_maxopc
  • minopc
  • maxopc
  • limitopc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/renda" \
  -H "Authorization: Bearer SUA_CHAVE"
GET /api/v1/query/gerador

Busca por filtros

Parâmetros

  • ufopc
  • sexoopc
  • idade_minopc
  • idade_maxopc
  • renda_minopc
  • renda_maxopc
  • limitopc
  • formatopc
  • rawopc
  • cursoropc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/gerador" \
  -H "Authorization: Bearer SUA_CHAVE"
GET /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"
GET /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"
GET /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"
GET /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.

GET /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"
GET /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"
GET /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"
GET /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"
GET /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.

GET /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"
GET /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"
GET /api/v1/query/veiculos_busca

Busca de veículos

Parâmetros

  • marcaopc
  • ufopc
  • ano_minopc
  • ano_maxopc
  • modeloopc
  • limitopc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/veiculos_busca" \
  -H "Authorization: Bearer SUA_CHAVE"
POST /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"
GET /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.

GET /api/v1/query/profissionais

Profissionais

Parâmetros

  • nomeopc
  • emailopc
  • profissaoopc
  • limitopc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/profissionais" \
  -H "Authorization: Bearer SUA_CHAVE"
GET /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"
GET /api/v1/query/geo

Geo

Parâmetros

  • cepreq
  • limitopc

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.

GET /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"
GET /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.

GET /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"
GET /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"
GET /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"
GET /api/v1/query/osint_wifi

Busca de rede Wi-Fi

Parâmetros

  • bssidopc
  • termoopc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_wifi" \
  -H "Authorization: Bearer SUA_CHAVE"
GET /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"
GET /api/v1/query/osint_permutar

Permutação de nomes

Parâmetros

  • nomereq
  • dominioopc

Exemplo de requisição

curl -X GET "https://cpfbuscas.fs.kg/api/v1/query/osint_permutar?nome=SEU_NOME" \
  -H "Authorization: Bearer SUA_CHAVE"
GET /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"
GET /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"
GET /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"
GET /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.