# Best Buy Canada Search API Documentation

<p><strong>Best Buy Canada Search API Documentation</strong> Search public Best Buy Canada by keyword. Filter by live category id, price range, sort and page. Every product has a SKU, a sale price and a regular price as numbers with CAD, the discount, full size image URLs and a numeric rating. SKUs work unchanged in product, reviews and availability. One search costs 1 credit. A search without hits is not billed. Failed requests are not billed. Not affiliated with Best Buy.</p>

- **Documentation:** [https://scrappa.co/docs/bestbuy-ca-api/bestbuy_ca_search](https://scrappa.co/docs/bestbuy-ca-api/bestbuy_ca_search)
- **API group:** Best Buy Canada API
- **Endpoint:** `GET https://scrappa.co/api/bestbuy-ca/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Keyword to search, up to 100 characters. |
| `categoryid` | string | No | Live category id from search or the category endpoint. |
| `min_price` | number | No | Lowest sale price in CAD. |
| `max_price` | number | No | Highest sale price in CAD. |
| `sortBy` | string | No | relevance (default), price, rating or name. |
| `sortDir` | string | No | asc or desc. |
| `page` | integer | No | 1-based page. |
| `pageSize` | integer | No | Results per page, 1 to 100. |
| `lang` | string | No | en-CA or fr-CA. |
| `currentRegion` | string | No | Province such as ON. |
| `path` | string | No | Facet filter such as brandName:HP. |

## Example response

```json
{
    "data": {
        "paths": [],
        "total": 1,
        "facets": [],
        "currency": "CAD",
        "pageSize": 24,
        "products": [
            {
                "sku": "19889758",
                "name": "Example laptop",
                "image": "https://example-image-host/full/19889758.jpeg",
                "images": [
                    "https://example-image-host/full/19889758.jpeg"
                ],
                "discount": {
                    "amount": 200,
                    "currency": "CAD"
                },
                "salePrice": {
                    "amount": 999.99,
                    "currency": "CAD"
                },
                "categoryIds": [
                    "20352"
                ],
                "saleEndDate": "2026-12-04T00:00:00+00:00",
                "regularPrice": {
                    "amount": 1199.99,
                    "currency": "CAD"
                },
                "customerRating": 4.6,
                "customerRatingCount": 321
            }
        ],
        "totalPages": 1,
        "currentPage": 1
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. Not billable. |
| 502 | Upstream Unavailable | Best Buy Canada did not answer or sent unreadable data. Not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
