Piloterr

Best Buy Search

Search Best Buy US or Canada by keyword or search URL. Returns product listings with price, rating and pagination via browser rendering.

Credit cost: 2 credits 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

Keyword or full Best Buy search URL.

Examples:

machine
https://www.bestbuy.com/site/searchpage.jsp?st=machine
https://www.bestbuy.ca/fr-ca/chercher?search=machine

A full Best Buy URL auto-detects region.

region?string

Best Buy country when query is not a full URL (default: com).

Supported:

page?number

Page number (default: 1).

sort?string

Sort order (default: best_selling).

Supported: best_selling, best_discount

Default"best_selling"
return_page_source?boolean

When true, return rendered HTML as {"result": "..."} instead of JSON. Defaults to false.

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"
{
  "results": [
    {
      "url": "https://www.bestbuy.com/product/singing-machine-smk302pp-kids-bluetooth-headphones-pink-collectibles-multicolor/J7GW9JWXZ5",
      "type": "product",
      "price": 29.99,
      "title": "Singing Machine - SMK302PP Kids Bluetooth Headphones Pink - COLLECTIBLES - Multicolor",
      "currency": "USD",
      "condition": "new",
      "image_url": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/014a6bfe-fd8a-413d-a204-49efbdb9baaa.jpg",
      "product_id": "J7GW9JWXZ5"
    }
  ],
  "pagination": {
    "next": 2,
    "page": 1,
    "per_page": 18,
    "total_pages": 763,
    "has_next_page": true,
    "total_results": 13730
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}