Lista de Produtos Populares

Este serviço retorna os produtos mais populares do Buscapé.

Como funciona?

Funcionamento da lista de produtos mais populares

  1. Aplicação efetua uma requisição.
  2. Serviço recebe a requisição e busca a lista de produtos no Buscapé.
  3. Serviço retorna a lista de produtos no formato XML para aplicação.

Formatos de URL aceitos

http://sandbox.buscape.com/service/topProducts/<application_id>/

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/topProducts/<application_id>/

XSD Document (XML SCHEMAS)

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

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
  • 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

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 no Buscapé
  • specification: URL da especificação do produto no Buscapé
thumbnail ThumbnailType Imagem do produto
rating RatingType Avaliação do produto
specification SpecificationType Detalhes do produto

Campos

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

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

Busca primeiros produtos da lista dos mais populares.

http://sandbox.buscape.com/service/topProducts/<application_id>/?results=1
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    
    
564771466d477a4458664d3d 1.0.0.0 http://bws-apps.buscape.com/mobile/update 2010-10-19T11:09:18.192-03:00 14 success 0 success
Sony Playstation 3 Slim 120 GB Sony Playstation 3 Slim 120 GB 850.00 2299.00 145 8.8 9.6 8.6 5.8 9.4 9.6 9.2 Blu-Ray CD DVD 1920 x 1080 Pixels 2 Sim Bluetooth Rede 10/100 integrada USB 256 Mb 1 Joystick Cabo AV Cabo de alimentação

Erros

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

Aviso aos desenvolvedores

Caso o seu aplicativo seja executado em um servidor, é necessário informar aos webservices do Buscapé 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/topProducts/<application_id>/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