# Elgiganten Search API Documentation

<p><strong>Elgiganten Search API Documentation</strong> Search the public Elgiganten and Gigantti catalogs by keyword or category. Filter by price range, sort and page. Sort orders only the items of the returned page. Every item carries an article number, a numeric price with currency, a numeric rating and a full size image URL. Article numbers work unchanged in the product and reviews endpoints. One search costs 1 credit. Empty and failed requests are not billed. Not affiliated with Elgiganten.</p>

- **Documentation:** [https://scrappa.co/docs/elgiganten-api/elgiganten_search](https://scrappa.co/docs/elgiganten-api/elgiganten_search)
- **API group:** Elgiganten API
- **Endpoint:** `GET https://scrappa.co/api/elgiganten/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 |
| --- | --- | --- | --- |
| `site` | string | No | se (default) or fi. |
| `query` | string | No | Search words. Use this or category. |
| `category` | string | No | Category browse words. Use this or query. |
| `min_price` | number | No | Lowest price. |
| `max_price` | number | No | Highest price. |
| `sort` | string | No | relevance, price_asc, price_desc or rating. Orders only the items of the returned page. |
| `page` | integer | No | 1-based page, up to 50. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "name": "Example laptop",
                "brand": "Example",
                "price": {
                    "amount": 8999,
                    "currency": "SEK"
                },
                "rating": 4.5,
                "currency": "SEK",
                "imageUrl": "https://example.com/image.jpg",
                "objectID": "969840",
                "productUrl": "https://www.elgiganten.se/product/example",
                "review_count": 42,
                "articleNumber": "969840"
            }
        ],
        "filters": {
            "site": "se",
            "sort": "relevance",
            "query": "laptop",
            "category": null,
            "max_price": null,
            "min_price": null
        },
        "pagination": {
            "has_more": true,
            "per_page": 11,
            "total_items": 1845,
            "total_pages": 168,
            "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 upstream 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)
