# Best Buy Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/bestbuy/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/bestbuy-product |

## Description

Get a Best Buy US or Canada product page: title, price, brand, stock, images, categories and specs via browser rendering.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/bestbuy/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### GIGABYTE AERO X16 (US)

```json
{
  "sku": "11377127",
  "url": "https://www.bestbuy.com/product/gigabyte-aero-x16-copilot-pc-165hz-wqxga-rtx-5070-ryzen-ai-7-350-1tb-ssd-16gb-ddr5-windows-11-lunar-white/J3GWPQC2RQ",
  "brand": "GIGABYTE",
  "price": 1932.49,
  "title": "GIGABYTE - AERO X16 Copilot+ PC - 165Hz WQXGA - RTX 5070 - Ryzen AI 7 350 - 1TB SSD 16GB DDR5 - Windows 11 - Lunar White",
  "images": [
    "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/sample.jpg"
  ],
  "region": "com",
  "currency": "USD",
  "in_stock": true,
  "categories": [
    "Computers & Tablets",
    "Laptops",
    "All Laptops",
    "Windows Laptops"
  ],
  "product_id": "J3GWPQC2RQ",
  "specifications": [
    {
      "name": "Screen Size",
      "value": "16.0 inches"
    }
  ]
}
```

## Documentation

## Overview
The **Best Buy Product** endpoint returns a full Best Buy product page from the US or Canada: title, price, brand, stock, images, categories and specifications.

Pass a product URL. Browser rendering is used. Costs **2 credits** per call.

## Quickstart
```
GET https://api.piloterr.com/v2/bestbuy/product?query=https://www.bestbuy.com/product/gigabyte-aero-x16-copilot-pc-165hz-wqxga-rtx-5070-ryzen-ai-7-350-1tb-ssd-16gb-ddr5-windows-11-lunar-white/J3GWPQC2RQ
GET https://api.piloterr.com/v2/bestbuy/product?query=https://www.bestbuy.ca/fr-ca/produit/machine-a-espresso-automatique-800-de-philips-avec-moussoir-a-lait-noir-mat-exclusivite-best-buy/16691494
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full Best Buy product URL (`/product/...` or `/fr-ca/produit/...`) |
| `return_page_source` | boolean | no | Return rendered HTML instead of JSON |

## Response fields
| Field | Type | Description |
|---|---|---|
| `region` | string | `com` or `ca` |
| `product_id` / `sku` | string | Identifiers |
| `title` / `brand` | string | Product name and brand |
| `price` / `currency` | number / string | Current price |
| `url` | string | Canonical product URL |
| `in_stock` | boolean | Availability when present |
| `images` | string[] | Image URLs |
| `categories` | string[] | Category trail |
| `specifications` | array | `{ name, value }` pairs |

## Error codes
| Code | Meaning |
|---|---|
| `400` | Empty or invalid `query` |
| `404` | No usable product data |
| `500` | Rendering failed |

## Related endpoints
- [Best Buy Search](https://www.piloterr.com/library/bestbuy-search)