Dev (Back & Front)ARTIGO
Como aplicar filtros na pesquisa por lista de produtos usando a API do BuscaPé
Dev Buscapé CompanyAutor
11 de agosto de 2011 às 10:30
16 min de leitura
Aprenderemos como utilizar qualquer um dos filtros disponíveis no serviço Find Product List.
O serviço Find Product List da API do BuscaPé nos permite filtrar os resultados por diversos parâmetros, de acordo com a categoria de produtos que tentamos buscar.
Para saber qual filtro poderemos usar em nossas buscas, precisamos primeiro obter uma lista de produtos de forma tradicional, como já apresentamos e procurar, no XML de retorno, pelo nó filters. Abaixo um exemplo do nó filters para cada tipo de pesquisa que fazemos.
- Busca por código da categoria
http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=9825
<category hasOffer="false" isFinal="true" parentCategoryId="3841" id="9825">
<thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9825.jpg"/>
<links>
<link type="category" url="http://compare.buscape.com.br/carros.html?mdapp=100&mddtn=69672797"/>
<link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=9825"/>
</links>
<name>Carros</name>
<filters>
<filter name="Marca" id="3381">
<value value="Volkswagen" id="111427"/>
<value value="Fiat" id="111419"/>
<value value="Chevrolet" id="111417"/>
<value value="Ford" id="111420"/>
<value value="Renault" id="112339"/>
<value value="Peugeot" id="111424"/>
<value value="Mercedes-Benz" id="165788"/>
<value value="BMW" id="111416"/>
<value value="Audi" id="112231"/>
<value value="Citroën" id="111418"/>
<value value="Mitsubishi" id="111422"/>
<value value="Toyota" id="111426"/>
<value value="Honda" id="111421"/>
<value value="Kia" id="158119"/>
<value value="Nissan" id="111423"/>
<value value="Volvo" id="112364"/>
<value value="Land Rover" id="113909"/>
<value value="Porsche" id="112328"/>
<value value="Hyundai" id="112876"/>
<value value="Subaru" id="112049"/>
(...)
</filter>
<filter name="Ano de Fabricação" id="3386">
<value value="2010" id="274606"/>
<value value="2009" id="190902"/>
<value value="2007" id="111395"/>
<value value="2008" id="164089"/>
<value value="2006" id="111394"/>
<value value="2004" id="111392"/>
<value value="2005" id="111393"/>
<value value="2001" id="111917"/>
<value value="2002" id="111912"/>
<value value="2003" id="111800"/>
<value value="2000" id="111783"/>
(...)
</filter>
<filter name="Ano do Modelo" id="3387">
<value value="2010" id="216419"/>
<value value="2008" id="117315"/>
<value value="2011" id="302317"/>
<value value="2007" id="111398"/>
<value value="2009" id="164092"/>
<value value="2005" id="111396"/>
<value value="2001" id="111840"/>
<value value="2006" id="111397"/>
<value value="2003" id="111805"/>
<value value="2004" id="111869"/>
<value value="2002" id="111820"/>
<value value="2000" id="111782"/>
(...)
</filter>
<filter name="Categoria" id="3407">
<value value="Hatch" id="111400"/>
<value value="Sedan" id="111401"/>
<value value="Utilitário Esportivo" id="111909"/>
<value value="Wagon" id="111883"/>
<value value="Pickup" id="111410"/>
<value value="Mini Van" id="112298"/>
<value value="Coupé" id="157820"/>
<value value="Furgão" id="112321"/>
<value value="Conversível" id="164095"/>
<value value="Van" id="111415"/>
<value value="Chassi" id="164419"/>
<value value="Jipe" id="111412"/>
<value value="CC" id="232281"/>
</filter>
<filter name="Modelo" id="3382">
<value value="Gol" id="111465"/>
<value value="Corsa" id="111454"/>
<value value="Palio" id="111477"/>
<value value="Clio" id="111451"/>
<value value="Golf" id="111466"/>
<value value="Parati" id="111478"/>
<value value="Focus" id="111461"/>
<value value="Astra" id="111441"/>
<value value="Fiesta" id="111458"/>
<value value="Uno" id="111484"/>
<value value="Siena" id="111481"/>
<value value="206" id="111428"/>
<value value="Vectra" id="111485"/>
<value value="Polo" id="111479"/>
<value value="Série 3" id="158429"/>
<value value="Fox" id="111462"/>
<value value="Classe C" id="157952"/>
<value value="Corolla" id="111452"/>
<value value="Celta" id="111447"/>
<value value="Palio Weekend" id="111882"/>
<value value="Scénic" id="112649"/>
<value value="Civic" id="111448"/>
<value value="A3" id="111436"/>
<value value="Mégane" id="111473"/>
<value value="Strada" id="111483"/>
<value value="Ranger" id="112629"/>
<value value="Ecosport" id="111456"/>
(...)
</filter>
<filter name="Nº de Portas" id="3384">
<value value="4" id="111494"/>
<value value="2" id="111492"/>
</filter>
<filter name="Tipo" id="3380">
<value value="Usado" id="111138"/>
<value value="0 Km" id="111137"/>
</filter>
<filter name="Versão" id="3383">
<value value="4x4" id="192479"/>
<value value="GLX" id="111810"/>
<value value="ELX" id="111891"/>
<value value="GL" id="111512"/>
<value value="EX" id="111506"/>
<value value="Expression" id="111509"/>
<value value="GLS" id="112277"/>
<value value="Plus" id="111516"/>
<value value="Exclusive" id="117647"/>
<value value="L" id="180590"/>
<value value="LX" id="111818"/>
<value value="City" id="111502"/>
<value value="Comfortline" id="114433"/>
<value value="Privilege" id="113346"/>
<value value="HLX" id="111513"/>
<value value="Authentique" id="111500"/>
<value value="CD" id="169216"/>
<value value="Elegance" id="111504"/>
<value value="Ghia" id="113119"/>
<value value="GLS 4x4" id="167539"/>
(...)
</filter>
<filter name="Cilindrada" id="3390">
<value value="2.0" id="111537"/>
<value value="1.6" id="111535"/>
<value value="1.0" id="111532"/>
<value value="1.8" id="111536"/>
<value value="1.4" id="111533"/>
<value value="2.5" id="111539"/>
<value value="3.0" id="111540"/>
<value value="2.8" id="112235"/>
<value value="2.4" id="112447"/>
<value value="3.2" id="113235"/>
<value value="2.2" id="112467"/>
<value value="2.3" id="111538"/>
<value value="3.5" id="111541"/>
<value value="2.7" id="113550"/>
<value value="1.3" id="111892"/>
<value value="1.5" id="111534"/>
<value value="3.8" id="112584"/>
<value value="4.4" id="112226"/>
<value value="3.6" id="112719"/>
(...)
</filter>
<filter name="Nº de Válvulas" id="3391">
<value value="8" id="111571"/>
<value value="16" id="111568"/>
<value value="24" id="111570"/>
<value value="20" id="112367"/>
<value value="32" id="112228"/>
<value value="12" id="112636"/>
<value value="30" id="113539"/>
<value value="18" id="157840"/>
<value value="40" id="158568"/>
<value value="36" id="157975"/>
<value value="10" id="158487"/>
<value value="48" id="158033"/>
<value value="6" id="158939"/>
<value value="0" id="157989"/>
<value value="25" id="160246"/>
</filter>
<filter name="Combustível" id="3389">
<value value="Gasolina" id="109205"/>
<value value="Flex" id="167776"/>
<value value="Diesel" id="109208"/>
<value value="Álcool" id="109206"/>
<value value="Gás Natural" id="109207"/>
<value value="Elétrico" id="316486"/>
</filter>
<filter name="Câmbio" id="3395">
<value value="Mecânico" id="165325"/>
<value value="Automático" id="109190"/>
<value value="Automático Sequencial" id="109195"/>
</filter>
</filters>
</category>
- Busca por palavra-chave
http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?keyword=puma
<category hasOffer="false" isFinal="true" parentCategoryId="2857" id="2858">
<thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2858.jpg"/>
<links>
<link type="category" url="http://compare.buscape.com.br/tenis.html?mdapp=100&mddtn=69672797"/>
<link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=2858&keyword=puma"/>
</links>
<name>Tênis</name>
<filters>
<filter name="Marca" id="3531">
<value value="Puma" id="131281"/>
<value value="3N2" id="194789"/>
<value value="50 and 50" id="200240"/>
<value value="Active" id="264667"/>
<value value="Adams" id="186696"/>
<value value="Addan" id="288033"/>
<value value="Adder" id="176488"/>
<value value="Adidas" id="129113"/>
<value value="Adio" id="174437"/>
<value value="Adrun" id="261259"/>
<value value="Adventure" id="328779"/>
<value value="Aerotech" id="168999"/>
<value value="Air" id="161433"/>
<value value="Air Show" id="259338"/>
<value value="Air Sport" id="161518"/>
<value value="Airness" id="132762"/>
<value value="Airstep" id="178075"/>
<value value="Akasha" id="176689"/>
<value value="Albarus" id="238025"/>
<value value="Alliance" id="136469"/>
(...)
</filter>
<filter name="Tipo" id="3534">
<value value="Casual" id="131510"/>
<value value="Running" id="131684"/>
<value value="Corrida" id="311864"/>
<value value="Training" id="136206"/>
<value value="Automobilismo" id="136212"/>
<value value="Caminhada" id="131468"/>
<value value="Skate" id="131722"/>
<value value="Basquete" id="131759"/>
<value value="Fitness" id="131666"/>
<value value="Kart" id="131730"/>
<value value="Tennis" id="136181"/>
<value value="Academia" id="357409"/>
<value value="Artes Marciais" id="148666"/>
<value value="Golf" id="137373"/>
<value value="Adventure" id="136186"/>
<value value="Alpinismo" id="131540"/>
<value value="Baseball" id="201196"/>
<value value="Boxe" id="131972"/>
<value value="Ciclismo" id="131474"/>
<value value="Escalada" id="131569"/>
<value value="Handball" id="131551"/>
<value value="Hockey" id="149441"/>
<value value="Luta" id="202090"/>
<value value="Náutico" id="136187"/>
<value value="Outdoor" id="197771"/>
<value value="Squash" id="179868"/>
<value value="Street" id="312323"/>
<value value="Tennis de mesa" id="360698"/>
<value value="Trilha" id="149299"/>
<value value="Vôlei" id="161812"/>
</filter>
<filter name="Sistema de Ajuste" id="3539">
<value value="Cadarço" id="131482"/>
<value value="Velcro" id="131476"/>
<value value="Elástico" id="145982"/>
<value value="Cadarço e Velcro" id="131466"/>
<value value="Sistema de Feiche" id="184690"/>
<value value="Botão" id="171975"/>
<value value="Não se Aplica" id="136646"/>
<value value="Zíper" id="131672"/>
</filter>
</filters>
</category>
- Busca por palavra-chave e código de categoria
http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=77&keyword=nokia
<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&mddtn=69672797"/>
<link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=77&keyword=nokia"/>
</links>
<name>Celular e Smartphone</name>
<filters>
<filter name="Marca" id="1117">
<value value="Nokia" id="6326"/>
<value value="Ace Mobile" id="322643"/>
<value value="Acer" id="317419"/>
<value value="Aiko" id="25407"/>
<value value="Airam" id="107728"/>
<value value="Alcatel" id="107727"/>
<value value="Anycool" id="184685"/>
<value value="Apple" id="128840"/>
<value value="Asus" id="313238"/>
<value value="Audiovox" id="112186"/>
<value value="Awang" id="224220"/>
<value value="Azumi" id="341012"/>
<value value="Baixing" id="241468"/>
<value value="Bak" id="160668"/>
<value value="BenQ-Siemens" id="50697"/>
<value value="Best" id="167164"/>
<value value="Bestel" id="316111"/>
<value value="Bird" id="110194"/>
<value value="BlackBerry" id="64298"/>
<value value="BLU" id="335859"/>
<value value="Booster" id="230246"/>
<value value="CCE" id="333593"/>
<value value="CECT" id="127464"/>
<value value="Cefon" id="213898"/>
<value value="Cellphone" id="320182"/>
<value value="Celplay" id="129360"/>
<value value="Centro" id="209638"/>
<value value="Chiefree" id="181334"/>
<value value="Clarity" id="313246"/>
<value value="Coby" id="172957"/>
<value value="Compal" id="181579"/>
<value value="CVision" id="218918"/>
<value value="Dapeng" id="331480"/>
<value value="Dell" id="246973"/>
<value value="Digipack" id="176557"/>
<value value="DotCom" id="169667"/>
<value value="DualRide" id="177963"/>
<value value="E-Ten" id="209627"/>
<value value="Easy Track" id="70032"/>
<value value="Elef" id="209630"/>
<value value="Elgin" id="170916"/>
<value value="Eten Glofish" id="209637"/>
<value value="Eyo" id="257302"/>
<value value="Flycool" id="227750"/>
<value value="Foston" id="122244"/>
<value value="Freecel" id="299433"/>
<value value="Fujilink" id="306452"/>
(...)
</filter>
<filter name="Operadora" id="1135">
<value value="Desbloqueado" id="50873"/>
<value value="Vivo" id="6444"/>
<value value="Claro" id="6441"/>
<value value="Tim" id="6443"/>
<value value="Oi" id="6442"/>
<value value="Brasil Telecom" id="48593"/>
<value value="AllTel" id="145962"/>
<value value="Amazônia Celular" id="60730"/>
<value value="AT&T" id="145964"/>
<value value="Comcel" id="130276"/>
<value value="CTI Movil" id="107729"/>
<value value="Digitel" id="335833"/>
<value value="Entel" id="111057"/>
<value value="Iusacell" id="110218"/>
<value value="Movilnet" id="232096"/>
<value value="Movistar" id="108284"/>
(...)
</filter>
<filter name="Tecnologia" id="1138">
<value value="GSM" id="6446"/>
<value value="CDMA" id="6448"/>
<value value="3G" id="259217"/>
<value value="GSM/CDMA" id="209837"/>
<value value="Iden" id="48615"/>
<value value="TDMA" id="6447"/>
<value value="WCDMA/GSM" id="210723"/>
</filter>
<filter name="Quantidade de Chips" id="5275">
<value value="1" id="338254"/>
<value value="2" id="338255"/>
<value value="5" id="362543"/>
<value value="3" id="338256"/>
<value value="4" id="339077"/>
</filter>
<filter name="Característica Eco Sustentável" id="4660">
<value value="Lembrete para desligar o carregador" id="290770"/>
<value value="Ausência de PVC na composição" id="303028"/>
<value value="Material reciclável" id="288700"/>
<value value="Carregador econômico" id="290772"/>
<value value="Embalagem de papel reciclado" id="303022"/>
<value value="Embalagem reduzida" id="290928"/>
<value value="Bateria de longa duração" id="277512"/>
<value value="Carcaça de garrafa PET" id="277511"/>
<value value="Carregador a base de luz solar" id="303025"/>
<value value="LCD sem Mercúrio" id="303057"/>
<value value="Manual em arquivo digital" id="290931"/>
<value value="Material reciclado" id="290811"/>
<value value="Neutralização de Carbono" id="277510"/>
<value value="Pintura a base de água" id="290925"/>
</filter>
<filter name="Câmera" id="1176">
<value value="2.0" id="57678"/>
<value value="5.0" id="109055"/>
<value value="0.3" id="51132"/>
<value value="3.2" id="51150"/>
<value value="Não" id="6516"/>
<value value="1.3" id="58908"/>
<value value="3.15" id="209867"/>
<value value="8" id="182297"/>
<value value="12" id="204824"/>
<value value="Sim" id="277599"/>
(...)
</filter>
<filter name="Funções Extras" id="3348">
<value value="Java" id="96407"/>
<value value="MP3 Player" id="96402"/>
<value value="Reproduz Video" id="209881"/>
<value value="Rádio" id="209878"/>
<value value="Gravador de Vídeo" id="209880"/>
<value value="Gravador de Voz" id="96404"/>
<value value="Reproduz Música" id="338211"/>
<value value="Viva Voz" id="209877"/>
<value value="Comando de Voz" id="96405"/>
<value value="Loja Online de Aplicativos" id="316149"/>
<value value="Visualizador de Documentos" id="316229"/>
<value value="Videoconferência" id="316148"/>
<value value="GPS" id="358497"/>
<value value="Lanterna" id="362547"/>
<value value="Gravador de TV" id="316799"/>
<value value="Push to talk" id="360013"/>
<value value="TV Analógica" id="167072"/>
<value value="TV Digital" id="338210"/>
<value value="Visualização 3D" id="372660"/>
<value value="Webcam" id="323139"/>
</filter>
<filter name="3G" id="3682">
<value value="Sim" id="163189"/>
<value value="Não" id="163604"/>
</filter>
<filter name="Tipo de Toque" id="3031">
<value value="Vibracall" id="95925"/>
<value value="MP3" id="50817"/>
<value value="Polifônico" id="50816"/>
<value value="Monofônico" id="50814"/>
</filter>
<filter name="Aplicativos" id="5011">
<value value="E-mail" id="95913"/>
<value value="Jogos" id="338217"/>
<value value="GPS" id="161880"/>
<value value="Media Player" id="338218"/>
<value value="PDF" id="338216"/>
<value value="Redes Sociais" id="316151"/>
<value value="Office" id="316197"/>
(...)
</filter>
<filter name="Cores da Tela" id="1155">
<value value="16 milhões" id="56372"/>
<value value="65 mil" id="50911"/>
<value value="262 mil" id="50919"/>
<value value="256 mil" id="51555"/>
<value value="16,7 milhões" id="163531"/>
<value value="4096" id="57243"/>
(...)
</filter>
<filter name="Formato" id="3027">
<value value="Barra" id="50844"/>
<value value="Slider" id="50846"/>
<value value="Flip" id="50845"/>
<value value="Giratório" id="51271"/>
</filter>
<filter name="Memória Interna" id="3278">
<value value="Menos de 1 MB" id="407"/>
<value value="1 MB - 10 MB" id="402"/>
<value value="10 MB - 20 MB" id="403"/>
<value value="20 MB - 30 MB" id="404"/>
<value value="30 MB - 50 MB" id="405"/>
<value value="50 MB ou mais" id="406"/>
</filter>
<filter name="Banda" id="3025">
<value value="Quadri-Band" id="50932"/>
<value value="Dual-Band" id="50840"/>
<value value="Tri-Band" id="50841"/>
<value value="Single-Band" id="51791"/>
</filter>
<filter name="Antena" id="1156">
<value value="Interna" id="6460"/>
<value value="Externa" id="6459"/>
</filter>
<filter name="Tipo de Teclado" id="4193">
<value value="Teclado Alfanumérico" id="209609"/>
<value value="Touch-screen" id="209621"/>
<value value="Teclado QWERTY Completo" id="209607"/>
<value value="Teclado QWERTY Reduzido" id="209608"/>
</filter>
<filter name="Display" id="4194">
<value value="2.4" id="209611"/>
<value value="1.8" id="211256"/>
<value value="3.2" id="209619"/>
<value value="2.2" id="209613"/>
<value value="2.0" id="210068"/>
<value value="2.36" id="211567"/>
<value value="3.5" id="209616"/>
<value value="2.6" id="209615"/>
<value value="2.8" id="209612"/>
<value value="2.1" id="210112"/>
<value value="2" id="323567"/>
<value value="2.9" id="219237"/>
<value value="4.0" id="213917"/>
(...)
</filter>
<filter name="Sistema Operacional" id="4192">
<value value="Symbian OS" id="209598"/>
<value value="Symbian S60" id="218676"/>
<value value="Symbian Anna" id="354552"/>
<value value="Maemo 5" id="228116"/>
<value value="MeeGo OS" id="368395"/>
<value value="Symbian 3 OS" id="279755"/>
<value value="Symbian 9.4" id="358503"/>
<value value="Android 1.6" id="345167"/>
<value value="Android 2.1" id="323608"/>
<value value="Android 2.2" id="338212"/>
<value value="Android 2.3" id="348488"/>
<value value="Android OS" id="212184"/>
(...)
</filter>
<filter name="Tipos de Conexão" id="3033">
<value value="Bluetooth" id="50969"/>
<value value="GPRS" id="50824"/>
<value value="WAP" id="6533"/>
<value value="EDGE" id="50825"/>
<value value="Fone de Ouvido" id="50836"/>
<value value="USB" id="50834"/>
<value value="Wi-Fi" id="128869"/>
<value value="Micro-USB" id="210042"/>
<value value="Infravermelho" id="6528"/>
<value value="CSD" id="50822"/>
<value value="Mini-USB" id="209883"/>
<value value="HDMI" id="338214"/>
<value value="Serial" id="50985"/>
</filter>
</filters>
</category>
Percebam que cada retorno tem filtros diferentes, de acordo com o código da categoria utilizado.
Como utilizar os filtros?
Para utilizar os filtros, vamos apenas adicionar mais um parâmetro na url para identificar qual característica do filtro escolhido queremos obter. Esse parâmetro é uma junção do termo specId com o id do filtro escolhido. Como exemplo, vamos pegar a seguinte tag com os filtros disponíveis na consulta pela categoria 9825, referente a carros:
<filters>
<filter name="Marca" id="3381">
<value value="Volkswagen" id="111427"/>
<value value="Fiat" id="111419"/>
<value value="Chevrolet" id="111417"/>
<value value="Ford" id="111420"/>
<value value="Renault" id="112339"/>
<value value="Peugeot" id="111424"/>
<value value="Mercedes-Benz" id="165788"/>
<value value="BMW" id="111416"/>
<value value="Audi" id="112231"/>
<value value="Citroën" id="111418"/>
<value value="Mitsubishi" id="111422"/>
<value value="Toyota" id="111426"/>
<value value="Honda" id="111421"/>
<value value="Kia" id="158119"/>
<value value="Nissan" id="111423"/>
<value value="Volvo" id="112364"/>
<value value="Land Rover" id="113909"/>
<value value="Porsche" id="112328"/>
<value value="Hyundai" id="112876"/>
<value value="Subaru" id="112049"/>
(...)
</filter>
<filter name="Ano de Fabricação" id="3386">
<value value="2010" id="274606"/>
<value value="2009" id="190902"/>
<value value="2007" id="111395"/>
<value value="2008" id="164089"/>
<value value="2006" id="111394"/>
<value value="2004" id="111392"/>
<value value="2005" id="111393"/>
<value value="2001" id="111917"/>
<value value="2002" id="111912"/>
<value value="2003" id="111800"/>
<value value="2000" id="111783"/>
(...)
</filter>
<filter name="Ano do Modelo" id="3387">
<value value="2010" id="216419"/>
<value value="2008" id="117315"/>
<value value="2011" id="302317"/>
<value value="2007" id="111398"/>
<value value="2009" id="164092"/>
<value value="2005" id="111396"/>
<value value="2001" id="111840"/>
<value value="2006" id="111397"/>
<value value="2003" id="111805"/>
<value value="2004" id="111869"/>
<value value="2002" id="111820"/>
<value value="2000" id="111782"/>
(...)
</filter>
<filter name="Categoria" id="3407">
<value value="Hatch" id="111400"/>
<value value="Sedan" id="111401"/>
<value value="Utilitário Esportivo" id="111909"/>
<value value="Wagon" id="111883"/>
<value value="Pickup" id="111410"/>
<value value="Mini Van" id="112298"/>
<value value="Coupé" id="157820"/>
<value value="Furgão" id="112321"/>
<value value="Conversível" id="164095"/>
<value value="Van" id="111415"/>
<value value="Chassi" id="164419"/>
<value value="Jipe" id="111412"/>
<value value="CC" id="232281"/>
</filter>
<filter name="Modelo" id="3382">
<value value="Gol" id="111465"/>
<value value="Corsa" id="111454"/>
<value value="Palio" id="111477"/>
<value value="Clio" id="111451"/>
<value value="Golf" id="111466"/>
<value value="Parati" id="111478"/>
<value value="Focus" id="111461"/>
<value value="Astra" id="111441"/>
<value value="Fiesta" id="111458"/>
<value value="Uno" id="111484"/>
<value value="Siena" id="111481"/>
<value value="206" id="111428"/>
<value value="Vectra" id="111485"/>
<value value="Polo" id="111479"/>
<value value="Série 3" id="158429"/>
<value value="Fox" id="111462"/>
<value value="Classe C" id="157952"/>
<value value="Corolla" id="111452"/>
<value value="Celta" id="111447"/>
<value value="Palio Weekend" id="111882"/>
<value value="Scénic" id="112649"/>
<value value="Civic" id="111448"/>
<value value="A3" id="111436"/>
<value value="Mégane" id="111473"/>
<value value="Strada" id="111483"/>
<value value="Ranger" id="112629"/>
<value value="Ecosport" id="111456"/>
(...)
</filter>
<filter name="Nº de Portas" id="3384">
<value value="4" id="111494"/>
<value value="2" id="111492"/>
</filter>
<filter name="Tipo" id="3380">
<value value="Usado" id="111138"/>
<value value="0 Km" id="111137"/>
</filter>
<filter name="Versão" id="3383">
<value value="4x4" id="192479"/>
<value value="GLX" id="111810"/>
<value value="ELX" id="111891"/>
<value value="GL" id="111512"/>
<value value="EX" id="111506"/>
<value value="Expression" id="111509"/>
<value value="GLS" id="112277"/>
<value value="Plus" id="111516"/>
<value value="Exclusive" id="117647"/>
<value value="L" id="180590"/>
<value value="LX" id="111818"/>
<value value="City" id="111502"/>
<value value="Comfortline" id="114433"/>
<value value="Privilege" id="113346"/>
<value value="HLX" id="111513"/>
<value value="Authentique" id="111500"/>
<value value="CD" id="169216"/>
<value value="Elegance" id="111504"/>
<value value="Ghia" id="113119"/>
<value value="GLS 4x4" id="167539"/>
(...)
</filter>
<filter name="Cilindrada" id="3390">
<value value="2.0" id="111537"/>
<value value="1.6" id="111535"/>
<value value="1.0" id="111532"/>
<value value="1.8" id="111536"/>
<value value="1.4" id="111533"/>
<value value="2.5" id="111539"/>
<value value="3.0" id="111540"/>
<value value="2.8" id="112235"/>
<value value="2.4" id="112447"/>
<value value="3.2" id="113235"/>
<value value="2.2" id="112467"/>
<value value="2.3" id="111538"/>
<value value="3.5" id="111541"/>
<value value="2.7" id="113550"/>
<value value="1.3" id="111892"/>
<value value="1.5" id="111534"/>
<value value="3.8" id="112584"/>
<value value="4.4" id="112226"/>
<value value="3.6" id="112719"/>
(...)
</filter>
<filter name="Nº de Válvulas" id="3391">
<value value="8" id="111571"/>
<value value="16" id="111568"/>
<value value="24" id="111570"/>
<value value="20" id="112367"/>
<value value="32" id="112228"/>
<value value="12" id="112636"/>
<value value="30" id="113539"/>
<value value="18" id="157840"/>
<value value="40" id="158568"/>
<value value="36" id="157975"/>
<value value="10" id="158487"/>
<value value="48" id="158033"/>
<value value="6" id="158939"/>
<value value="0" id="157989"/>
<value value="25" id="160246"/>
</filter>
<filter name="Combustível" id="3389">
<value value="Gasolina" id="109205"/>
<value value="Flex" id="167776"/>
<value value="Diesel" id="109208"/>
<value value="Álcool" id="109206"/>
<value value="Gás Natural" id="109207"/>
<value value="Elétrico" id="316486"/>
</filter>
<filter name="Câmbio" id="3395">
<value value="Mecânico" id="165325"/>
<value value="Automático" id="109190"/>
<value value="Automático Sequencial" id="109195"/>
</filter>
</filters>
Agora, digamos que queremos filtrar por todos os carros da marca Fiat. Vamos combinar o termo specId com o ID do filtro Marca, que é 3381 e logo após informar o ID de Fiat que é 111419. Então nosso parâmetro ficará specId3381=111419. Com esse parâmetro adicional na url, estamos dizendo à API do BuscaPé que desejamos recuperar todos os carros da Marca Fiat. Lembramos que essa combinação só poderá ser utilizada na categoria de carros, já que se você mudar o id da categoria, também mudarão os filtros e, consequentemente, as combinações que deverão ser feitas.
Vejam como ficou nossa url com o filtro pela marca Fiat e o seu retorno:
http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=9825&specId3381=111419
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" match="all" page="1" totalPages="102" totalResultsReturned="16" totalResultsAvailable="1621" 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-07-12T10:35:50.811-03:00</date>
<elapsedTime>85</elapsedTime>
<status>success</status>
<code>0</code>
<message>success</message>
</details>
<category hasOffer="false" isFinal="true" parentCategoryId="3841" id="9825">
<thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9825.jpg"/>
<links>
<link type="category" url="http://compare.buscape.com.br/carros.html?mdapp=100&mddtn=69672797"/>
<link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=9825"/>
</links>
<name>Carros</name>
(…)
</category>
<product id="158352" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="4" fullDescription="false">
<productName>Fiat Idea ELX Mini Van Flex 1.4 8 V Mecânico 4 Portas 2008 / 2009 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>30700.00</priceMin>
<priceMax>40900.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-idea-elx-mini-van-flex-1-4-8-v-mecanico-4-portas-2008-2009-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=158352"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=158352"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_158352_1.jpg"/>
<rating>
<userAverageRating>
<numComments>8</numComments>
<rating>8.2</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=158352"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=158352"/>
</links>
</specification>
</product>
<product id="157881" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="4" fullDescription="false">
<productName>Fiat Punto ELX Hatch Flex 1.4 8 V Mecânico 4 Portas 2008 / 2008 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>28000.00</priceMin>
<priceMax>43000.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-punto-elx-hatch-flex-1-4-8-v-mecanico-4-portas-2008-2008-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=157881"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=157881"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_157881_1.jpg"/>
<rating>
<userAverageRating>
<numComments>3</numComments>
<rating>8.2</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=157881"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=157881"/>
</links>
</specification>
</product>
<product id="151279" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="4" fullDescription="false">
<productName>Fiat Idea ELX Mini Van Flex 1.4 8 V Mecânico 4 Portas 2006 / 2006 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>25500.00</priceMin>
<priceMax>42900.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-idea-elx-mini-van-flex-1-4-8-v-mecanico-4-portas-2006-2006-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=151279"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=151279"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_151279_1.jpg"/>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=151279"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=151279"/>
</links>
</specification>
</product>
</Result>
Combinando filtros
Estaria você leitor se perguntando: “Eu poderia trazer todos os carros da marca Fiat com apenas duas portas então?”. Evidente que sim. De forma tão simples e intuitiva como é toda a API do BuscaPé. Para realizar essa filtragem, localize o ID do Filtro Nº de Portas (3384) e a seguir a sua característica com o valor 2 (111492), que indica carros de duas portas. Façam a mesma combinação com o parâmetro specId que fizemos acima e adicionem o resultado ao final da url, sem retirar o parâmetro de filtragem anterior.
Abaixo, vejam como ficou nossa url e seu retorno:
http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=9825&specId3381=111419&specId3384=111492
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" match="all" page="1" totalPages="26" totalResultsReturned="16" totalResultsAvailable="407" 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-07-12T10:37:46.799-03:00</date>
<elapsedTime>67</elapsedTime>
<status>success</status>
<code>0</code>
<message>success</message>
</details>
<category hasOffer="false" isFinal="true" parentCategoryId="3841" id="9825">
<thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9825.jpg"/>
<links>
<link type="category" url="http://compare.buscape.com.br/carros.html?mdapp=100&mddtn=69672797"/>
<link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=9825"/>
</links>
<name>Carros</name>
(...)
</category>
<product id="203621" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="3" fullDescription="false">
<productName>Fiat Palio Fire Economy Hatch Flex 1.0 8 V Mecânico 2 Portas 2009 / 2010 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>19200.00</priceMin>
<priceMax>28900.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-palio-fire-economy-hatch-flex-1-0-8-v-mecanico-2-portas-2009-2010-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=203621"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=203621"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_203621_1.jpg"/>
<rating>
<userAverageRating>
<numComments>7</numComments>
<rating>8.2</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=203621"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=203621"/>
</links>
</specification>
</product>
<product id="157944" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="3" fullDescription="false">
<productName>Fiat Fiorino Furgão Flex 1.3 8 V Mecânico 2 Portas 2007 / 2008 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>21490.00</priceMin>
<priceMax>31000.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-fiorino-furgao-flex-1-3-8-v-mecanico-2-portas-2007-2008-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=157944"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=157944"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_157944_1.jpg"/>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=157944"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=157944"/>
</links>
</specification>
</product>
<product id="157378" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="3" fullDescription="false">
<productName>Fiat Fiorino Furgão Flex 1.3 8 V Mecânico 2 Portas 2008 / 2008 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>22990.00</priceMin>
<priceMax>30900.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-fiorino-furgao-flex-1-3-8-v-mecanico-2-portas-2008-2008-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=157378"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=157378"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_157378_1.jpg"/>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=157378"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=157378"/>
</links>
</specification>
</product>
<product id="148934" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="3" fullDescription="false">
<productName>Fiat Palio ED Hatch Gasolina 1.0 8 V Mecânico 2 Portas 1998 / 1998 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>8500.00</priceMin>
<priceMax>12900.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-palio-ed-hatch-gasolina-1-0-8-v-mecanico-2-portas-1998-1998-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=148934"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=148934"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_148934_1.jpg"/>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=148934"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=148934"/>
</links>
</specification>
</product>
<product id="146241" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="3" fullDescription="false">
<productName>Fiat Palio EX Hatch Gasolina 1.0 8 V Mecânico 2 Portas 1998 / 1999 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>9500.00</priceMin>
<priceMax>14200.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-palio-ex-hatch-gasolina-1-0-8-v-mecanico-2-portas-1998-1999-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=146241"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=146241"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_146241_1.jpg"/>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=146241"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=146241"/>
</links>
</specification>
</product>
<product id="156719" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="3" fullDescription="false">
<productName>Fiat Palio Hatch Flex 1.0 8 V Mecânico 2 Portas 2007 / 2008 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>16900.00</priceMin>
<priceMax>26200.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-palio-hatch-flex-1-0-8-v-mecanico-2-portas-2007-2008-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=156719"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=156719"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_156719_1.jpg"/>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=156719"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=156719"/>
</links>
</specification>
</product>
<product id="157586" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="3" fullDescription="false">
<productName>Fiat Palio Hatch Flex 1.0 8 V Mecânico 2 Portas 2008 / 2008 - Usado</productName>
<currency abbreviation="BRL"/>
<priceMin>17990.00</priceMin>
<priceMax>25890.00</priceMax>
<links>
<link type="product" url="http://compare.buscape.com.br/fiat-palio-hatch-flex-1-0-8-v-mecanico-2-portas-2008-2008-usado.html?mdapp=100&mddtn=69672797"/>
<link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=157586"/>
<link type="xml" url="http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/br/?productId=157586"/>
</links>
<thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/9825/200x200_157586_1.jpg"/>
<rating>
<userAverageRating>
<numComments>0</numComments>
<rating>0.0</rating>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/564771466d477a4458664d3d/br/?productId=157586"/>
</links>
</userAverageRating>
</rating>
<specification>
<links>
<link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/564771466d477a4458664d3d/br/?productId=157586"/>
</links>
</specification>
</product>
</Result>
Muitas outras possibilidades para os desenvolvedores se abrem aqui, com a utilização dos filtros no serviço findProductList da API do BuscaPé. Continuem acompanhando nossos tutoriais. Em breve, falaremos mais sobre a utilização dos filtros.
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
