Lista de productos
Buscar productos por una o varias palabras o ID de la categoría.
¿Cómo funciona?
- Aplicación envía una solicitud informando el identificador de la última categoría, palabras clave o ambos.
- El servicio recibe la petición y busca en la lista de productos en el Buscape.
- El servicio devuelve una lista de productos en formato XML para su aplicación.
Formatos de URL
Busca por ID de la categoría.
http://sandbox.buscape.com/service/findProductList/<application_id>/?categoryId=categoryId
Busca por palabra clave.
http://sandbox.buscape.com/service/findProductList/<application_id>/?keyword=keyword
Busca por ID de la categoría y palabra clave.
http://sandbox.buscape.com/service/findProductList/<application_id>/?categoryId=categoryId&keyword=keyword
Parámetros
| Parámetros | Tipo | Descripción |
|---|---|---|
| categoryId | Int | Categoría ID |
| keyword | String | Palabras claves |
Filtros
| Parámetros | Tipo | Descripción |
|---|---|---|
| results | Int | Número de resultados |
| page | Int | Número de página |
| priceMin | Float | Precio mínimo |
| priceMax | Float | Precio máximo |
| sort | String | Coordinación
|
| medal | String | Filtros de ofertas y productos de una medalla de algunos en el eBit
|
Formatos de respuesta
El formato de respuesta es XML.
Si desea utilizar el formato de respuesta JSON, agregue el format=json
Solicitud de Muestras
http://sandbox.buscape.com/service/findProductList/<application_id>/?categoryId=77
http://sandbox.buscape.com/service/findProductList/<application_id>/?keyword=celular
http://sandbox.buscape.com/service/findProductList/<application_id>/?categoryId=77&keyword=motorola
Documento XSD (esquema XML)
Campos de respuesta
Result
| Campos | Tipo | Descripción |
|---|---|---|
| details | ResultDetails | Solicitud de información |
| category | CategoryType | Datos de la categoría actual |
| totalResultsAvailable | Int | Total de artículos disponibles |
| totalResultsReturned | Int | Total de devolución |
| totalPages | Int | Total de páginas |
| page | Int | El número de página actual |
| match | String | Devuelve el tipo de búsqueda de palabras clave
|
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óno |
|---|---|---|
| id | Int | Categoría ID |
| parentCategoryId | Int | ID de la categoría padre |
| isFinal | Boolean | TRUE si se trata de una categoría final |
| name | String | Nombre de la categoria |
| links | LinksType |
Links lista
|
| thumbnail | ThumbnailType | Categoría de la imagen |
ProductType
| Campos | Tipo | Descripción |
|---|---|---|
| id | Int | Identificación de producto |
| categoryId | Int | Categoría ID |
| totalSellers | Int | Total de empresas con ofertas para este producto |
| productName | String | Nombre del producto |
| priceMin | String | Precio mínimo |
| priceMax | String | Precio máximo |
| links | LinkType |
Links de los productos
|
| thumbnail | ThumbnailType | Imagen del producto |
| rating | RatingType | Evaluación del producto |
| specification | SpecificationType | Detalles del producto |
LinksType
| Campos | Tipo | Descripción |
|---|---|---|
| link | LinkType | Link |
LinkType
| Campos | Tipo | Descripción |
|---|---|---|
| type | String | Tipo de Link: |
| url | String | Dirección del Link |
ThumbnailType
| Campos | Tipo | Descripción |
|---|---|---|
| url | String | dirección de la imagen |
RatingType
| Campos | Tipo | Descripción |
|---|---|---|
| userAverageRating | UserRatingType | Evaluación de los usuarios |
UserRatingType
| Campos | Tipo | Descripción |
|---|---|---|
| numComments | Int | Número de comentarios |
| rating | String | Promedio de calificaciones de los usuarios |
| link | LinkType |
evaluation del Link
|
| specification | SpecificationType | Evaluation of product items |
SpecificationType
| Campos | Tipo | Descripción |
|---|---|---|
| item | ItemListType | Lista de artículos especificación |
| links | LinkType | Links |
| label | String | Lista de artículos especificación |
ItemListType
| Campos | Tipo | Descripción |
|---|---|---|
| label | String | Nombre del artículo |
| value | String | Relación del artículo |
Ejemplo de respuesta
Lista de la búsqueda para productos de categoría 77 (móvil).
http://sandbox.buscape.com/service/findProductList/<application_id>/?categoryId=77
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
564771466d477a4458664d3d
1.0.0.0
http://bws-apps.buscape.com/mobile/update
2010-10-19T10:16:50.529
12
success
0
success
Celular e Smartphone
LG GT350 Cookie Messenger GSM Desbloqueado
LG GT350 Cookie Messenger Desbloqueado
399.00
399.00
36
8.4
-
3.15 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
GPRS
Micro-USB
WAP
LG GS290 Cookie Plus GSM Desbloqueado
LG GS290 Cookie Plus Desbloqueado
299.99
722.58
14
9.0
-
2.0 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
LG GX200 GSM Desbloqueado
LG GX200 Desbloqueado
289.00
429.00
74
7.2
-
1.3 MP
-
Dual Chip
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
Fone de Ouvido
GPRS
USB
WAP
Samsung Corby S3650 GSM Desbloqueado
Samsung Corby S3650 Desbloqueado
349.00
818.98
49
8.8
-
2.0 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
Samsung B7320 GSM Desbloqueado
Samsung B7320 Desbloqueado
649.00
939.00
8
6.0
-
3.15 MP
-
Comando de Voz
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Videoconferência
Visualizador de Documentos
Viva Voz
-
Sim
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
Wi-Fi
Nokia X3 GSM Desbloqueado
Nokia X3 Desbloqueado
379.00
661.50
20
9.0
-
3.2 MP
-
Comando de Voz
Grava Video
Gravador de Voz
Java
Media Player
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
Micro-USB
WAP
Samsung S5620 Star 3G GSM Desbloqueado
Samsung S5620 Star 3G Desbloqueado
499.99
818.98
19
8.8
-
3.2 MP
-
Grava Video
Gravador de Voz
Java
Media Player
MP3 Player
Rádio
Reproduz Video
Visualizador de Documentos
Viva Voz
-
Sim
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
Wi-Fi
LG GM600 GSM Desbloqueado
LG GM600 Desbloqueado
439.00
738.24
49
8.2
-
3.2 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
TV
Viva Voz
-
Sim
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
Nokia E63 GSM Desbloqueado
Nokia E63 Desbloqueado
497.00
1399.00
24
8.6
-
2.0 MP
-
Comando de Voz
Grava Video
Gravador de Voz
Java
Loja Online de Aplicativos
Media Player
MP3 Player
Rádio
Reproduz Video
Visualizador de Documentos
Viva Voz
-
Sim
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
Micro-USB
WAP
Wi-Fi
Motorola i776 Iden Nextel
Motorola i776 Nextel
290.00
499.00
17
7.6
-
0.3 MP
-
Comando de Voz
Java
Samsung B5722 GSM Desbloqueado
Samsung B5722 Desbloqueado
605.00
799.00
11
9.4
-
3.15 MP
-
Dual Chip
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
GPRS
USB
WAP
LG Cookie KP570 GSM Desbloqueado
LG Cookie KP570 Desbloqueado
310.00
699.00
419
9.0
-
3.0 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Visualizador de Documentos
Viva Voz
-
Não
-
MicroSD
-
Bluetooth
Fone de Ouvido
USB
WAP
LG Messenger GT360 GSM Desbloqueado
LG Messenger GT360 Desbloqueado
349.00
599.00
91
9.2
-
2.0 MP
-
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
Não
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
USB
WAP
LG GX500 GSM Desbloqueado
LG GX500 Desbloqueado
623.00
829.00
14
8.4
-
3.2 MP
-
Dual Chip
Grava Video
Gravador de Voz
Java
MP3 Player
Rádio
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
Fone de Ouvido
GPRS
Micro-USB
WAP
Wi-Fi
Samsung C3300 GSM Desbloqueado
Samsung C3300 Desbloqueado
299.00
379.00
4
9.0
-
1.3 MP
-
Grava Video
Java
Media Player
MP3 Player
Reproduz Video
Viva Voz
-
MicroSD
-
Bluetooth
EDGE
GPRS
WAP
Samsung B7300 Omnia Lite GSM Desbloqueado
Samsung B7300 Omnia Lite Desbloqueado
799.99
1459.90
3
10.0
-
3.15 MP
-
Grava Video
Gravador de Voz
Java
Media Player
MP3 Player
Rádio
Reproduz Video
Videoconferência
Visualizador de Documentos
Viva Voz
-
Sim
-
MicroSD
-
Bluetooth
EDGE
GPRS
Micro-USB
Wi-Fi
Errores
Como se observa en ResultDetails, la respuesta puede devolver códigos de error.
Información importante
CategoryId parámetro debe ser siempre la identificación de las categorías finales.
Algunas categorías no son productos finales, son solamente ofertas. En este caso la respuesta XML tendrá su lista de productos vacía. Para no perder el vínculo de la consulta, el servicio proporcionará la dirección URL de la oferta lista para la consulta, informando la identificación de la misma categoría.
Aviso a los desarrolladores
Si la aplicación se ejecuta en un servidor, usted debe informar a los servicios web Buscapé IP del usuario para acceder a su servidor. El IP del usuario debe ser informado por el clientIp parámetro. Si la aplicación se ejecuta directamente en la máquina del usuario final, tales 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/findProductList/<application_id>/?categoryId=categoryId&keyword=keyword&clientIp=200.200.200.200
