Para obtermos uma lista de produtos, usaremos o serviço Find Product List.

Como funciona esse serviço?

Sua aplicação efetua a requisição à API do BuscaPé informando o ID da
categoria, palavras-chave ou ambos. O serviço Find Product List a
recebe e retorna uma lista de produtos do BuscaPé em formato XML, de
acordo com os parâmetros passados.

Como obter os dados?

Para tratar as requisições realizadas, a API do BuscaPé utiliza a tecnologia REST, sendo possível construir facilmente uma URL para ser executada no navegador, na linha de comando ou no código.

Abaixo exibimos a URL para cada tipo de requisição do serviço FindProductList à API do BuscaPé:

• Busca por ID da categoria:

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

• Busca por palavra-chave:

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

• Busca por ID da categoria e palavra-chave:

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

Como é o retorno desse método?

O retorno dos dados pelo serviço pode se dar em dois formatos, XML e
JSON, sendo o primeiro o formato padrão utilizado pela API do BuscaPé.

• XML:

Como este é o formato padrão utilizado pela API do BuscaPé para retornar
os dados, devemos, pelo menos, informar um parâmetro ao fim da URL.

ID da categoria “celular”:

http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=77

Pegue aqui o código fonte

Palavra-chave “samsung”:

http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?keyword=samsung

Pegue aqui o código fonte

ID da categoria “celular” e palavra-chave “samsung”:

http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=77&keyword=samsung

Pegue aqui o código fonte

• JSON:

Podemos também definir esse retorno em formato JSON. Veja um exemplo de como defini-lo e como são os dados retornados:

http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=77&format=json

Pegue aqui o código fonte

Como me aprofundar mais no assunto?

Acompanhe nossos tutoriais semanais e também a nossa seção de documentação. Assine o feed do nosso blog e acompanhe as novidades do Fórum de discussão.

Para facilitar a vida dos desenvolvedores, o BuscaPé criou os Wrappers para sua API, desenvolvidos em PHP e em .NET. Conheça-os!