Home > Home > Documentación > Lista de categorías

Lista de categorías

En esta página:

Las categorías de servicios de búsqueda permiten que la información aparezca en las categorías. Usted puede obtener categorías, productos u ofertas de informes con sólo un identificador de categoría.

Hay tres tipos de categorías:

  • Categoría de la raíz - es el primer nivel del árbol. A través de ella obtenemos las subcategorías.
  • Subcategoría - es el segundo nivel del árbol, podemos obtener otras subcategorías o categorías finales.
  • Categoría Final - es el último nivel del árbol, por estar relacionado con una lista de productos, ofertas o servicios.

Representação gráfica de uma árvore de categorias

Podemos ver en la representación arriba de las categorías finales:

  • Reloj de pulsera
  • SmartPhone
  • Móvil
  • RingTones

Las categorías finales del reloj de pulsera y RingTones no tienen productos relacionados, solo ofertas.

Categorías final SmartPhone y Móvil tienen una lista de productos. Cada elemento de la lista tiene una lista de ofertas de productos.

¿Cómo funciona?

Funcionamento da lista de categorias

  1. Aplicación hace la solicitud informando el ID de la categoría o palabras clave.
  2. Servicio recibe la petición y busca en la lista de categorías en el Buscape.
  3. Service devuelve la lista de categorías en el formato XML para su aplicación.

Formatos de URL aceptados por el servicio:

http://sandbox.buscape.com/service/findCategoryList/<application_id>/?categoryId=categoryId
http://sandbox.buscape.com/service/findCategoryList/<application_id>/?keyword=keyword

Parámetros

Parámetros Tipo Descripción
categoryId Int Categoría ID
keyword String Palabras Claves

Ver todas las categorías utilizadas para hacer peticiones a la API de Buscapé.

Ejemplo de solicitud:

Devuelve todas las raíces categorías.

http://sandbox.buscape.com/service/findCategoryList/<application_id>/?categoryId=0

Devuelve la lista de subcategorías palabra clave LG

http://sandbox.buscape.com/service/findCategoryList/<application_id>/?keyword=LG

Documento XSD (esquema XML):

http://developer.buscape.com/xsd/buscape.xsd

Campos de Respuesta

Result

Campos Tipo Descripción
details ResultDetails Solicitud de información
category CategoryType Los datos a partir de la categoría actual
totalResultsAvailable Int Total de artículos disponibles
totalResultsReturned Int Total de artículos devueltos
totalPages Int Total de páginas
page Int Página actual número
match String Devuelve el tipo de búsqueda de palabras clave
  • all: la búsqueda perfecta, todas las palabras clave que se encuentran;
  • any: búsqueda parcial, algunas palabras claves que se encuentran;
  • none: Búsqueda no se ha encontrado

ResultDetails

Campos Tipo Descripción
applicationID String ID de la aplicación
date String Fecha y hora de la solicitud
elapsedTime Long Tiempo de ejecución de la solicitud de exclusión en milisegundos
status String Estado de la respuesta
code Int Código de respuesta
message String Responder mensaje

CategoryType

Campos Tipo Descripción
ID Int ID de categoria
parentCategoryId Int ID de la categoría padre
isFinal Boolean TRUE si una última categoría
name String Nombre de la categoría
links LinksType Links lista
  • category: categoría URL en Buscapé
  • xml: URL de la oferta de servicios de búsqueda o categoría de productos por ID
thumbnail ThumbnailType Imagen Categoría

LinksType

Campos Tipo Descripción
link LinkType Link

LinkType

Campos Tipo Descripción
type String Tipo de Link:
url String dirección de Link

ThumbnailType

Campos Tipo Descripción
url String Dirección imagen

Ejemplo de respuesta

http://sandbox.buscape.com/service/findCategoryList/<application_id>/?categoryId=0
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" totalResultsReturned="48" totalResultsAvailable="48">
<details>
    <applicationID><APPLICATION_ID></applicationID>
    <date>2008-08-18T17:18:55.703</date>
    <elapsedTime>1765</elapsedTime>
    <status>success</status>
    <code>0</code>
    <message>success</message>
</details>
<category isFinal="false" parentCategoryId="0" id="0">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/0.jpg"/>
    <links>
        <link type="category" url="http://www.buscape.com.br/"/>
    </links>
    <name>Início</name>
</category>
<subCategory isFinal="false" parentCategoryId="0" id="486">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/486.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/alimentos-e-bebidas.html"/>
    </links>
    <name>Alimentos e Bebidas</name>
</subCategory>
    <subCategory isFinal="false" parentCategoryId="0" id="7425">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/7425.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/arte-e-antiguidades.html"/>
    </links>
    <name>Arte e Antiguidades</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="6016">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/6016.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/artigos-religiosos.html"/>
    </links>
    <name>Artigos Religiosos</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="6108">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/6108.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/assinaturas-e-revistas.html"/>
    </links>
    <name>Assinaturas e Revistas</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="3841">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/3841.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/automoveis-e-veiculos.html"/>
    </links>
    <name>Automóveis e Veículos</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="3473">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/3473.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/bebes-e-cia.html"/>
    </links>
    <name>Bebês e Cia</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="9634">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9634.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/blu-ray.html"/>
    </links>
    <name>Blu-Ray</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="179">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/179.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/brinquedos-e-games.html"/>
    </links>
    <name>Brinquedos e Games</name>
</subCategory>
<subCategory 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"/>
    </links>
    <name>Carros</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="2701">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2701.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/casa-e-decoracao.html"/>
    </links>
    <name>Casa e Decoração</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="2921">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2921.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/cds.html"/>
    </links>
    <name>CDs</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="8050">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/8050.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/colecionaveis.html"/>
    </links>
    <name>Colecionáveis</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="6150">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/6150.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/combustiveis.html"/>
    </links>
    <name>Combustíveis</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="5910">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/5910.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/construcao-e-ferramentas.html"/>
    </links>
    <name>Construção e Ferramentas</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="9595">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9595.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/copa-do-mundo.html"/>
    </links>
    <name>Copa do Mundo</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="249">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/249.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/cosmeticos-e-perfumaria.html"/>
    </links>
    <name>Cosméticos e Perfumaria</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="9143">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9143.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/discos-de-vinil.html"/>
    </links>
    <name>Discos de Vinil</name>
</subCategory>
<subCategory 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"/>
    </links>
    <name>DVDs</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="116">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/116.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/eletrodomesticos.html"/>
    </links>
    <name>Eletrodomésticos</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="1">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/1.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/eletronicos.html"/>
    </links>
    <name>Eletrônicos</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="1328">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/1328.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/esporte-e-lazer.html"/>
    </links>
    <name>Esporte e Lazer</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="7025">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/7025.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/fitas-k7-gravadas.html"/>
    </links>
    <name>Fitas K7 Gravadas</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="246">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/246.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/flores-cestas-e-presentes.html"/>
    </links>
    <name>Flores, Cestas e Presentes</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="9627">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9627.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/fotografia.html"/>
    </links>
    <name>Fotografia</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="9633">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9633.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/hd-dvd.html"/>
    </links>
    <name>HD-DVD</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="9549">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9549.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/imoveis.html"/>
    </links>
    <name>Imóveis</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="7426">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/7426.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/industria-comercio-e-negocios.html"/>
    </links>
    <name>Indústria, Comércio e Negócios</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="2">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/informatica.html"/>
    </links>
    <name>Informática</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="2792">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2792.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/instrumentos-musicais.html"/>
    </links>
    <name>Instrumentos Musicais</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="9617">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9617.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/joalheria.html"/>
    </links>
    <name>Joalheria</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="7172">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/7172.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/ld.html"/>
    </links>
    <name>LD</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="3482">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/3482.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/livros.html"/>
    </links>
    <name>Livros</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="7171">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/7171.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/md.html"/>
    </links>
    <name>MD</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="2468">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2468.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/moda-e-acessorios.html"/>
    </links>
    <name>Moda e Acessórios</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="7606">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/7606.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/musica-digital.html"/>
    </links>
    <name>Música Digital</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="5833">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/5833.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/natal.html"/>
    </links>
    <name>Natal</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="3484">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/3484.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/papelaria-e-escritorio.html"/>
    </links>
    <name>Papelaria e Escritório</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="5884">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/5884.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/pascoa.html"/>
    </links>
    <name>Páscoa</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="247">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/247.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/pet-shop.html"/>
    </links>
    <name>Pet Shop</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="2949">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2949.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/saude.html"/>
    </links>
    <name>Saúde</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="5845">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/5845.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/servicos.html"/>
    </links>
    <name>Serviços</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="3000">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/3000.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/sex-shop.html"/>
    </links>
    <name>Sex Shop</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="3561">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/3561.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/tabacaria.html"/>
    </links>
    <name>Tabacaria</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="6798">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/6798.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/tarifas-bancarias.html"/>
    </links>
    <name>Tarifas Bancárias</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="6420">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/6420.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/telefonia.html"/>
    </links>
    <name>Telefonia</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="6586">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/6586.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/turismo.html"/>
    </links>
    <name>Turismo</name>
</subCategory>
<subCategory isFinal="true" parentCategoryId="0" id="3154">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/3154.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/vhs.html"/>
    </links>
    <name>VHS</name>
</subCategory>
<subCategory isFinal="false" parentCategoryId="0" id="9360">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9360.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/volta-as-aulas.html"/>
    </links>
    <name>Volta às Aulas</name>
</subCategory>
<top5Category isFinal="true" parentCategoryId="0" id="2921">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2921.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/cds.html"/>
    </links>
    <name>CDs</name>
</top5Category>
<top5Category 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"/>
    </links>
    <name>DVDs</name>
</top5Category>
<top5Category 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.html"/>
    </links>
    <name>Celular</name>
</top5Category>
<top5Category isFinal="true" parentCategoryId="0" id="3482">
    <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/3482.jpg"/>
    <links>
        <link type="category" url="http://compare.buscape.com.br/livros.html"/>
    </links>
    <name>Livros</name>
</top5Category>
<top5Category 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"/>
    </links>
    <name>Notebook</name>
</top5Category> </Result>

Errores

Como se observa en ResultDetails, la respuesta puede devolver códigos de error.

Información importante

El parámetro clave siempre devuelve una lista de subcategorías

Por ejemplo, haciendo una búsqueda por palabra clave = LG, sólo tendremos la lista de subcategorías, y los primeros son más relevantes.

Aviso a los desarrolladores

Si la aplicación se ejecuta en un servidor, debe informar a los servicios web Buscapé el IP del usuario para acceder a su servidor. El IP del usuario debe ser informado por el parámetro clientIp. Si la aplicación se ejecuta directamente en la máquina del usuario final, como aplicaciones móviles o javascript, no es necesario informar el IP del usuario. Si, por ejemplo, el IP del usuario que accede a su servidor es 200.200.200.200, la llamada debe hacerse así:

http://sandbox.buscape.com/service/findCategoryList/<application_id>/?keyword=keyword&clientIp=200.200.200.200
Arriba