Piloterr

Bestbuy Search

Search for products on Best Buy by keyword, returning results with prices, ratings, images, and discount information.

Credit cost: 1 credit per call

GET
/v2/bestbuy/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Search keyword to find products on Best Buy.

Example:

macbook

Note: Use short, targeted keywords for best results. Category names, brand names, or product types all work well.

page?number

Page number for pagination.

Example: Pass 2 to retrieve the second page of results.

Default"1"
sort?string

Sort order for search results.

  • best_selling: Sort by best-selling products (default)
  • best_discount: Sort by highest discount percentage
Default"best_selling"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/bestbuy/search?query=string"
[
  {
    "sku": "6602767",
    "url": "https://www.bestbuy.com/site/apple-macbook-air-13-inch-apple-m3-chip-built-for-apple-intelligence-16gb-memory-256gb-ssd-midnight/6602767.p?skuId=6602767",
    "name": "Apple - MacBook Air 13-inch Apple M3 chip Built for Apple Intelligence - 16GB Memory - 256GB SSD - Midnight",
    "save": "18.20%",
    "image": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6b46488d-0489-4822-896b-6bc2fbe0a970.jpg",
    "model": "MC8K4LL/A",
    "price": 899,
    "rating": 4.8,
    "is_sold_out": false,
    "rating_count": 639,
    "original_price": 1099
  },
  {
    "sku": "6602763",
    "url": "https://www.bestbuy.com/site/apple-macbook-air-13-inch-apple-m2-chip-built-for-apple-intelligence-16gb-memory-256gb-ssd-midnight/6602763.p?skuId=6602763",
    "name": "Apple - MacBook Air 13-inch Apple M2 chip Built for Apple Intelligence - 16GB Memory - 256GB SSD - Midnight",
    "save": null,
    "image": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/macbook-air.jpg",
    "model": "MQKW3LL/A",
    "price": 999,
    "rating": 4.9,
    "is_sold_out": false,
    "rating_count": 3247,
    "original_price": null
  }
]
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}