Skip to content

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
curl -v -L 'https://data.unwrangle.com/api/getter/?platform=bestbuy_search&search=ssd+1tb&api_key=API_KEY'

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

Each request to this endpoint costs 50 credits regardless of the number of results.

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