Home > Home > Documentación > Lista de ofertas

Lista de ofertas

Busca todas las ofertas de un producto en particular, filtrando por la evaluación de la tienda, el precio o popularidad.

¿Cómo funciona?

Funcionamento da lista de ofertas

En esta página:
  1. Aplicación envía una solicitud informando el final de la categoría de identidad o de identificación del producto, así como una o varias palabras o palabras clave ID de la categoría más palabra clave.
  2. Servicio recibe la petición y busca en la lista de ofertas en el Buscape.
  3. Servicio devuelve una lista de ofertas de hoteles en el formato XML para su aplicación.

Servicio de URLs

Busca por ID de la categoría.

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

Busca por ID de producto.

http://sandbox.buscape.com/service/findOfferList/<application_id>/?productId=<productId>

Busca por código de barras.

http://sandbox.buscape.com/service/findOfferList/<application_id>/?barcode=<barcode>

Busca por palabra clave.

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

Busca por ID de la categoría y la palabra clave.

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

Parámetros

Parámetros Tipo Descripción
categoryId Int Categoría ID
productId Int Identificación de producto
barcode String Código de barras del producto
keyword String Palabras clave

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

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
  • price/dprice: Coordinación por precio
  • rate/drate: Coordinación de evaluación de los usuarios
  • seller/dseller: Coordinación por tienda
  • installment/dinstallment: Clasificación por parcelas de precios
  • numberofinstallments/dnumberofinstallments: Ordenados por número de parcelas
  • trustedStore: Ordenado por la compañía discográfica reconocida en Buscapé
medal String Filtros de ofertas y productos de una medalla de algunos en el eBit
  • all
  • diamond
  • gold
  • silver
  • bronze

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/findOfferList/<application_id>/?productId=100337

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 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 palabra clave de búsqueda
  • all: Investigación perfecto, todas las palabras clave que se encuentran
  • any: una parte de investigación, algunas palabras clave que se encuentran
  • none: La búsqueda no encontrado

ResultDetails

Campos Tipo Descripción
applicationID String ID de aplicación
date String Fecha y hora de la solicitud
elapsedTime Long Tiempo de ejecución de la solicitud en milisegundos
status String Condición Jurídica y Social de Respuesta
code Int Código de respuesta
message String Responder mensaje

CategoryType

Campos Tipo Descripción
id Int Categoría ID
parentCategoryId Int Categoría de ID
isFinal Boolean TRUE si se trata de una categoría final
name String Nombre de la categoría
links LinksType Lista de Link
  • category: URL de la categoría en Buscapé
  • XML: URL de la oferta de servicios de búsqueda o categoría de productos por ID
thumbnail ThumbnailType Categoría 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 del producto
  • XML: URL de la oferta del servicio de búsqueda por identificador de producto
  • product: URL del producto en Buscapé
  • specification: URL de la especificación del producto en Buscapé
thumbnail ThumbnailType Imagen del producto
rating RatingType Evaluación del producto
specification SpecificationType Detalles del producto

OfferType

Campos Tipo Descripción
id Int ID da oferta
categoryId Int ID da categoria
offerName String Nome da oferta
links LinksType Links da oferta
  • offer: URL da oferta no Buscapé
thumbnail ThumbnailType Imagem da oferta
price PriceOfferType Detalhes do preço da oferta
seller SellerType Detalhes do vendedor

PriceOfferType

Campos Tipo Descrição
value String Preço da oferta
parcel ParcelType Parcela

ParcelType

Campos Tipo Descrição
value String Preço da parcela
number Int Número de parcelas
interest Double Taxa de Juros

SellerType

Campos Tipo Descrição
id Int ID do vendedor
isTrustedStore Boolean Se true, informa que a loja tem um selo de empresa reconhecida
sellerName String Nome do vendedor
extra String Outras informações da loja
thumbnail ThumbnailType Logo do vendedor
links LinksType Links da loja
  • seller: URL da loja
contacts ContactsType Lista de contatos
rating RatingType Avaliação do vendedor

CouponType

Campos Tipo Descrição
id int ID do cupom
description String Descrição do cupom
type String Tipo do cupom
  • Brinde
  • Desconto
  • Frete Grátis
  • Venda a Prazo
link String Link do cupom

ContactsType

Campos Tipo Descrição
contact ContactType Lista de contatos

ContactType

Campos Tipo Descrição
label String Descrição do contato
value String Valor do contato

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 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 Link evaluación
  • XML: URL de hacer Serviço de avalição dos Usuario pelo ID do produto
specification SpecificationType Evaluación de los elementos del producto

EBitRatingType

Campos Tipo Descripción
numComments Int Número de comentários
rating String Nota do EBIT
  • Diamente
  • Ouro
  • Prata
  • Bronze
link LinkType Link da avaliação

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

Buscar productos con el mismo ID 100337 (Playstation).

http://sandbox.buscape.com/service/findOfferList/<application_id>/?productId=100337
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    
    

        564771466d477a4458664d3d
        1.0.0.0
        http://bws-apps.buscape.com/mobile/update
        2010-10-19T11:05:05.346
        53
        success
        0
        success
    

    
        
        
            
            
        
        Console de Videogame
    
    
        Sony PlayStation 3 80GB
        Sony PlayStation 3 80GB
        
        1049.90
        1298.00
        
            
            
            
        
        
        
            
                133
                8.4
                
                    
                
                
                    
                        9.0
                    
                    
                        9.8
                    
                    
                        6.2
                    
                    
                        6.2
                    
                    
                        9.4
                    
                    
                        9.4
                    
                    
                        9.0
                    
                
            
        
        
            
                
            
            
                Blu-Ray
                CD
                DVD
            
            
                1920 x 1080 Pixels
            
            
                4
            
            
                Sim
            
            
                Bluetooth
                USB
                Wi-Fi
            
            
                256 Mb
            
            

                1 Joystick
                Cabo AV
            
        
        
            
                
                    Sony
                
                
                    PlayStation 3 80GB
                
            
            
                
                    Não
                
                
                    1 Joystick
                    Cabo AV
                
            
            
                
                    256 Mb
                
            
            
                
                    NVidia RSX
                
                
                    550 MHz
                
                
                    1920 x 1080 Pixels
                
            
            
                
                    Blu-Ray
                    CD
                    DVD
                
            
            
                
                    64
                
                
                    Cell Broadband Engine
                
                
                    3.20 GHz
                
            
            
                
                    4
                
                
                    HDMI
                
                
                    Sim
                
                
                    Bluetooth
                    USB
                    Wi-Fi
                
            
            
                
                    325 mm
                
                
                    98 mm
                
                
                    274 mm
                
                
                    5 Kg
                
            
        
    
    
        PLAYSTATION 3 C / HD 80GB
        
            
        
        
        
            
            1071.00
            
                119.00
                10
                1.96
            
        
        
            Starhouse Mega Store
            
            
                
            
            Vende pela Internet
            
                
            
            
                
                    49
                    8.0
                
            
        
    
    
        Sony PlayStation 3 80GB blue ray
        
            
        
        
        
            
            1298.00
            
                76.44
                18
                0.62
            
        
        
            infozonasul
            
                
            
            Vende pela Internet
            
                
            
            
                
                    0
                    0.0
                
            
        
    
    
        Playstation 3 80gb Blu - ray Player Bluetooth 1 Controle - OEM
        
            
        
        
        
            
            1049.90
        
        
            Horda Digital
            
            
                
            
            Vende pela Internet
            
                
            
            
                
                    20
                    8.0
                
                
                    20
                    bronze
                
            
        
    
    
        Console PlayStation 3 HD 80GB
        
            
        
        
        
            
            1290.00
        
        
            Giga Games
            
                
            
            Vende pela Internet
            
                
            
            
                
                    2
                    9.0

Errores

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

Información importantes

CategoryId parámetro debe ser siempre la identificación de las categorías finales.

Algunas categorías no tienen ningún acuerdo final, sólo productos. En este caso la respuesta XML devolverá una lista vacía de ofertas. Para no perder el vínculo de la consulta, el servicio proporcionará la dirección de los productos listos para su consulta, informando de la identificación de la misma categoría.

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, 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/findOfferList/<application_id>/?productId=<productId>&clientIp=200.200.200.200
Arriba