Skip to content

Documentação e referência API v1

 

INTRODUÇÃO

Olá! Bem vindo a documentação e referência para utilização de nossa API.

Vamos demonstrar como utilizar nossa API de consultas de forma simples e sem complicação.

Siga os passos a seguir para começar!

  1.  Contratar um plano adicional ou personalizado para utilização  da nossa API. *saldo da API é diferente do saldo da plataforma web.

  2.  Obter seu Token : https://web.dataseek.com.br/Home.aspx ( Seção Cadastro )   *Cuidado: mantenha seu token em local seguro

  3.  Faça um teste simples via navegador web para testar através da URL:

     https://web.dataseek.com.br/api/empresas/?token={TOKEN}&cnpj=08272014000176

     Exemplo: https://web.dataseek.com.br/api/empresas/?token=4e9e12b099af89c120e00a4e75fea2b4&cnpj=08272014000176

     4. Os créditos são mensais e cumulativos até o final do contrato, inseridos a cada dia do mês a partir da data de ativação. 
          Não será possível adiantar créditos, neste caso é necessário a contratação de um plano maior ou um plano adicional ( token diferente ).

URLS DE ACESSO

 

 CONSULTA PESSOA FÍSICA      :  https://web.dataseek.com.br/api/pessoas/

 CONSULTA PESSOA JURÍDICA :  https://web.dataseek.com.br/api/empresas/

 



Solicite agora mesmo seu acesso a nossa api através do e-mail [email protected]

https://web.dataseek.com.br/api/pessoas/


PARÂMETROS DE ENTRADA DA CONSULTA

 
  • TOKEN…. O seu token de acesso obtido no painel Dataweb.
  • CPF.…….. CPF único formato numérico, sem traços, pontos, etc.
  • EMAIL….. E-mail único sem espaços e sem aspas
Exemplo de request:
https://web.dataseek.com.br/api/pessoas/?token=Token&cpf=31231231272
https://web.dataseek.com.br/api/pessoas/?token=Token&email=e[email protected]
 
 

EXEMPLO DE SÁIDA/RETORNO DA CONSULTA

“pf”:

“cpf”:“31236062876”,
“nome”:“RICARDO DEMO VIDEO”,
“mae”:“MARIA MAE”,
“sexo”:“M”,
“dn”:“02/06/1982”,
“obito”:“”,
“idade”:“37”,
“score”:“833”,
“frisco”:“BAIXISSIMO RISCO”,
“frenda”:“Maior 8000”,
“classe”:“A”,
“escolaridade”:“SUPERIOR COMPLETO”,
“email”:[email protected],
“email2”:[email protected],
“ddd”:“”,
“tel1”:“”,
“tel2”:“”,
“tel3”:“”,
“cel1”:“11976692944”,
“cel2”:“”,
“cel3”:“”,
“endereco”:“RUA PADRE CARVALHO”,
“numero”:“68”,
“compl”:“AP 71”,
“cep”:“05427020”,
“bairro”:“PINHEIROS”,
“cidade”:“SAO PAULO”,
“uf”:“SP”

}

],
“empresas”:

“cpf”:“31236062876”,
“cnpj”:“08272014000176”,
“nm”:“DATASEEK PROCESSAMENTOS DE DADOS LTDA”,
“cargo”:“SOCIO-ADMINISTRADOR”,
“entrada”:“”,
“part”:“0”,
“nomeVinc”:“DATASEEK”

},

“cpf”:“31236062876”,
“cnpj”:“29843839000173”,
“nm”:“RIF DADOS DO BRASIL EIRELI”,
“cargo”:“SOCIO-ADMINISTRADOR”,
“entrada”:“”,
“part”:“0”,
“nomeVinc”:“RIF DATASEEK”

}

],
“status”:“OK”,
“msgRetorno”:“Consulta CPF”,
“response”:“Liberado”,
“code”:1,
“credits”:5

}

 

CLASSE C#

 

 public class Rootobject

        {

            public Pf[] pf { get; set; }

            public Empresa[] empresas { get; set; }

            public string status { get; set; }

            public string msgRetorno { get; set; }

            public string response { get; set; }

            public int code { get; set; }

            public int credits { get; set; }

        }

        public class Pf

        {

            public string cpf { get; set; }

            public string nome { get; set; }

            public string mae { get; set; }

            public string sexo { get; set; }

            public string dn { get; set; }

            public string obito { get; set; }

            public string idade { get; set; }

            public string score { get; set; }

            public string frisco { get; set; }

            public string frenda { get; set; }

            public string classe { get; set; }

            public string escolaridade { get; set; }

            public string email { get; set; }

            public string email2 { get; set; }

            public string ddd { get; set; }

            public string tel1 { get; set; }

            public string tel2 { get; set; }

            public string tel3 { get; set; }

            public string cel1 { get; set; }

            public string cel2 { get; set; }

            public string cel3 { get; set; }

            public string endereco { get; set; }

            public string numero { get; set; }

            public string compl { get; set; }

            public string cep { get; set; }

            public string bairro { get; set; }

            public string cidade { get; set; }

            public string uf { get; set; }

        }

        public class Empresa

        {

            public string cpf { get; set; }

            public string cnpj { get; set; }

            public string nm { get; set; }

            public string cargo { get; set; }

            public string entrada { get; set; }

            public string part { get; set; }

            public string nomeVinc { get; set; }

        }

 

LEGENDA DE CAMPOS

 

pf: Lista contendo campos relacionados a pessoa
  pf.cpf
  pf.nome
  pf.frenda : Faixa de renda
  pf.frisco : Faixa de risco baseada no score
  pf.dn: Data de nascimento
  pf.obito: Data de óbito ( se houver )


empresas: Lista contendo empresa(s) vinculada(s) a pessoa

  empresas.nomeVinc: Nome fantasia da empresa
  empresas.nm: Razão Social da empresa

  empresas.part: Participação na empresa ( caso seja sócio )
  empresas.entrada: Data de entrada na empresa 
  

status: Mensagem com status da consulta
msgRetorno: Tipo de consulta ou mensagem adicional

response: Resposta
code: Código de retorno da consulta ( Código 1 siginifica consulta realizada com sucesso ) Outros códigos são erros – veja seção Erros
credits: Créditos disponíveis para consultas via API

https://web.dataseek.com.br/api/empresas/


PARÂMETROS DE ENTRADA DA CONSULTA

 
  • TOKEN…. O seu token de acesso obtido no painel Dataweb.
  • CNPJ.…… CNPJ único ou múltiplos separados por vírgula.
Exemplos de request:
https://web.dataseek.com.br/api/empresas/?token=Token&CNPJ=CNPJ

https://web.dataseek.com.br/api/empresas/?token=Token&CNPJ=CNPJ1,CNPJ2,CNPJ3
 
 

EXEMPLO DE SAÍDA/RETORNO DA CONSULTA

“pj”:

“cnpj”:“08272014000176”,
“nome”:“DATASEEK PROCESSAMENTOS DE DADOS LTDA”,
“fantasia”:“DATASEEK”,
“cidade”:“SAO PAULO”,
“uf”:“SP”,
“ddd”:“11”,
“tel1”:“36445005”,
“tel2”:“”,
“tel3”:“”,
“website”:“https://www.dataseek.com.br”,
“setor”:“SERVICO”,
“atividade”:“TRATAMENTO DE DADOS, PROVEDORES DE SERVICOS DE APLICACAO E SERVICOS DE HOSPEDAGEM NA INTERNET”,
“cnae_primario”:“6311900”,
“cnae_secundario”:“6201501”,
“nj”:“SOCIEDADE EMPRESARIA LIMITADA”,
“endereco”:“RUA AFONSO SARDINHA”,
“numero”:“725”,
“compl”:“”,
“cep”:“05076000”,
“bairro”:“LAPA”,
“situacao”:“ATIVA”,
“mtz”:“MATRIZ”,
“faturamento”:“6405000”,
“operacao”:“MUITO ALTO”,
“funcionarios”:“18”,
“dominio”:“dataseek.com.br”,
“socios”:

“cpf”:“04250179826”,
“cnpj”:“08272014000176”,
“nm”:“RICARDO CRUZ FRASSON”,
“cargo”:“SOCIO-ADMINISTRADOR”,
“entrada”:“09/03/2007 00:00:00”,
“part”:“0”,
“email”:[email protected],
“email2”:[email protected]

},

“cpf”:“31236062876”,
“cnpj”:“08272014000176”,
“nm”:“RICARDO IADELUCA FRASSON”,
“cargo”:“SOCIO-ADMINISTRADOR”,
“entrada”:“09/06/2006 00:00:00”,
“part”:“99”,
“email”:[email protected],
“email2”:[email protected]

}

],
“contatos”:

“cpf”:“31236062876”,
“cnpj”:“08272014000176”,
“cbo”:“120000”,
“contato”:“Ricardo Cruz”,
“email”:[email protected],
“cargo”:“DIRETOR”

},

“cpf”:“31236062871”,
“cnpj”:“08272014000176”,
“cbo”:“120001”,
“contato”:“Diego Toledo”,
“email”:[email protected],
“cargo”:“DIRETOR”

},

“cpf”:“31236062873”,
“cnpj”:“08272014000176”,
“cbo”:“120003”,
“contato”:“Ricardo Iadeluca”,
“email”:[email protected],
“cargo”:“CEO”

},

“cpf”:“31236062874”,
“cnpj”:“08272014000176”,
“cbo”:“120004”,
“contato”:“Elton França”,
“email”:[email protected],
“cargo”:“DIRETOR COMERCIAL”

},

“cpf”:“31236062877”,
“cnpj”:“08272014000176”,
“cbo”:“121005”,
“contato”:“Ricardo Frasson”,
“email”:[email protected],
“cargo”:“DIRETOR TI”

}

]

}

],
“status”:“OK”,
“msgRetorno”:“Consulta PJ CNPJ”,
“response”:“Liberado”,
“contagem”:0,
“code”:1,
“credits”:16

}

EXEMPLO CLASSE C#

 

 public class Rootobject

        {

            public Pj[] pj { get; set; }

            public string status { get; set; }

            public string msgRetorno { get; set; }

            public string response { get; set; }

            public int contagem { get; set; }

            public int code { get; set; }

            public int credits { get; set; }

        }

        public class Pj

        {

            public string cnpj { get; set; }

            public string nome { get; set; }

            public string fantasia { get; set; }

            public string cidade { get; set; }

            public string uf { get; set; }

            public string ddd { get; set; }

            public string tel1 { get; set; }

            public string tel2 { get; set; }

            public string tel3 { get; set; }

            public string website { get; set; }

            public string setor { get; set; }

            public string atividade { get; set; }

            public string cnae_primario { get; set; }

            public string cnae_secundario { get; set; }

            public string nj { get; set; }

            public string endereco { get; set; }

            public string numero { get; set; }

            public string compl { get; set; }

            public string cep { get; set; }

            public string bairro { get; set; }

            public string situacao { get; set; }

            public string mtz { get; set; }

            public string faturamento { get; set; }

            public string operacao { get; set; }

            public string funcionarios { get; set; }

            public string dominio { get; set; }

            public Socio[] socios { get; set; }

            public Contato[] contatos { get; set; }

        }

        public class Socio

        {

            public string cpf { get; set; }

            public string cnpj { get; set; }

            public string nm { get; set; }

            public string cargo { get; set; }

            public string entrada { get; set; }

            public string part { get; set; }

            public string email { get; set; }

            public string email2 { get; set; }

        }

        public class Contato

        {

            public string cpf { get; set; }

            public string cnpj { get; set; }

            public string cbo { get; set; }

            public string contato { get; set; }

            public string email { get; set; }

            public string cargo { get; set; }

        }

LEGENDAS DE CAMPOS

 
PJ: Lista contendo campos relacionados a empresa
  PJ.cnpj  : CNPJ da empresa / CNPJ Consultado
  PJ.nome: Razão Social da empresa
  PJ.fantasia: Nome fantasia da empresa
  PJ.cidade: Munícipio do endereço da empresa

  PJ.uf: Estado do endereço da empresa
  PJ.ddd: DDD do telefone da empresa 
  PJ.tel1: Telefone primário da empresa
  PJ.tel2: Telefone secundário da empresa 
  PJ.tel3: Telefone adicional da empresa
  PJ.website: Website da empresa
  PJ.setor: Setor empresarial da empresa
  PJ.atividade: Descrição da atividade(CNAE) principal da empresa 
  PJ.cnae_primario: CNAE principal da empresa 
  PJ.cnae_secundario: CNAE secundário da empresa 
  PJ.nj: Natureza Jurídica da empresa 
  PJ.faturamento: Faturamento anual da empresa 
  PJ.funcionarios: Número de funcionários da empresa
  PJ.situacao: Situação da empresa perante a Receita Federal

socios: Lista de sócios e administradores da empresa
  socios.cpf: CPF do sócio
  socios.part: Participação do sócio
  socios.entrada: Data de entrada do sócios

contatos*: Lista de contatos das empresas com e-mail corporativo ( *Módulo especial com custo adicional )
  contatos.cpf: CPF do contato
  contatos.cnpj: CNPJ da empresa 
  contatos.cbo: Código Brasileiro de ocupação do contato
  contatos.contato: Nome do contato
  contatos.cargo: Cargo do contato
  contatos.email: E-mail corporativo do contato

status: Mensagem com status da consulta
msgRetorno: Tipo de consulta ou mensagem adicional
response: Resposta
code: Código de retorno da consulta ( Código = 1 – consulta realizada com sucesso ) Outros códigos – ver seção Erros
credits: Créditos disponíveis para consultas via API

CÓDIGOS DE ERROS 

 
“code”:2    Saldo insuficiente para consulta

“code”:3    Erro ao acessar, token inválido ou usuário sem acesso / bloqueado.
“code”
:999  Erro na consulta, parâmetros inválidos