# Harvey Norman Search API Documentation

<p><strong>Harvey Norman Search API Documentation</strong> Search the public Harvey Norman Australia catalogue by keyword. Filter by category, processor brand, specials and AUD price range, sort by price and page results. Every item carries an AUD price, an id for the product endpoint, full-size image URLs, a numeric rating and review count. One search costs 1 credit. A search without hits and failed requests are not billed. Not affiliated with Harvey Norman.</p>

- **Documentation:** [https://scrappa.co/docs/harveynorman-api/harveynorman_search](https://scrappa.co/docs/harveynorman-api/harveynorman_search)
- **API group:** Harvey Norman Australia API
- **Endpoint:** `GET https://scrappa.co/api/harveynorman/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, up to 100 characters. |
| `page` | integer | No | 1-based page, default 1. |
| `hitsPerPage` | integer | No | Results per page, 1 to 100, default 20. |
| `min_price` | number | No | Lowest AUD price. |
| `max_price` | number | No | Highest AUD price. |
| `category` | string | No | Category id from the categories endpoint. |
| `processor_brand` | string | No | Processor brand value from the categories endpoint, for example Intel. |
| `specials` | string | No | Special value from the categories endpoint. |
| `sort` | string | No | price_asc or price_desc. Any other value is rejected. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "sku": "NX.DJXSA.001",
                "name": "Aspire Lite 15 Laptop",
                "image": "https://hnau.imgix.net/media/catalog/product/n/x/example.jpg",
                "price": {
                    "amount": 448,
                    "currency": "AUD"
                },
                "images": [
                    "https://hnau.imgix.net/media/catalog/product/n/x/example.jpg"
                ],
                "rating": 4.5455,
                "object_id": "939692",
                "review_count": 33
            }
        ],
        "filters": {
            "sort": null,
            "query": "laptop"
        },
        "currency": "AUD",
        "pagination": {
            "has_more": true,
            "per_page": 20,
            "total_items": 1120,
            "total_pages": 56,
            "current_page": 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 | The source 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)
