Know what Buscapé can do for you.
Details of a store or company
This service returns the details of a shop or business as: addresses, phone numbers and so on.
How it works?
- Application sends a request indicating the ID of the store / company.
- Service receives the request and search the details of the shop / company in Buscapé.
- Service returns the details of the shop / company in the XML format for application.
http://sandbox.buscape.com/service/viewSellerDetails/<application_id>/?sellerId=<sellerId>
Parameters
| Parameters |
Type |
Description |
| sellerId |
Int |
Store / business ID |
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/viewSellerDetails/<application_id>/?sellerId=155
Document XSD (XML Schema)
Response fields
Result
| Fields |
Type |
Description |
| details |
ResultDetails |
Request details |
| category |
CategoryType |
Data from the current category |
| totalResultsAvailable |
Int |
Total items available |
| Total de itens disponíveis |
Int |
Total Items Returned |
| totalPages |
Int |
Total pages |
| page |
Int |
Current Page Number |
| match |
match |
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 |
SellerType
| Fields |
Type |
Description |
| id |
Int |
Seller ID |
| isTrustedStore |
Boolean |
If true, reports that the store has a stamp company recognized |
| sellerName |
String |
Name of seller |
| extra |
String |
More information store |
| thumbnail |
ThumbnailType |
Soon the seller |
| links |
LinksType |
Siore links
|
| contacts |
ContactsType |
Contact List |
| rating |
RatingType |
Seller evaluation |
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 |
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 |
ContactsType
| Fields |
Type |
Description |
| contact |
ContactType |
Contact list |
ContactType
| Fields |
Type |
Description |
| label |
String |
Contact description |
| value |
String |
Contact value |
AddressesType
| Fields |
Type |
Description |
| addresses |
AddressType |
Address data |
AddressType
| Fields |
Type |
Description |
| name |
String |
Name of establishment |
| postalArea |
String |
Address |
| complement |
String |
Complement of the address |
| district |
Strings |
Neighborhood |
| city |
String |
City |
| postalCode |
String |
Zip Code |
| fone |
String |
Contact Phone |
| map |
MapType |
Coordinates of the address |
MapType
| Fields |
Type |
Description |
| Latitude |
String |
Latitude |
| Longitude |
String |
Longitude |
Example Response
Search Details saraiva.com.br, id = 155.
http://sandbox.buscape.com/service/viewSellerDetails/<application_id>/?sellerId=155
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" totalResultsReturned="1" totalResultsAvailable="1">
<details>
<applicationID><APPLICATION_ID></applicationID>
<date>2009-01-26T17:42:59.468</date>
<elapsedTime>18</elapsedTime>
<status>success</status>
<code>0</code>
<message>success</message>
</details>
<seller isTrustedStore="true" id="155">
<sellerName>Saraiva e Siciliano S.A</sellerName>
<thumbnail url="http://imagem.buscape.com.br/vitrine/logo155.gif"/>
<links>
<link type="seller" url="http://www.livrariasaraiva.com.br/?PAC_ID=6297"/>
</links>
<extra>Vende pela Internet</extra>
<contacts>
<contact label="Televendas" value="11-33352957"/>
</contacts>
<rating>
<userAverageRating>
<numComments>31631</numComments>
<rating>9.0</rating>
</userAverageRating>
<eBitRating>
<numComments>31631</numComments>
<rating>diamante</rating>
</eBitRating>
</rating>
<addresses>
<address>
<name>MEGA CAMPINAS</name>
<postalArea>IGUATEMI</postalArea>
<complement>777 SUC 2 - 2º Piso</complement>
<district>Vl Brandina</district>
<city>Campinas</city>
<state>SP</state>
<postalCode>13094691</postalCode>
<fone>19-32520223</fone>
<map>
<latitude>-22.893826962</latitude>
<longitude>-47.026324305</longitude>
</map>
</address>
<address>
<name>MEGA RIBEIRÃO PRETO</name>
<postalArea>Rua São José - até 1351/1352</postalArea>
<complement>933</complement>
<district>Centro</district>
<city>Ribeirão Preto</city>
<state>SP</state>
<postalCode>14010160</postalCode>
<fone>16-39410433</fone>
<map>
<latitude>-21.183397708</latitude>
<longitude>-47.809557083</longitude>
</map>
</address>
<address>
<name>MEGA NOVO SHOPPING RIBEIRÃO</name>
<postalArea>Avenida Presidente Kennedy - até 1900 - lado par</postalArea>
<complement>1500 Área Comercial 309</complement>
<district>Ribeirânia</district>
<city>Ribeirão Preto</city>
<state>SP</state>
<postalCode>14096350</postalCode>
<fone>16-39654340</fone>
<map>
<latitude>-21.201461147</latitude>
<longitude>-47.767514429</longitude>
</map>
</address>
<address>
<name>MEGA OUVIDOR</name>
<postalArea>Rua do Ouvidor - de 50/51 ao fim</postalArea>
<complement>98 A</complement>
<district>Centro</district>
<city>Rio de Janeiro</city>
<state>RJ</state>
<postalCode>20040030</postalCode>
<fone>21-25073785</fone>
<map>
<latitude>-22.903266667</latitude>
<longitude>-43.177523333</longitude>
</map>
</address>
<address>
<name>MEGA TIJUCA</name>
<postalArea>Avenida Maracanã - de 1531 ao fim - lado ímpar</postalArea>
<complement>987 Piso L1 - Lojas 1008/9/10/12/13</complement>
<district>Tijuca</district>
<city>Rio de Janeiro</city>
<state>RJ</state>
<postalCode>20530230</postalCode>
<fone>21-38723477</fone>
<map>
<latitude>-22.922600000</latitude>
<longitude>-43.235910000</longitude>
</map>
</address>
<address>
<name>MEGA RIO SUL</name>
<postalArea>Rua Lauro Muller - de 191 ao fim - lado ímpar</postalArea>
<complement>116 Lj. 301 - Parte C13</complement>
<district>Botafogo</district>
<city>Rio de Janeiro</city>
<state>RJ</state>
<postalCode>22290160</postalCode>
<fone>21-25437002</fone>
<map>
<latitude>-22.956360000</latitude>
<longitude>-43.175990000</longitude>
</map>
</address>
<address>
<name>MEGA NYCC</name>
<postalArea>Avenida das Américas - de 03979 a 05151 - lado ímpar</postalArea>
<complement>5000 LUC 103 - Nível Térreo</complement>
<district>Barra da Tijuca</district>
<city>Rio de Janeiro</city>
<state>RJ</state>
<postalCode>22631004</postalCode>
<fone>21-24316494</fone>
<map>
<latitude>-22.999411620</latitude>
<longitude>-43.360991676</longitude>
</map>
</address>
<address>
<name>MEGA SALVADOR</name>
<postalArea>Avenida Tancredo Neves - lado ímpar</postalArea>
<complement>2915 Loja 205 B - Piso 2</complement>
<district>Caminho das Árvores</district>
<city>Salvador</city>
<state>BA</state>
<postalCode>41820021</postalCode>
<fone>71-33417020</fone>
<map>
<latitude>-12.975421190</latitude>
<longitude>-38.457738997</longitude>
</map>
</address>
<address>
<name>MEGA RECIFE</name>
<postalArea>SHOPPING CENTER RECIFE</postalArea>
<complement>777 Loja 28B/108A</complement>
<district>Boa Viagem</district>
<city>Recife</city>
<state>PE</state>
<postalCode>51020900</postalCode>
<fone>81-34649393</fone>
<map>
<latitude>-8.119213571</latitude>
<longitude>-34.921259286</longitude>
</map>
</address>
<address>
<name>MEGA GOIÂNIA</name>
<postalArea>Avenida Jamel Cecílio - de 3569 a 4139 - lado ímpar</postalArea>
<complement>3300 Piso 3 - Loja T-359</complement>
<district>Jardim Goiás</district>
<city>Goiânia</city>
<state>GO</state>
<postalCode>74810100</postalCode>
<fone>62-35151588</fone>
<map>
<latitude>-16.709852026</latitude>
<longitude>-49.233034240</longitude>
</map>
</address>
<address>
<name>MEGA CURITIBA</name>
<postalArea>Rua Comendador Araújo - até 2129/2130</postalArea>
<complement>731 Lojas 251, 252 e 258</complement>
<district>Centro</district>
<city>Curitiba</city>
<state>PR</state>
<postalCode>80420000</postalCode>
<fone>41-32328081</fone>
<map>
<latitude>-25.437950526</latitude>
<longitude>-49.281359649</longitude>
</map>
</address>
<address>
<name>MEGA FLORIANÓPOLIS</name>
<postalArea>Avenida Madre Benvenuta - de 0522/523 a 1246/1247</postalArea>
<complement>687 Espaço Comercial 338 A</complement>
<district>Santa Mônica</district>
<city>Florianópolis</city>
<state>SC</state>
<postalCode>88035000</postalCode>
<fone>48-32343474</fone>
<map>
<latitude>-27.591477928</latitude>
<longitude>-48.515193933</longitude>
</map>
</address>
<address>
<name>MEGA PRAIA DE BELAS</name>
<postalArea>Avenida Praia de Belas - lado ímpar</postalArea>
<complement>1181 2º Piso - Loja 05</complement>
<district>Praia de Belas</district>
<city>Porto Alegre</city>
<state>RS</state>
<postalCode>90110001</postalCode>
<fone>51-32316868</fone>
<map>
<latitude>-30.048020000</latitude>
<longitude>-51.227680000</longitude>
</map>
</address>
</addresses>
</seller>
</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/viewSellerDetails/<application_id>/?sellerId=<sellerId>&clientIp=200.200.200.200
