Home > Lomadee > API & Documentação > Lista de ofertas

Lista de ofertas

Busque todas as ofertas de um determinado produto, filtrando-os por avaliação da loja, preço ou popularidade.

Nesta página:

Listagem das ofertas disponíveis apenas na Lomadee, por exemplo, notebooks da Dell / Saraiva, livros da Saraiva, etc.

Toda a documentação do serviço findOfferList da API Buscapé se aplica ao serviço findOfferList da API Lomadee. Possui os mesmos filtros, os mesmos resultados, etc, porém os links são CPA. Na API Buscapé o mesmo serviço de ofertas, os links são CPC, sendo a única diferença entre os serviços.

Como funciona?

  1. Aplicação efetua uma requisição informando o ID da categoria final ou ID do produto, assim como uma ou mais palavras-chaves ou ID da categoria mais palavras-chaves.
  2. Serviço recebe a requisição e busca a lista de ofertas na Lomadee.
  3. Serviço retorna a lista de ofertas no formato XML para aplicação.

Funcionamento da lista de ofertas

Formatos de URL aceitos

Busca por ID da categoria.

http://sandbox.buscape.com/service/findOfferList/lomadee/<application_id>/<country_code>/?categoryId=<categoryId>

Busca por ID do produto.

http://sandbox.buscape.com/service/findOfferList/lomadee/<application_id>/<country_code>/?productId=<productId>

Busca por código de barras.

http://sandbox.buscape.com/service/findOfferList/lomadee/<application_id>/<country_code>/?barcode=<barcode>

Busca por palavra-chave.

http://sandbox.buscape.com/service/findOfferList/lomadee/<application_id>/<country_code>/?keyword=<keyword>

Busca por ID da categoria e palavra-chave.

http://sandbox.buscape.com/service/findOfferList/lomadee/<application_id>/<country_code>/?categoryId=<categoryId>&keyword=<keyword>

Busca por ID da categoria e ID loja.

http://sandbox.buscape.com/service/findOfferList/lomadee/<application_id>/<country_code>/?categoryId=<categoryId>&sellerId=<sellerId>

Parâmetros

Parâmetros Tipo Descrição
categoryId Int ID da categoria
productId Int ID do produto
barcode String Código de barras do produto
keyword String Palavras-chaves

Consulte todas as categorias usadas para efetuar requisições na API do Buscapé.

Filtros

Parâmetros Tipo Descrição
results Int Número de resultados
page Int Número da página
priceMin Float Preço Mínimo
priceMax Float Preço Máximo
sort String Ordenação
  • price/dprice: Ordenação por preço
  • rate/drate: Ordenação por avaliação de usuários
  • seller/dseller: Ordenação por loja
  • installment/dinstallment: Ordenação por preço da parcela
  • numberofinstallments/dnumberofinstallments: Ordenação por número de parcelas
  • trustedStore: Ordenação por selo de empresa reconhecida no Buscapé
medal String Filtra ofertas e produtos a partir de uma determinada medalha do eBit
  • all
  • diamond
  • gold
  • silver
  • bronze

Formatos de resposta

O formato padrão de resposta é XML.

Caso queira utilizar o formato de resposta JSON, adicione o parâmetro format=json

Exemplo de requisição

http://sandbox.buscape.com/service/findOfferList/lomadee/<application_id>/<country_code>/?productId=100337

XSD Document (XML SCHEMAS)

http://developer.buscape.com/admin/lomadee.xsd

Campos de resposta

Result

Campos Tipo Descrição
details ResultDetails Detalhes da requisição
category CategoryType Dados da categoria atual
totalResultsAvailable Int Total de itens disponíveis
totalResultsReturned Int Total de itens retornados
totalPages Int Total de páginas
page Int Número da página atual
match String Retorna o tipo de pesquisa por palavra(s)-chave(s)
  • all: Pesquisa perfeita, toda(s) palavra(s)-chave(s) encontrada(s)
  • any: Pesquisa parcial, alguma(s) palavra(s)-chave(s) encontrada(s)
  • none: Pesquisa não encontrada

ResultDetails

Campos Tipo Descrição
applicationID String ID da aplicação
date String Data/Hora da requisição com timezone
elapsedTime Long Tempo de execução da requisição em milisegundos
status String Status da resposta
code Int Código da resposta
message String Mensagem da resposta

CategoryType

Campos Tipo Descrição
id Int ID da categoria
parentCategoryId Int ID da categoria pai
isFinal Boolean TRUE caso seja uma categoria final
name String Nome da categoria
links LinksType Lista de links
  • category: URL da categoria no Buscapé
  • XML: URL do serviço de busca de ofertas ou produtos pelo ID da categoria
thumbnail ThumbnailType Imagem da categoria

ProductType

Campos Tipo Descrição
id Int ID do produto
categoryId Int ID da categoria
totalSellers Int Total de empresas com ofertas para este produto
productName String Nome do produto
priceMin String Preço Mínimo
priceMax String Preço Máximo
links LinkType Links do produto
  • XML: URL do serviço de busca de ofertas pelo ID do produto
  • product: URL do produto na Lomadee
  • specification: URL da especificação do produto na Lomadee
thumbnail ThumbnailType Imagem do produto
rating RatingType Avaliação do produto
specification SpecificationType Detalhes do produto

OfferType

Campos Tipo Descrição
id Int ID da oferta
categoryId Int ID da categoria
offerName String Nome da oferta
links LinksType Links da oferta
  • offer: URL da oferta na Lomadee
thumbnail ThumbnailType Imagem da oferta
price PriceOfferType Detalhes do preço da oferta
seller SellerType Detalhes do vendedor

PriceOfferType

Campos Tipo Descrição
value String Preço da oferta
parcel ParcelType Parcela

ParcelType

Campos Tipo Descrição
value String Preço da parcela
number Int Número de parcelas
interest Double Taxa de Juros

SellerType

Campos Tipo Descrição
id Int ID do vendedor
isTrustedStore Boolean Se true, informa que a loja tem um selo de empresa reconhecida
sellerName String Nome do vendedor
extra String Outras informações da loja
thumbnail ThumbnailType Logo do vendedor
links LinksType Links da loja
  • seller: URL da loja
contacts ContactsType Lista de contatos
rating RatingType Avaliação do vendedor

CouponType

Campos Tipo Descrição
id int ID do cupom
description String Descrição do cupom
type String Tipo do cupom
  • Brinde
  • Desconto
  • Frete Grátis
  • Venda a Prazo
link String Link do cupom

ContactsType

Campos Tipo Descrição
contact ContactType Lista de contatos

ContactType

Campos Tipo Descrição
label String Descrição do contato
value String Valor do contato

LinksType

Campos Tipo Descrição
link LinkType Link

LinkType

Campos Tipo Descrição
type String Tipo do Link:
url String Endereço do link

ThumbnailType

Campos Tipo Descrição
url String Endereço imagem

RatingType

Campos Tipo Descrição
userAverageRating UserRatingType Avaliação dos usuários

UserRatingType

Campos Tipo Descrição
numComments Int Número de comentários
rating String Média das notas dos usuários
link LinkType Link da avaliação
  • XML: URL do serviço de avalição dos usuário pelo ID do produto
specification SpecificationType Avaliação por itens do produto

EBitRatingType

Campos Tipo Descrição
numComments Int Número de comentários
rating String Nota do EBIT
  • Diamente
  • Ouro
  • Prata
  • Bronze
link LinkType Link da avaliação

SpecificationType

Campos Tipo Descrição
item ItemListType Lista de itens da especificação
links LinkType Links
label String Descrição da especificação

ItemListType

Campos Tipo Descrição
label String Nome do Item
value String Valor do item

Exemplo de resposta

Listagem de ofertas para a categoria 6424 - Notebook:

http://sandbox.buscape.com/service/findOfferList/lomadee/<application_id>/<country_code>/?categoryId=<6424>
                ...
                <offer id="77444428" categoryId="6424">
                    Notebook Cce Clp - 325 C / Intel® Pentium®, Tela 14.1 ´ , 3gb, Hd 250gb, Hdmi, Linux - 3045919 Cod: 3045919
                    
                        <link type="offer" url="http://links.lomadee.com/ls/........."/>
                    
                    <thumbnail url="http://thumbnails.buscape.com.br/o......jpg"/>
                    
                        <currency abbreviation="BRL"/>
                        1199.00
                        
                            99.92
                            12
                            0.0
                        
                    
                    <seller pagamentoDigital="false" isTrustedStore="true" id="155">
                        Saraiva.com.br
                        ...
                    
                    ...
                ...

Erros

Conforme visualizado em ResultDetails, a resposta pode retornar códigos de erros.

Informações importantes

O parâmetro categoryId deve ser sempre o ID de uma categoria final.

Algumas categorias finais não possuem ofertas, apenas produtos. Neste caso a resposta do XML retornará uma lista de ofertas vazia. Para não perder o vinculo da consulta, o serviço disponibilizará a URL pronta para consulta dos produtos, informando o mesmo ID da categoria.

Aviso aos desenvolvedores

Caso o seu aplicativo seja executado em um servidor, é necessário informar aos webservices da Lomadee o IP do usuário que acessa o seu servidor. O IP do usuário deve ser informado através do parâmetro clientIp. Caso o seu aplicativo seja executado diretamente na máquina do usuário final, como aplicações mobile ou javascript, não é necessário informar o IP do usuário. Se, por exemplo, o IP do usuário que acessou o seu servidor seja 200.200.200.200, a chamada deveria ser feita assim:

http://sandbox.buscape.com/service/findOfferList/lomadee/<application_id>/<country_code>/?productId=<productId>&clientIp=200.200.200.200

Caso o aplicativo, sistema ou site utilize cache, o mesmo deverá ser de, no máximo, uma hora para produtos e categorias. No caso de ofertas, como o clique é validado através do IP do usuário e pela hora do clique, o cache não pode existir pois, se dois IP's acessam o mesmo link de oferta, o clique é invalidado.

Topo