Como obter uma lista de ofertas por categoria e palavras-chave usando a API do Buscapé

Objetivando uma melhoria nos resultados das buscas por ofertas efetuadas na API do Buscapé, o desenvolvedor também pode filtrar ofertas por ID de uma categoria e também por palavras-chave.

Imagine que a sua aplicação, ou usuário, faça uma busca por ofertas com a palavra-chave “Apple”. Dessa forma, serão retornadas todas as ofertas relacionadas, como iPads, iPods, iPhones, entre outros. Se for passado na requisição o ID da categoria “Celulares e Smartphones”, naturalmente só serão retornados iPhones. Isso pode ser muito útil para filtros mais avançados em aplicativos.

Vejamos, então, como efetuar uma requisição REST para obtermos uma lista de ofertas filtrada pela categoria “Celulares e Smartphones” e também pela palavra-chave “Apple”.

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

Como podem ver, na URL REST acima, usamos o serviço findOfferList da API do Buscapé, passamos o ID do nosso aplicativo e os parâmetros categoryId e keyword, em que foram informados o ID 77 referente à categoria de “Celulares e Smartphones” e também a palavra-chave “Apple”.

Veja o resultado retornado pela API do Buscapé:

<?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="1" totalResultsSellers="11" totalResultsReturned="15" totalResultsAvailable="15" 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>2012-01-24T16:27:40.154-02:00</date>
        <elapsedTime>28</elapsedTime>
        <status>success</status>
        <code>0</code>
        <message>success</message>
    </details>
    <category hasOffer="false" isFinal="true" parentCategoryId="6420" id="77">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/77.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/celular-e-smartphone.html?mdapp=100&amp;mddtn=69672797"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=77&amp;keyword=apple"/>
        </links>
        <name>Celular e Smartphone</name>
    </category>
    <offer productId="275180" id="93447469" categoryId="77">
        <offerName>Smartphone iPhone Apple 3GS 8GB Preto Desbloqueado - 3G, Wi - Fi, GPS, Câmera 3.2MP, MP3 Player</offerName>
        <links>
            <link type="offer" url="http://tracker.buscape.com.br/tr/rd?b=b2UwDjg4ZR0MGzsvGglnMT0bCGg0GjY6OT0xNB9zc2VnbGhsa2pqZW9ubmVoZ2hpbGlnaWU2KiouZHFxPTEzLj8sO3A8Ky09Py47cD0xM3A8LHEuLDE6ASswNz0xYTc6K2NsaWtvZm54Mzo6KjBjaGdoaWxpZ2l4Mzo_Li5jb25uZTYqKi5kcXEpKSlwOTExOTI7cD0xM3ErLDJhL2M2Kioue20fe2wYe2wYLT8wOjwxJnA8Ky09Py47cD0xM3tsGC07LCg3PTt7bBg4NzA6ETg4OywSNy0qe2wYa2hqaWlvamhoOmppaT9qamtmaGhqOm06e2wYe20YPT8qOzkxLCcXOnttGmlpe2xoNTsnKTEsOnttGj8uLjI7eC0_Yxp4LTAqJGNveCstOWMfGA80HRAZcxQvMBsXEjhsaBIQFTcyMhg_CRQUAS8sZW9lHAxlZWVuZW5lbmVlZW5lbmVuZW5lZ21qamlqaGdlbnBuZW5wbmVvZWVuZQ--"/>
        </links>