Portal iMastersPortal iMasters
Assine a newsletterNewsletter
Dev (Back & Front)ARTIGO

Obtenha uma lista de ofertas do BuscaPé determinando o preço mínimo e/ou máximo

Dev Buscapé CompanyAutor
28 de julho de 2011 às 10:00
4 min de leitura

Para obter uma lista de ofertas, por meio da API do BuscaPé, com os preços definidos, usaremos o serviço Find Offer List.

Como funciona esse serviço?

Sua aplicação informa o ID do produto e/ou ID da categoria, código de barras, palavras-chave ao serviço Find Offer List que 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 esse serviço:

  • Busca por ID de uma categoria final e preço definido
http://sandbox.buscape.com/service/findOfferList/application_id/country_code/?categoryId=categoryId&priceMin=priceMin&priceMax=priceMax

OBS: Podemos definir somente o preço mínimo ou o máximo. Para isso, informamos somente o parâmetro priceMin ou priceMax na URL.

Algumas categorias finais não possuem ofertas, apenas produtos. Nesse 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 e preço definido
http://sandbox.buscape.com/service/findOfferList/application_id/country_code/?productId=productId&priceMin=priceMin&priceMax=priceMax
  • Busca por código de barras e preço definido
http://sandbox.buscape.com/service/findOfferList/application_id/country_code/?barcode=barcode&priceMin=priceMin&priceMax=priceMax
  • Busca por palavras-chave e preço definido
http://sandbox.buscape.com/service/findOfferList/application_id/country_code?keyword=keyword&priceMin=priceMin&priceMax=priceMax
  • Busca por ID da categoria, palavra-chave e preço definido
http://sandbox.buscape.com/service/findeOfferList/application_id/country_code/?categoryId=category_id&keyword=keyword&priceMin=priceMin&priceMax=priceMax
  • Busca por ID da categoria, ID da loja e preço definido
http://sandbox.buscape.com/service/findeOfferList/application_id/country_code/?categoryId=categoryId&sellerId=sellerId&priceMin=priceMin&priceMax=priceMax

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 “nokia” e o preço esteja entre 700 e 900 reais.

http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?keyword=nokia&priceMin=700&priceMax=900
<?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="4" totalResultsSellers="20" totalResultsReturned="5" totalResultsAvailable="62" 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-06-28T09:15:50.791-03:00</date>
        <elapsedTime>6</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?mdsrc=9262544&amp;mdapp=100&amp;mddtn=51922611"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=77&amp;keyword=nokia&amp;sourceId=9262544"/>
        </links>
        <name>Celular e Smartphone</name>
    </category>
    <offer productId="259835" id="89250737" categoryId="77">
        <offerName>Nokia C6 - 00 com Câmera 5MP 3G Wi - fi Teclado Qwert GPS Integrado e Cartão 2GB - cod. 41016</offerName>
        <links>
            <link type="offer" url="http://tracker.lomadee.com/tr/rd?b=Di88Z2U_DykBbGs_GzkEMxcUNQ8YJxQybAYpc3NlZ2xobGtqamVvbm5la29nbGxob29lNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3OitjbGtnZm1reDM6LSw9Y2dsaGxramp4Mzo6KjBja29nbGxob294Mzo_Li5jb25uZTYqKi5kcXEpKSlwOTExOTI7cD0xM3ErLDJhL2M2Kioue20fe2wYe2wYLT8wOjwxJnA8Ky09Py47cD0xM3tsGC07LCg3PTt7bBg4NzA6ETg4OywSNy0qe2wYa2hqaWlvamhoOmppaT9qamtmaGhqOm06e2wYe20YNTsnKTEsOnttGjAxNTc_e2xoLiw3PTsTNzB7bRppbm57bGguLDc9OxM_JnttGmdubngtP2MaeC0wKiRjb3grLTljHxgPNB0QFhlsCRYLOhc4ZW9lHAxlZWVuZW5lbmVuZW5lbmVuZWZnbGtuaW1pZW5wbmVucG5lb2VlbmU-"/>
        </links>
        <thumbnail url="http://thumbnails.buscape.com.br/offerimg/m/a/maquinadevendas/6ba/7bd/100x100_cef8dbC41016_82852_20100923141431.jpg"/>
        <price>
            <currency abbreviation="BRL"/>
            <value>799.00</value>
            <parcel>
                <value>66.59</value>
                <number>12</number>
                <interest>0.0</interest>
            </parcel>
        </price>
        <seller pagamentoDigital="false" isTrustedStore="true" id="55206">
            <sellerName>nokia.com.br/loja</sellerName>
            <thumbnail url="http://imagem.buscape.com.br/vitrine/logo55206.gif"/>
            <links>
                <link type="seller" url="http://www.nokia.com.br"/>
            </links>
            <contacts>
                <contact label="Atendimento" value="11-30788350"/>
            </contacts>
            <rating>
                <userAverageRating>
                    <numComments>25</numComments>
                    <rating>7.0</rating>
                </userAverageRating>
                <eBitRating>
                    <numComments>25</numComments>
                    <rating>ouro</rating>
                </eBitRating>
            </rating>
        </seller>
    </offer>
    <offer id="89309046" categoryId="77">
        <offerName>Smartphone Nokia C6 - WI - FI, Camera 5.0 MP</offerName>
        <links>
            <link type="offer" url="http://tracker.lomadee.com/tr/rd?b=FRsJD2UKJw00KhkIPz8namwdGBsfCGkfGikPc3NlZ2xobGtqamVvbm5la29nbGxob29lNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxPQErMDc9MWE3OmNpaXgzOi0sPWNnbGhsa2pqeDM6OiowY2tvZ2xsaG9veDM6Py4uY29ubmU2KiouZHFxKSkpcDkxMTkyO3A9MTNxKywyYS9jNioqLnttH3tsGHtsGC0_MDo8MSZwPCstPT8uO3A9MTN7bBgtOywoNz07e2wYODcwOhE4ODssEjctKntsGGtoamlpb2poaDpqaWk_amprZmhoajptOntsGHttGDU7JykxLDp7bRowMTU3P3tsaC4sNz07Ezcwe20aaW5ue2xoLiw3PTsTPyZ7bRpnbm54LT9jGngtMCokY294Ky05Yx8YDzQdEBYZbAkWCzoXOGVvZRwMZWVlbmVuZW5lbmVuZW5lbmVmZ21uZ25qaGVucG5lbnBuZW9lZW5l"/>
        </links>
        <thumbnail url="http://thumbnails.buscape.com.br/offerimg/c/o/commcenter/f35/f36/100x100_b605daact_get_img%23p%253D009049.jpg"/>
        <price>
            <currency abbreviation="BRL"/>
            <value>799.00</value>
            <parcel>
                <value>79.90</value>
                <number>10</number>
                <interest>0.0</interest>
            </parcel>
        </price>
        <seller pagamentoDigital="false" isTrustedStore="true" id="174509">
            <sellerName>COMMCENTER</sellerName>
            <thumbnail url="http://imagem.buscape.com.br/vitrine/logo174509.gif"/>
            <links>
                <link type="seller" url="http://www.commcenter.com.br"/>
            </links>
            <contacts>
                <contact label="Televendas" value="11-40035009"/>
            </contacts>
            <rating>
                <userAverageRating>
                    <numComments>684</numComments>
                    <rating>5.0</rating>
                </userAverageRating>
                <eBitRating>
                    <numComments>684</numComments>
                    <rating>prata</rating>
                </eBitRating>
            </rating>
        </seller>
    </offer>
    <offer productId="219626" id="90919751" categoryId="77">
        <offerName>Nokia N97 GSM Vivo, Quadriband, 3G, Bluetooth, Teclado QWERTY, Câmera: 5 MP, Memória interna de 32GB.</offerName>
        <links>
            <link type="offer" url="http://tracker.lomadee.com/tr/rd?b=PAkrGmUVEik_Kh06FCQpCgo_Di8zOAsBNhwPc3NlZ2xobGtqamVvbm5la29nbGxob29lNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3OitjbG9naGxoeDM6LSw9Y2dsaGxramp4Mzo6KjBja29nbGxob294Mzo_Li5jb25uZTYqKi5kcXEpKSlwOTExOTI7cD0xM3ErLDJhL2M2Kioue20fe2wYe2wYLT8wOjwxJnA8Ky09Py47cD0xM3tsGC07LCg3PTt7bBg4NzA6ETg4OywSNy0qe2wYa2hqaWlvamhoOmppaT9qamtmaGhqOm06e2wYe20YNTsnKTEsOnttGjAxNTc_e2xoLiw3PTsTNzB7bRppbm57bGguLDc9OxM_JnttGmdubngtP2MaeC0wKiRjb3grLTljHxgPNB0QFhlsCRYLOhc4ZW9lHAxlZWVuZW5lbmVuZW5lbmVuZWduZ29naWtvZW5wbmVucG5lb2VlbmU-"/>
        </links>
        <thumbnail url="http://www.shoptech.com.br/Servlets/ImageLoader?imageName=publicidade/nokia_n97_80x80.gif"/>
        <price>
            <currency abbreviation="BRL"/>
            <value>799.00</value>
            <parcel>
                <value>133.17</value>
                <number>6</number>
                <interest>0.0</interest>
            </parcel>
        </price>
        <seller pagamentoDigital="false" isTrustedStore="false" id="1098303">
            <sellerName>Shoptech</sellerName>
            <thumbnail url="http://imagem.buscape.com.br/vitrine/logo1098303.gif"/>
            <links>
                <link type="seller" url="http://www.shoptech.com.br"/>
            </links>
            <contacts>
                <contact label="Televendas" value="11-33377490"/>
            </contacts>
            <rating>
                <userAverageRating>
                    <numComments>15</numComments>
                    <rating>6.0</rating>
                </userAverageRating>
                <eBitRating>
                    <numComments>15</numComments>
                    <rating>sob-avaliacao</rating>
                </eBitRating>
            </rating>
            <coupon id="24992">
                <link type="coupon" url="http://preco.buscape.com.br/cupom/cupom.asp?lkpm=24992&amp;id_prod=90919751&amp;id_emp=1098303"/>
                <description>Ganhe um(a) Celular Nokia 2220</description>
                <type>brinde</type>
            </coupon>
        </seller>
    </offer>
    <offer productId="259834" id="88958944" categoryId="77">
        <offerName>Celular Desbloqueado Nokia E5 Branco - Câmera 5.0, Wi - Fi, 3G, Cartão de 2GB, MP3, Bluetooth - Nokia - cod. 56935</offerName>
        <links>
            <link type="offer" url="http://tracker.lomadee.com/tr/rd?b=MRobCGVtLRkEERIgHBUUCgoHOAkIbyQ5DRkfc3NlZ2xobGtqamVvbm5la29nbGxob29lNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3OitjbGtnZm1qeDM6LSw9Y2dsaGxramp4Mzo6KjBja29nbGxob294Mzo_Li5jb25uZTYqKi5kcXEpKSlwOTExOTI7cD0xM3ErLDJhL2M2Kioue20fe2wYe2wYLT8wOjwxJnA8Ky09Py47cD0xM3tsGC07LCg3PTt7bBg4NzA6ETg4OywSNy0qe2wYa2hqaWlvamhoOmppaT9qamtmaGhqOm06e2wYe20YNTsnKTEsOnttGjAxNTc_e2xoLiw3PTsTNzB7bRppbm57bGguLDc9OxM_JnttGmdubngtP2MaeC0wKiRjb3grLTljHxgPNB0QFhlsCRYLOhc4ZW9lHAxlZWVuZW5lbmVuZW5lbmVuZWZmZ2tmZ2pqZW5wbmVucG5lb2VlbmU-"/>
        </links>
        <thumbnail url="http://thumbnails.buscape.com.br/offerimg/m/a/maquinadevendas/cf8/553/100x100_9e329e56935_149908_20110503114454.jpg"/>
        <price>
            <currency abbreviation="BRL"/>
            <value>719.10</value>
        </price>
        <seller pagamentoDigital="false" isTrustedStore="true" id="443251">
            <sellerName>City Lar</sellerName>
            <thumbnail url="http://imagem.buscape.com.br/vitrine/logo443251.gif"/>
            <links>
                <link type="seller" url="http://www.citylar.com.br"/>
            </links>
            <contacts>
                <contact label="Atendimento" value="65-33174416"/>
            </contacts>
            <rating>
                <userAverageRating>
                    <numComments>1981</numComments>
                    <rating>7.0</rating>
                </userAverageRating>
                <eBitRating>
                    <numComments>1981</numComments>
                    <rating>ouro</rating>
                </eBitRating>
            </rating>
        </seller>
    </offer>
    <offer id="89116499" categoryId="77">
        <offerName>Celular C6 Touch Screen com Teclado Qwerty, Câmera 5.0 MP e Wi - Fi Nokia - cod. 4619</offerName>
        <links>
            <link type="offer" url="http://tracker.lomadee.com/tr/rd?b=OSABHGU8DyYuGWcfEzkdKzRoFwodMDArPBwPc3NlZ2xobGtqamVvbm5la29nbGxob29lNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxPQErMDc9MWE3OmNpaXgzOi0sPWNnbGhsa2pqeDM6OiowY2tvZ2xsaG9veDM6Py4uY29ubmU2KiouZHFxKSkpcDkxMTkyO3A9MTNxKywyYS9jNioqLnttH3tsGHtsGC0_MDo8MSZwPCstPT8uO3A9MTN7bBgtOywoNz07e2wYODcwOhE4ODssEjctKntsGGtoamlpb2poaDpqaWk_amprZmhoajptOntsGHttGDU7JykxLDp7bRowMTU3P3tsaC4sNz07Ezcwe20aaW5ue2xoLiw3PTsTPyZ7bRpnbm54LT9jGngtMCokY294Ky05Yx8YDzQdEBYZbAkWCzoXOGVvZRwMZWVlbmVuZW5lbmVuZW5lbmVmZ29vaGpnZ2VucG5lbnBuZW9lZW5l"/>
        </links>
        <thumbnail url="http://thumbnails.buscape.com.br/offerimg/a/m/amercantil/daf/27c/100x100_0ae7164619_p.jpg"/>
        <price>
            <currency abbreviation="BRL"/>
            <value>839.61</value>
            <parcel>
                <value>93.29</value>
                <number>10</number>
                <interest>1.96</interest>
            </parcel>
        </price>
        <seller pagamentoDigital="false" isTrustedStore="true" id="176855">
            <sellerName>Amercantil.com</sellerName>
            <thumbnail url="http://imagem.buscape.com.br/vitrine/logo176855.gif"/>
            <links>
                <link type="seller" url="http://www.amercantil.com"/>
            </links>
            <contacts>
                <contact label="Atendimento" value="11-25075530"/>
            </contacts>
            <rating>
                <userAverageRating>
                    <numComments>2415</numComments>
                    <rating>6.0</rating>
                </userAverageRating>
                <eBitRating>
                    <numComments>2415</numComments>
                    <rating>ouro</rating>
                </eBitRating>
            </rating>
        </seller>
    </offer>
</Result>
Dev Buscapé CompanyAutor

pelo Dev Buscapé Developer desenvolvedores externos podem utilizar o WebService disponível pelo Buscapé para criar suas próprias aplicações. No Githun, acompanhe /devbuscapecompany

urlmail
Ver perfil →

Mais de Dev Buscapé Company

↳

Fios