Documentação Técnica

Anúncios Online

Descrição

O dataset de Anúncios Online traz informações relacionadas com a totalidade dos anuncios postados pela empresa consultado nos principais marketplaces e portais de anúncios da internet. Ele inclui apenas informações do vendedor em marketplaces como Mercado Livre e OLX, não considerando dados de marketplaces focados em vendedores formais. Cada empresa pode ter um ou mais perfis de vededor online cadastrados nos diferentes portais. Embora seja realizada uma unificação desses perfis a partir de informações contextuais contidas nos anuncios, uma empresa 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 desse dataset tem como origem os portais de anúncios de produtos voltados para a compra e venda entre pessoas físicas, tais como Mercado Livre e OLX. Toda a informação é extraída apenas dos elementos públicos dos anúncios, sem levar em consideração qualquer tipo de.

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çãoCNPJ🛑 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{CNPJ}"  
}  

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{CNPJ}"  
}  

Limite

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

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