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

Com a grande quantidade de ofertas existentes hoje no Buscapé, surge a necessidade de desenvolvedores filtrarem os resultados das buscas por ofertas. Um dos métodos de filtragem é por palavras-chave. Para que esse filtro seja aplicado, devemos passar em nossa URL REST o parâmetro keyword.

http://sandbox.buscape.com/service/findOfferList/lomadee/application_id/country_code/?keyword=palavra-chave

O formato de URL acima é para requisições de aplicativos em desenvolvimento. Para usar esse formato em produção, você deve mudar o subdomínio sandbox para bws.

Para que a URL REST seja aceita pela API do Buscapé, é necessário informar o nome do serviço, que neste caso é o findOfferList, o ID da aplicação, o código do país e as palavras-chave desejadas para a busca.

Para exemplificar, mostraremos abaixo uma URL válida em que a palavra-chave buscada será “Dell”:

<?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="12" totalResultsSellers="16" totalResultsReturned="16" totalResultsAvailable="190" 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-12T11:16:54.862-02:00</date>
        <elapsedTime>69</elapsedTime>
        <status>success</status>
        <code>0</code>
        <message>success</message>
    </details>
    <category hasOffer="false" isFinal="true" parentCategoryId="2" id="6424">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/6424.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/notebook.html?mdapp=100&amp;mddtn=69672797"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=6424&amp;keyword=dell"/>
        </links>
        <name>Notebook</name>
    </category>
    <offer productId="221638" id="76383167" categoryId="6424">
        <offerName>Notebook Dell Inspiron i1545 Vermelho c / Intel Pentium T4300, 4GB, HD 250GB, LCD 15.6 ´ , Bluetooth, Wireless e Windows 7. - cod. 34707</offerName>
        <links>
            <link type="offer" url="http://tracker.lomadee.com/tr/rd?b=BC08JmUOEy5mai8cPC0HZm89NDsWDTpuMjUPc3NlZ2xobGtqamVvbm5laGdoaWxpZ2llNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3OitjbGxvaG1meDM6OiowY2hnaGlsaWdpeDM6Py4uY29ubmU2KiouZHFxKSkpcDkxMTkyO3A9MTNxKywyYS9jNioqLnttH3tsGHtsGC0_MDo8MSZwPCstPT8uO3A9MTN7bBgtOywoNz07e2wYODcwOhE4ODssEjctKntsGGtoamlpb2poaDpqaWk_amprZmhoajptOntsGHttGDU7JykxLDp7bRo6OzIyeC0_Yxp4LTAqJGNveCstOWMfGA80HRAZLggPbSoxNT8oNwlrMwQfMzQWMg0TLzQ_EBYfZW9lHAxlZWVuZW5lbmUwKzIyZW5lbmVuZW5laWhtZm1vaGllbnBuZW5wbmVvZWVuZQ--"/>
        </links>

Perceba que não foi necessário informar o código do país na URL, pois a API do Buscapé, por padrão, o define como BR.

Se você quiser obter resultados com mais de uma palavra-chave, deverá informá-las separadas por vírgula.

<?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="6" totalResultsSellers="11" totalResultsReturned="16" totalResultsAvailable="93" 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-12T11:17:38.068-02:00</date>
        <elapsedTime>68</elapsedTime>
        <status>success</status>
        <code>0</code>
        <message>success</message>
    </details>
    <category hasOffer="false" isFinal="true" parentCategoryId="2" id="6424">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/6424.jpg"/>
        <links>
            <link type="category" url="http://compare.buscape.com.br/notebook.html?mdapp=100&amp;mddtn=69672797"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=6424&amp;keyword=dell+inspiron"/>
        </links>
        <name>Notebook</name>
    </category>
    <offer productId="221638" id="76383167" categoryId="6424">
        <offerName>Notebook Dell Inspiron i1545 Vermelho c / Intel Pentium T4300, 4GB, HD 250GB, LCD 15.6 ´ , Bluetooth, Wireless e Windows 7. - cod. 34707</offerName>
        <links>
            <link type="offer" url="http://tracker.lomadee.com/tr/rd?b=J28gPWUuEQExDy4tDTMLCjAOGhUuOiAXB2gPc3NlZ2xobGtqamVvbm5laGdoaWxpZ2llNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3OitjbGxvaG1meDM6OiowY2hnaGlsaWdpeDM6Py4uY29ubmU2KiouZHFxKSkpcDkxMTkyO3A9MTNxKywyYS9jNioqLnttH3tsGHtsGC0_MDo8MSZwPCstPT8uO3A9MTN7bBgtOywoNz07e2wYODcwOhE4ODssEjctKntsGGtoamlpb2poaDpqaWk_amprZmhoajptOntsGHttGDU7JykxLDp7bRo6OzIye2wdNzAtLjcsMTB4LT9jGngtMCokY294Ky05Yx8YDzQdEBgWH29pEwRuDhcdBioLbm4tczMyMxEMOB8KMzllb2UcDGVlZW5lbmVuZTArMjJlbmVuZW5lbmVpaG1mbW9oaWVucG5lbnBuZW9lZW5l"/>
        </links>

A busca de ofertas por palavras-chave é muito eficaz e muito usada pelos diversos aplicativos desenvolvidos para o Buscapé. Use você também esse serviço e retorne melhores resultados em sua aplicação.