The Best Buy Search endpoint searches Best Buy US (bestbuy.com) or Canada (bestbuy.ca) by keyword or search URL.
It returns product listings with price, rating and images, plus pagination. Browser rendering is used because Best Buy pages load products with JavaScript.
Costs 2 credits per call.
GET https://api.piloterr.com/v2/bestbuy/search?query=machine
GET https://api.piloterr.com/v2/bestbuy/search?query=machine®ion=ca
GET https://api.piloterr.com/v2/bestbuy/search?query=machine&sort=best_discount
GET https://api.piloterr.com/v2/bestbuy/search?query=https://www.bestbuy.com/site/searchpage.jsp?st=machine
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Keyword or Best Buy search URL |
region |
string |
no |
com (default, USD) or ca (CAD). Detected from a full URL |
page |
integer |
no |
Page number (default: 1) |
sort |
string |
no |
best_selling (default) or best_discount |
return_page_source |
boolean |
no |
Return rendered HTML instead of JSON |
| Field |
Type |
Description |
results |
array |
Product listings |
results[].type |
string |
Always product |
results[].product_id / title / url |
string |
Identifiers and link |
results[].price / original_price / currency |
mixed |
Pricing when present |
results[].rating / review_count |
number |
Reviews when present |
pagination |
object |
page, per_page, total_results, total_pages, has_next_page, next |
| Code |
Meaning |
400 |
Empty or invalid query |
404 |
Page has no usable listings |
500 |
Rendering failed |