# JB Hi-Fi Search API Documentation

<p><strong>JB Hi-Fi Search API</strong> returns public product records as JSON. Use query for a keyword. Price ranges, categories and descending sort use the public search index. Prices are numbers with AUD, dates are ISO 8601 and image URLs are full size.</p><p><strong>Credits:</strong> 1 credit per successful request. Failed and invalid requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/jbhifi-api/jbhifi_search](https://scrappa.co/docs/jbhifi-api/jbhifi_search)
- **API group:** JB Hi-Fi API
- **Endpoint:** `GET https://scrappa.co/api/jbhifi/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 | No | Keyword, optional when filters are used |
| `page` | integer | No | One-based page number |
| `page_size` | integer | No | Results per page, 1 to 100 |
| `page_token` | string | No | Opaque cursor from a previous response. Do not combine with sort, category or price filters; use page instead. |
| `sort` | string | No | best_match, price_low, price_high, rating_high or new |
| `category` | string | No | Category or collection handle |
| `brand` | string | No | Brand facet value as returned by search, for example SONY |
| `min_price` | number | No | Minimum price in AUD |
| `max_price` | number | No | Maximum price in AUD |

## Example response

```json
{
    "data": {
        "total": 1,
        "currency": "AUD",
        "products": [
            {
                "sku": "623380",
                "price": 199,
                "title": "Sony headphones",
                "handle": "sony-wh-ch730n-wireless-noise-cancelling-over-ear-headphones-black",
                "currency": "AUD",
                "discount": 100,
                "was_price": 299
            }
        ]
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The request cannot be served as sent. |  |
|  | JB Hi-Fi could not be reached. Please retry shortly. |  |

## 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)
