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 |
|
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.
item_id
Optional
Item ID can be used in place of the url parameter. It can be found in the trailing end of the product listing's 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 listing |
description | string | Description of product listing |
images | array | List of image URLs for the product |
brand | string | Brand name of the product |
price | float | Price of product |
currency | string | Currency code (e.g. "USD") |
currency_symbol | string | Currency symbol (e.g. "$") |
product_id | string | Retailer's product ID |
rating | float | Average rating of product (out of 5) |
total_reviews | integer | Total number of reviews for the product |
in_stock | boolean | Indicates if product is in stock |
categories | array | List of category objects the product belongs to |
included_items | array | List of items included with the product |
product_features | array | List of product feature objects |
is_energy_star_certified | boolean | Indicates if product is Energy Star certified |
model_no | string | Manufacturer's model number for the product |
specifications | array | List of product specification objects |
Response Example
Here's the response you can expect to receive for the request showcased above:
{
"success": true,
"url": "https://www.bestbuy.com/site/bose-quietcomfort-ultra-wireless-noise-cancelling-over-the-ear-headphones-black/6554464.p",
"result_count": 1,
"detail": {
"name": "Bose - QuietComfort Ultra Wireless Noise Cancelling Over-the-Ear Headphones - Black",
"images": [
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6554/6554464_sd.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6554/6554464_sd.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6554/6554464_rd.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6554/6554464cv12d.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6554/6554464ld.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6554/6554464cv13d.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/exc/videometadata/thumbnail/db0fc5ff2d56bb38b3f97b8fc488cb8e.jpg",
"https://pisces.bbystatic.com/image2/BestBuy_US/ugc/photos/thumbnail/549e727ceda2ea05eba71c0e0d18c9d3.jpg"
],
"brand": "Bose",
"price": 349.0,
"currency": "USD",
"currency_symbol": "$",
"product_id": "6554464",
"rating": 4.7,
"total_reviews": 1069,
"in_stock": true,
"categories": [
{
"name": "Audio",
"url": "https://www.bestbuy.com/site/electronics/audio/abcat0200000.c?id=abcat0200000"
},
{
"name": "Headphones",
"url": "https://www.bestbuy.com/site/audio/headphones/abcat0204000.c?id=abcat0204000"
},
{
"name": "All Headphones",
"url": "https://www.bestbuy.com/site/headphones/all-headphones/pcmcat144700050004.c?id=pcmcat144700050004"
}
],
"description": "Level up with QuietComfort Ultra headphones – immersive, personalized sound meets premium, next-level noise cancelling headphones in striking colors. Pushing the boundaries with breakthrough spatial audio, these wireless headphones take what you're hearing inside your head and place it in front of you for more natural, real sounding music. Whatever your music source, it's just like listening to it live when you're wearing the QC Ultra headphones. Unique to Bose, the QC Ultra headphones feature CustomTune technology which analyzes your ear's shape and adapts the audio performance so everything you listen to hits exactly as it should. You won't want to take them off because of the refined and premium materials. The cushions wrap your ears in a soft hug. The headband spreads pressure evenly. And sleek metal arms add a statement of sophisticated design. Connect to your devices with advanced Bluetooth 5.3 headphones and keep track of what you have paired in the Bose app. It also walks you through setup, gives you access to Adjustable EQ settings, and more. The QuietComfort Ultra headphones, sound just got real.",
"included_items": [
"Bose QuietComfort Ultra Headphones",
"USB-C (A to C) cable (20\")",
"3.5 mm to 2.5 mm audio cable",
"Carry case",
"Safety sheet"
],
"product_features": [
{
"name": "Personalized sound with Bose Immersive Audio",
"value": "Get next-level sound with the QuietComfort Ultra wireless headphones. Featuring innovative spatial audio, these headphones take what you're hearing inside your head and place it in front of you for more natural, real sounding music."
},
{
"name": "Go ahead, listen longer",
"value": "Up to 24 hours of battery life will keep your music playing through even the longest listening sessions (or up to 18 hours with Immersive Audio).* Plus, a quick 15-minute charge gets you up to 2.5 hours of play time (up to 2 hours with Immersive Audio).**"
},
{
"name": "World-class active noise cancelling headphones",
"value": "Do what you do uninterrupted, with Quiet Mode you get full noise cancellation to focus, while Aware Mode allows you to hear your surroundings. Immersion Mode combines full noise cancellation and Bose Immersive Audio."
},
{
"name": "Crystal-clear headphones with a mic for natural-sounding phone calls",
"value": "No more "huh?" when you're trying to just say "hello." Noise-rejecting mics and focus on your voice and filter out background noise for the clearest calls. They'll play through both or a single speaker, whatever works for you."
},
{
"name": "Smarter connections with Bluetooth Multi-Point and Google Fast Pair",
"value": "Get a strong, continuous connection within 30 feet of your device with wireless Bluetooth headphones from Bose. Choose single- or multi-point to keep your phone, tablet, and work or school computer paired or just focus on one."
},
{
"name": "Next-Level listening with sound shaped to you",
"value": "With CustomTune technology, the QuietComfort Ultra Headphones adapt the sound performance to your ears by analyzing their unique shape. You get sound that fits you, doesn't that sound better?"
},
{
"name": "Elevated design. Luxe comfort.",
"value": "Modern, sleek, sophisticated. The cushions wrap your ears in a soft hug. The headband spreads pressure evenly. And sleek metal arms add a statement of sophisticated design."
},
{
"name": "Swipe, tap, touch to get into the music",
"value": "Touch controls on each earcup get you to your music faster. Change the volume, skip the track, cycle through noise cancelling modes all without taking out your phone."
},
{
"name": "Bose SimpleSync for more sound",
"value": "Press and hold the Bluetooth button on each device to sync sound between your QC Ultra Headphones and a Bose smart soundbar with SimpleSync technology. That way you can watch TV at a different volume than others, or discreetly listen while someone sleeps beside you."
},
{
"name": "Customize your experience with the Bose app",
"value": "Take personalization even further with Adjustable EQ settings in the Bose app. Control bass, mid-range, and treble levels as you go. Or use the app to check battery life, customize a shortcut, and manage connected devices."
}
],
"is_energy_star_certified": false,
"model_no": "880066–0100",
"specifications": [
{
"type": "Key Specs",
"name": "Noise Cancelling (Active)",
"value": "true"
},
{
"type": "Key Specs",
"name": "Sound Mode",
"value": "Stereo"
},
{
"type": "Key Specs",
"name": "Connection Type",
"value": "Wireless, Wired"
},
{
"type": "Key Specs",
"name": "Wireless Connectivity",
"value": "Bluetooth"
},
{
"type": "Key Specs",
"name": "True Wireless",
"value": "false"
},
{
"type": "Key Specs",
"name": "Maximum Wireless Range",
"value": "30 feet"
},
{
"type": "Key Specs",
"name": "Water Resistant",
"value": "false"
},
{
"type": "Key Specs",
"name": "Built-In Microphone",
"value": "true"
},
{
"type": "Key Specs",
"name": "Carrying Case",
"value": "true"
},
{
"type": "Key Specs",
"name": "Microphone Features",
"value": "Noise cancelling"
},
{
"type": "Key Specs",
"name": "Headphone Fit",
"value": "Over-the-Ear"
},
{
"type": "Key Specs",
"name": "Adjustable Headband",
"value": "true"
},
{
"type": "Key Specs",
"name": "Battery Life",
"value": "24 hours"
},
{
"type": "Key Specs",
"name": "Battery Charge Time",
"value": "3 hours"
},
{
"type": "Key Specs",
"name": "Voice Assistant Built-in",
"value": "No"
},
{
"type": "General",
"name": "Product Name",
"value": "QuietComfort Ultra Wireless Noise Cancelling Over-the-Ear Headphones"
},
{
"type": "General",
"name": "Brand",
"value": "Bose"
},
{
"type": "General",
"name": "Model Number",
"value": "880066–0100"
},
{
"type": "General",
"name": "Series",
"value": "2023 QuietComfort Ultra Headphones"
},
{
"type": "General",
"name": "Color",
"value": "Black"
},
{
"type": "General",
"name": "Color Category",
"value": "Black"
},
{
"type": "Audio",
"name": "Noise Cancelling (Active)",
"value": "true"
},
{
"type": "Audio",
"name": "Sound Isolating",
"value": "true"
},
{
"type": "Audio",
"name": "Environmental Noise Control",
"value": "true"
},
{
"type": "Audio",
"name": "Integrated Amplifier",
"value": "false"
},
{
"type": "Audio",
"name": "Volume Limiting Function",
"value": "false"
},
{
"type": "Audio",
"name": "Sound Mode",
"value": "Stereo"
},
{
"type": "Connectivity",
"name": "Connection Type",
"value": "Wireless, Wired"
},
{
"type": "Connectivity",
"name": "Wireless Connectivity",
"value": "Bluetooth"
},
{
"type": "Connectivity",
"name": "True Wireless",
"value": "false"
},
{
"type": "Connectivity",
"name": "Bluetooth Version",
"value": "5.3"
},
{
"type": "Connectivity",
"name": "Maximum Wireless Range",
"value": "30 feet"
},
{
"type": "Connectivity",
"name": "Number Of Devices Connectable Simultaneously",
"value": "2"
},
{
"type": "Connectivity",
"name": "Connector Size",
"value": "3/32 in. (2.5mm)"
},
{
"type": "Connectivity",
"name": "Detachable Cord",
"value": "true"
},
{
"type": "Connectivity",
"name": "Tangle-Resistant Cord",
"value": "true"
},
{
"type": "Features",
"name": "Water Resistant",
"value": "false"
},
{
"type": "Features",
"name": "Waterproof",
"value": "false"
},
{
"type": "Features",
"name": "Built-In Microphone",
"value": "true"
},
{
"type": "Features",
"name": "Carrying Case",
"value": "true"
},
{
"type": "Features",
"name": "Microphone Features",
"value": "Noise cancelling"
},
{
"type": "Features",
"name": "Controls",
"value": "Volume, Track selection"
},
{
"type": "Features",
"name": "Body Metrics Measured",
"value": "Not Applicable"
},
{
"type": "Features",
"name": "Bone Conducting Technology",
"value": "false"
},
{
"type": "Features",
"name": "Number of Programmable Buttons",
"value": "1"
},
{
"type": "Features",
"name": "Lighting Type",
"value": "None"
},
{
"type": "Features",
"name": "Maximum Talk Time",
"value": "24 hours"
},
{
"type": "Design",
"name": "Headphone Fit",
"value": "Over-the-Ear"
},
{
"type": "Design",
"name": "Style",
"value": "Travel"
},
{
"type": "Design",
"name": "Adjustable Headband",
"value": "true"
},
{
"type": "Design",
"name": "Foldable Design",
"value": "true"
},
{
"type": "Power",
"name": "Rechargeable",
"value": "true"
},
{
"type": "Power",
"name": "Battery Life",
"value": "24 hours"
},
{
"type": "Power",
"name": "Battery Charge Time",
"value": "3 hours"
},
{
"type": "Power",
"name": "Charging Accessory Included",
"value": "Cable"
},
{
"type": "Power",
"name": "Charging Interface(s)",
"value": "USB Type C"
},
{
"type": "Power",
"name": "On/Off Switch",
"value": "Yes"
},
{
"type": "Compatibility",
"name": "Voice Assistant Built-in",
"value": "No"
},
{
"type": "Material",
"name": "Ear Cushion Material",
"value": "Protein Leather"
},
{
"type": "Material",
"name": "Headband Material",
"value": "Aluminum, Plastic"
},
{
"type": "Dimension",
"name": "Product Height",
"value": "7.7 inches"
},
{
"type": "Dimension",
"name": "Product Width",
"value": "5.5 inches"
},
{
"type": "Dimension",
"name": "Product Depth",
"value": "2 inches"
},
{
"type": "Dimension",
"name": "Product Weight",
"value": "0.56 pounds"
},
{
"type": "Dimension",
"name": "Cord Length",
"value": "1.67 feet"
},
{
"type": "Warranty",
"name": "Manufacturer's Warranty - Parts",
"value": "1 year"
},
{
"type": "Warranty",
"name": "Manufacturer's Warranty - Labor",
"value": "1 year"
},
{
"type": "Other",
"name": "UPC",
"value": "017817846172"
}
]
},
"remaining_credits": 646763
}
Request Cost
1 credit per request.
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