Piloterr

Best Buy Search

GET
/v2/bestbuy/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

Authorization

ApiKeyAuth
headerx-api-key<token>

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

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.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/bestbuy/search?query=string'
Example Response
{  "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  }}