Temos muitas categorias de produtos cadastradas na API do Buscapé e, com isso, nós, desenvolvedores, podemos ter a necessidade de exibir em nosso aplicativo somente ofertas de produtos de uma determinada categoria.

Para efetuarmos uma requisição REST à API do Buscapé e obtermos como retorno ofertas por categoria, precisamos seguir o seguinte formato de URL:

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

Sempre que nossas aplicações estiverem em desenvolvimento, é importante e recomendado usarmos o ambiente sandbox da API do Buscapé, assim como usamos na URL acima. Precisamos também informar o nome do serviço utilizado, que em nosso caso é o findOfferList, responsável por retornar uma lista de ofertas. Para obtermos apenas ofertas da Lomadee, precisamos informar, logo após o nome do serviço, o caminho lomadee. Caso contrário, a API nos retornará apenas ofertas do Buscapé.

Para diferenciar as requisições feitas a partir de sua aplicação, é necessário informar o APPLICATION ID (obtenha o seu e o informe em suas requisições). É necessário informar também o COUNTRY CODE, que é o código do país de origem das ofertas. São eles:

E, por fim, precisamos informar o ID da categoria correspondente a que queremos filtrar as ofertas.

Para exemplificar, usaremos um APPLICATION ID usado apenas para testes no ambiente sandbox, o código do país será BR e a categoria dos produtos ofertados será a 2922 (DVDs).

http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/BR/?categoryId=2922

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" page="1" totalPages="20667" totalResultsSellers="59" totalResultsReturned="16" totalResultsAvailable="330665" xsi:schemaLocation="http://developer.buscape.com/admin/buscape.xsd">
    <details>
        <applicationID>564771466d477a4458664d3d</applicationID>
        <applicationVersion>1.0.0.0</applicationVersion>
        <applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>
        <date>2011-12-21T15:18:17.961-02:00</date>
        <elapsedTime>61</elapsedTime>
        <status>success</status>
        <code>0</code>
        <message>success</message>
    </details>
    <category hasOffer="true" isFinal="true" parentCategoryId="0" id="2922">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2922.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/dvds.html?mdapp=100&amp;mddtn=69672797"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?categoryId=2922"/>
        </links>
        <name>DVDs</name>
    </category>
    <offer id="81578719" categoryId="2922">
        <offerName>DVD Júlia e Amigos com Fantoche Ks kids - cod. 7438890JU</offerName>
        <links>
            <link type="offer" url="http://tracker.lomadee.com/tr/rd?b=OicubmUtCjs7KjkuPBA6bRMLCxYfBgwNGDAfc3NlZ2xobGtqamVvbm5laGdoaWxpZ2llNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxPQErMDc9MWE3OmNsZ2xseDM6OiowY2hnaGlsaWdpeDM6Py4uY29ubmU2KiouZHFxKSkpcDkxMTkyO3A9MTNxKywyYS9jNioqLnttH3tsGHtsGC0_MDo8MSZwPCstPT8uO3A9MTN7bBgtOywoNz07e2wYODcwOhE4ODssEjctKntsGGtoamlpb2poaDpqaWk_amprZmhoajptOntsGBwMe2wYe20YPT8qOzkxLCcXOnttGmxnbGx4LT9jGngtMCokY294Ky05Yx8YDzQdEBYrbhpuHzEVaRocChBvJBIbMA5pOTI0ZmZvJA9lb2UcDGVlZW5lbmVuZTArMjJlbmVuZW5lbmVmb2tpZmlvZ2VucG5lbnBuZW9lZW5l"/>
        </links>

Filtre a partir da categoria necessária em sua aplicação e tenha sempre as ofertas certas, no lugar certo.

Have fun!