BestBuy Search Results API
A GET request to our endpoint /api/getter/?platform="bestbuy_search"
will allow you to scrape search results from BestBuy.com's search engine in real-time.
Example
To scrape BestBuy's search results for the keyword "ssd 1tb", you can use the following command:
1 |
|
Note
When using curl
, it is necessary to add the option -L to get the data back. This is because in some cases our server responds with a 301 and curl does not follow the redirect by default.
Query Parameters
As you can see in the example above, our endpoint needs the following query parameters:
Search Query
search
Required
Search keyword that you want to collect data for from the search results page.
page
Optional
The page number for which you want the results. Default value is 1.
Other Required Parameters
platform
Required
Specifies the scraping engine you wish to invoke. In this case, the value should be bestbuy_search.
api_key
Required
Your account's token—which can be obtained by signing up here.
Note
Be sure to replace any whitespace in the search keywords with a plus + sign. So, if you're looking to scrape search results for the keyword "ssd 1tb", please set the value of the query parameter search
to "ssd+1tb".
Results
Each request returns up to 24 results. The response will include the following attirbutes for each product in the search results:
Attributes Returned | Data Type | Information Represented |
---|---|---|
ID | string | Retailer ID of product lisitng |
URL | string | URL of product listing |
thumbnail | string | URL of product's thumbnail |
name | string | Name of product lisitng |
model_no | string | Manufacturer's model number for product |
rating | float | Average rating of product |
price | string | Price of product |
total_reviews | int | No. of reviews received by product |
Response Example
Here's the response you can expect to receive for the request showcased above:
{
"success": true,
"search": "ssd 1tb",
"page": 1,
"total_results": 119,
"no_of_pages": 5,
"result_count": 24,
"results": [
{
"id": "6447127",
"url": "https://www.bestbuy.com/site/samsung-870-evo-1tb-sata-2-5-internal-solid-state-drive/6447127.p",
"thumbnail": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6447/6447127_sd.jpg;maxHeight=200;maxWidth=300",
"name": "Samsung - 870 EVO 1TB SATA 2.5\" Internal Solid State Drive",
"model_no": "MZ-77E1T0B/AM",
"price": "$149.99",
"rating": 4.9,
"total_reviews": 848
},
{
"id": "6454198",
"url": "https://www.bestbuy.com/site/samsung-980-1tb-pcie-gen-3-x4-nvme-gaming-internal-solid-state-drive/6454198.p",
"thumbnail": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6454/6454198_sd.jpg;maxHeight=200;maxWidth=300",
"name": "Samsung - 980 1TB PCIe Gen 3 x4 NVMe Gaming Internal Solid State Drive",
"model_no": "MZ-V8V1T0B/AM",
"price": "$139.99",
"rating": 4.8,
"total_reviews": 549
},
...
{
"id": "6026202",
"url": "https://www.bestbuy.com/site/samsung-t5-1tb-external-usb-type-c-portable-solid-state-drive-deep-black/6026202.p",
"thumbnail": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6026/6026202_sd.jpg;maxHeight=200;maxWidth=300",
"name": "Samsung - T5 1TB External USB Type C Portable Solid State Drive - Deep black",
"model_no": "MU-PA1T0B",
"price": "$109.99",
"rating": 4.9,
"total_reviews": 2276
}
],
"meta_data": {}
}
Request Cost
Request cost for this API is 1 credit per record.
Support
If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com