Home > Home > Documentation > Technical details of a product

Technical details of a product

This service returns the technical details of a particular product.

How it works?

Funcionamento dos detalhes técnicos do produto

On this page:
  1. Application sends a request stating the product ID.
  2. Service receives the request and search the product details on Buscapé.
  3. Service returns the product details on the XML format for application.

URL formats accepted

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

Response formats

The standard response format is XML.

If you want to use the JSON response format, add the format = json.

Sample Request

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

Document XSD (XML Schema)

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

Parameters

Parameters type Description
productId Int Product ID

Response fields

Result

Fields Type Description
details ResultDetails Request details
category CategoryType Data from the current category
totalResultsAvailable Int Total items available
totalResultsReturned Int Total Items Returned
totalPages Int Total pages
page Int Current Page Number
match String Returns the type of search keyword (s)
  • allResearch perfect, all keyword (s) found
  • any: Research part-some keyword (s) found
  • none: Search Not Found

ResultDetails

Fields Type Description
applicationID String Aplication ID
date String Date / Time of request
elapsedTime Long Execution time of the request in milliseconds
status String Status Response
code Int Response code
message String Reply message

CategoryType

Fields Type Description
id Int Category ID
parentCategoryId Int Parent Category ID
isFinal Boolean TRUE IF it’s a final category
name String Category name
links LinksType Links list
  • category: URL category in Buscapé
  • XML: URL of the search service offering or product category by ID
thumbnail ThumbnailType Category image

ProductType

Fields Type Description
id Int Product ID
categoryId Int Category ID
totalSellers Int Total companies with offers for this product
productName String Product name
priceMin String Minimum price
priceMax String Maximum price
links LinkType Product Links
  • XML: URL of the search service offerings by product ID
  • product: URL of the product in Buscapé
  • specification: URL specification of the product in Buscapé
thumbnail ThumbnailType Product Image
rating RatingType Product Evaluation
specification SpecificationType Product details

LinksType

Fields Type Description
link LinkType Link

LinkType

Fields Type Description
type String Type of link:
url String Link adress

ThumbnailType

Fields Type Description
url String Image adress

RatingType

Fields Type Description
userAverageRating UserRatingType User rating

UserRatingType

Fields Type Description
numComments Int Comments Number
rating String Average grade of the users
link LinkType Link evaluation
  • XML: URL of the service user by evaluating the product ID
specification SpecificationType Evaluation of product items

ProductDetailsType

Fields Type Description
specification SpecificationType List of technical specifications of the product

SpecificationType

Fields Type Description
item ItemListType List of specification items
links LinkType Links
label String Description Specification

ItemListType

Fields Type Description
label String Item name
value String Item value

Example Response

Search product details 122312.

http://sandbox.buscape.com/service/viewProductDetails/<application_id>/?productId=122312
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Result xmlns="urn:buscape" totalResultsReturned="0" totalResultsAvailable="0">
        <details>
            <applicationID><APPLICATION_ID></applicationID>
            <date>2008-08-17T18:11:42.018</date>
            <elapsedTime>131</elapsedTime>
            <status>success</status>
            <code>0</code>
            <message>success</message>
        </details>
        <category isFinal="true" parentCategoryId="2" id="36">
            <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/36.jpg"/>
            <links>
                <link type="category" url="http://compare.buscape.com.br/monitor.html"/>
                <link type="xml" url="http://sandbox.buscape.com/service/findProductList/<APPLICATION_ID>/?categoryId=36"/>
            </links>
            <name>Monitor</name>
        </category>
        <product id="122312" categoryId="36" totalSellers="19" fullDescription="true">
            <productName>Samsung SyncMaster 632NW LCD 15,6 Polegadas</productName>
            <priceMin>329.80</priceMin>
            <priceMax>1049.00</priceMax>
            <links>
                <link type="product" url="http://compare.buscape.com.br/samsung-syncmaster-632nw-lcd-15-6-polegadas.html"/>
                <link type="specification" url="http://compare.buscape.com.br/prod_ficha?idu=122312"/>
                <link type="xml" url="http://sandbox.buscape.com/service/findOfferList/<APPLICATION_ID>/?productId=122312"/>
            </links>
            <thumbnail url="http://imagem.buscape.com.br/thumbs/ensopado/36/190x190_122312_1.jpg"/>
            <rating>
                <userAverageRating>
                    <numComments>1</numComments>
                    <rating>9.6</rating>
                    <links>
                        <link type="xml" url="http://sandbox.buscape.com/service/viewUserRatings/<APPLICATION_ID>/?productId=122312"/>
                    </links>
                    <specification>
                        <item label="Design">
                            <value>10.0</value>
                        </item>
                        <item label="Custo-Benefício">
                            <value>8.0</value>
                        </item>
                        <item label="Qualidade da Imagem">
                            <value>10.0</value>
                        </item>
                        <item label="Funções e Características">
                            <value>10.0</value>
                        </item>
                        <item label="Durabilidade">
                            <value>10.0</value>
                        </item>
                    </specification>
                </userAverageRating>
            </rating>
            <specification>
                <links>
                    <link type="xml" url="http://sandbox.buscape.com/service/viewProductDetails/<APPLICATION_ID>/?productId=122312"/>
                </links>
                <item label="Tamanho da Tela">
                    <value>15,6 Polegadas</value>
                </item>
                <item label="Tipo de Tela">
                    <value>LCD</value>
                </item>
                <item label="Tela Plana">
                    <value>Sim</value>
                </item>
                <item label="Widescreen">
                    <value>Sim</value>
                </item>
                <item label="Resolução Máxima">
                    <value>1366 x 768 Pixel</value>
                </item>
            </specification>
            <productDetails>
                <specification label="Informações Básicas">
                    <item label="Marca">
                        <value>Samsung</value>
                    </item>
                    <item label="Linha">
                        <value>SyncMaster</value>
                    </item>
                    <item label="Modelo">
                        <value>632NW</value>
                    </item>
                </specification>
                <specification label="Especificações Técnicas">
                    <item label="Largura">
                        <value>382 mm</value>
                    </item>
                    <item label="Altura">
                        <value>308 mm</value>
                    </item>
                    <item label="Profundidade">
                        <value>159 mm</value>
                    </item>
                    <item label="Peso">
                        <value>3,5 Kg</value>
                    </item>
                </specification>
                <specification label="Conexões">
                    <item label="Compatibilidade Plug & Play">
                        <value>Sim</value>
                    </item>
                </specification>
                <specification label="Características do Display">
                    <item label="Tamanho da Tela">
                        <value>15,6 Polegadas</value>
                    </item>
                    <item label="Tipo de Tela">
                        <value>LCD</value>
                    </item>
                    <item label="Tela Plana">
                        <value>Sim</value>
                    </item>
                    <item label="Ângulo de Visão Horizontal">
                        <value>90 Graus</value>
                    </item>
                    <item label="Ângulo de Visão Vertical">
                        <value>65 Graus</value>
                    </item>
                    <item label="Widescreen">
                        <value>Sim</value>
                    </item>
                    <item label="Resolução Máxima">
                        <value>1366 x 768 Pixel</value>
                    </item>
                    <item label="Taxa de Atualização na Resolução Máxima">
                        <value>60 Hz</value>
                    </item>
                    <item label="Número de Cores">
                        <value>16,7 milhões</value>
                    </item>
                    <item label="Brilho">
                        <value>250 cd/m²</value>
                    </item>
                    <item label="Contraste">
                        <value>2000:1</value>
                    </item>
                    <item label="Tempo de Resposta">
                        <value>8 ms</value>
                    </item>
                </specification>
            </productDetails>
        </product>
    </Result>

Errors

As seen in ResultDetails, the response may return error codes.

Notice to developers

If your application runs on a server, you must inform the webservices Buscapé IP user accessing your server. The IP of the user should be informed by the parameter clientIp. If your application runs directly on the end user's machine, such as mobile applications or javascript is not necessary to inform the user's IP. If, for example, the IP of the user who accessed your server is 200.200.200.200, the call should be made thus:

http://sandbox.buscape.com/service/viewProductDetails/<application_id>/?productId=<productId>&clientIp=200.200.200.200
Top