Documentação Técnica

Anúncios Online

Descrição

O dataset de Anúncios Online traz informações relacionadas com a totalidade dos anúncios postados pelo indivíduo consultado nos principais marketplaces e portais de anúncios da internet. Ele inclui apenas informações do vendedor enquanto indivíduo, não considerando dados de marketplaces focados em vendedores formais. Cada indivíduo pode ter um ou mais perfis de vendedor online cadastrados nos diferentes portais. Embora seja realizada uma unificação desses perfis a partir de informações contextuais contidas nos anúncios, uma pessoa pode ter mais de um perfil associada a ela. Assim, o retorno deste dataset é uma lista de objetos de perfil de anunciante online, com todos os detalhes associados ao perfil listados no objeto.

Origem da Informação

Como o próprio nome implica, todos os dados deste dataset têm como origem os portais de anúncios de produtos voltados para a compra e venda entre pessoas físicas, desde sites especializados em tipos de produtos específicos (Webmotors, iCarros, Autoline e outros) até sites mais genéricos (OLX, Mercado Livre). Toda a informação é extraída apenas dos elementos públicos dos anúncios, sem levar em consideração qualquer tipo de informação fornecida pelo usuário no momento do cadastro, ao qual não temos acesso.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,050
10001 - 50000R$ 0,048
50001 - 100000R$ 0,046
100001 - 500000R$ 0,044
500001 - 1000000R$ 0,042
1000001 - 5000000R$ 34.000,00 (preço fixo)
5000001 e acimaEntre em contato

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
docDocumento de identificaçãoCPF🛑 Obrigatório

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "online_ads",
    "q": "doc{CPF}"  
}  

Filtros

CampoDescrição do filtroTipo do filtroValores Possíveis do Filtro
activeadsQuantidade de anuncios ativosMaior ou igualQualquer número inteiro
totaladsTotal de anúncios postadosMaior ou igualQualquer número inteiro
admaxvalueValor maximo dentre todos os anunciosMaior ou igualQualquer número decimal
adminvalueValor mínimo dentre todos os anunciosMaior ou igualQualquer número decimal
portalNome de um dos portais aonde foram publicados anunciosIgualQualquer nome de portal
categoryNome de uma das categoria para a qual foram publicados anúnciosIgualQualquer nome de categoria

Abaixo está um exemplo de como utilizar o parâmetro .filter(nome_do_campo=XXXX)

{  
    "Datasets": "online_ads.filter(activeads=Qualquer número inteiro)",
    "q": "doc{CPF}"  
}  

Limite

Para utilizar o campo de limite basta utilizar o parâmetro .limit(x)

{  
    "Datasets": "online_ads.limit(10)",
    "q": "doc{CPF}"  
}  
Language
Authorization
Click Try It! to start a request and see the response here!