Para obter uma lista de ofertas de produtos da Lomadee através da API do BuscaPé, usaremos o serviço Find Offer List.

Como funciona esse serviço?

Sua aplicação informa o ID da categoria final ou ID do produto, assim como uma ou mais palavras-chave ou ID da categoria mais palavras-chave ao serviço Find Offer List que recebe a requisição, busca a lista de ofertas na Lomadee e 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/lomadee//application_id/country_code/?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/lomadee///?productId=productId

Busca por código de barras

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

Busca por palavras-chave

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

Busca por ID da categoria e palavra-chave

http://sandbox.buscape.com/service/findeOfferList/lomadee///?categoryId=categoryId&keyword=keyword

Busca por ID da categoria e ID da loja

http://sandbox.buscape.com/service/findeOfferList/lomadee///?categoryId=&categoryId&sellerId=sellerId

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/lomadee/564771466d477a4458664d3d/?keyword=notebook

Baixe o código completo aqui.

Se preferir, veja aqui esse mesmo tutorial em vídeo.