Skip to content

BestBuy Product Data API

A GET request to our /api/getter/?platform="bestbuy_detail" endpoint allows you to scrape product data for any product listing URL on BestBuy.com in real-time.

Example

To scrape details about the latest iPhone from BestBuy, you can use the following command:

1
curl -v -L 'https://data.unwrangle.com/api/getter/?platform=bestbuy_detail&url=https%3A%2F%2Fwww.bestbuy.com%2Fsite%2Fapple-iphone-13-5g-128gb-midnight-verizon%2F6443282.p&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:

Product URL

url

Required

Product listing's URL on BestBuy.com. Remove unnecessary query parameters and encode the URL.

Other Required Parameters

platform

Required

Specifies the scraping engine you wish to invoke. In this case, the value should be bestbuy_detail.

api_key

Required

Your account's token—which can be obtained by signing up here.

Note

The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.

Results

The response will include the following attirbutes for the product:

Attributes Returned Data Type Information Represented
name string Name of product lisitng
description string Description of product lisitng
images string Average rating of product
categories string List of categories the product belongs to
price string Price of product
product_id string Retailer's product ID
model_no string Manufacturer's model no. for product
rating float Average rating of product
total_reviews int No. of reviews received

Response Example

Here's the response you can expect to receive for the request showcased above:

{
    "success": true,
    "url": "https://www.bestbuy.com/site/apple-iphone-13-5g-128gb-midnight-verizon/6443282.p",
    "result_count": 1,
    "detail": {
        "name": "Apple - iPhone 13 5G 128GB - Midnight (Verizon)",
        "description": "iPhone 13. The most advanced dual-camera system ever on iPhone. Lightning-fast A15 Bionic chip. A big leap in battery life. Durable design. Superfast 5G.¹ And a brighter Super Retina XDR display.",
        "images": [
            "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6443/6443282_sd.jpg;maxHeight=640;maxWidth=550"
        ],
        "categories": [
            {
                "name": "Cell Phones",
                "url": "https://www.bestbuy.com/site/electronics/mobile-cell-phones/abcat0800000.c?id=abcat0800000"
            },
            {
                "name": "All Cell Phones with Plans",
                "url": "https://www.bestbuy.com/site/mobile-cell-phones/mobile-phones-with-plans/pcmcat209400050001.c?id=pcmcat209400050001"
            }
        ],
        "price": "$22.22",
        "product_id": "6443282",
        "model_no": "MLML3LL/A ",
        "rating": 4.7,
        "total_reviews": 424
    }
}

Request Cost

Each request to this endpoint costs 50 credits.

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