Para obter uma lista de ofertas por meio da API do BuscaPé, usaremos o serviço Find Offer List.

Como funciona esse serviço?

Quando você cria uma aplicação, pode fazer com que ela pegue a lista de ofertas
de um site, usando a API do BuscaPé. Sua aplicação informa o ID do produto e/ou ID da categoria, código de barras e palavras-chave ao serviço Find Offer List que retorna os dados, por padrão, em XML.

Como requisitar esse serviço ao BuscaPé?

A API do BuscaPé utiliza a tecnologia REST no tratamento de requisições, sendo possível construir facilmente uma URL para ser executada em seu navegador, linha de comando ou código. Veja como utilizar formatos padrão de URLs para este serviço:

Busca por ID de uma categoria final

http://sandbox.buscape.com/service/findOfferList//?categoryId=categoryId

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

• Busca por ID do produto

http://sandbox.buscape.com/service/findOfferList//?productId=productId

• Busca por código de barras

http://sandbox.buscape.com/service/findOfferList//?barcode=barcode

• Busca por palavras-chave

http://sandbox.buscape.com/service/findOfferList//?keyword=keyword

Quais formatos de retorno posso obter?

Esse serviço, assim como a API do BuscaPé, nos permite por padrão obter os dados de retorno em formato XML. Podemos também obter esse retorno em formato JSON. Para isso, passe o parâmetro &format=json ao final de sua URL REST requisitada.

Como os dados são retornados por esse serviço?

Para exemplificar como os dados são retornados pelo serviço Find Offer List, vamos requisitar, à API do BuscaPé, uma lista de ofertas em que a palavra-chave seja “notebook”.

http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?keyword=notebook

Para baixar o código, clique aqui.

O que pode me auxiliar na integração?

O BuscaPé Developer disponibiliza wrappers para auxiliar os desenvolvedores a integrar sua aplicação à API do BuscaPé. Use o método findOfferList com um dos wrappers disponíveis.

Aprenda como usar o wrapper para PHP e outros.

Para obter mais detalhes sobre como usar este serviço, consulte sua documentação.