# momox Search API Documentation

<p>Search the public momox catalogue by query and 1-based page. The query may be search words, an EAN or a product id. Filter by a condition value or a quoted price facet range, and sort by the lowest price. Returns the total count, products with ids, EANs, full size images, best in-stock price, lowest price with its condition and a condition ladder, plus facets and related searches. Prices are numbers with currency. An out-of-range page returns an empty result. 1 credit per successful request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/momox-api/momox_search](https://scrappa.co/docs/momox-api/momox_search)
- **API group:** momox API
- **Endpoint:** `GET https://scrappa.co/api/momox/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 | Search words, an EAN or a product id |
| `page` | integer | No | 1-based page, default 1 |
| `page_size` | integer | No | Results per page, default 10 |
| `condition` | string | No | A condition facet value such as UsedGood |
| `price` | string | No | A quoted facet range such as &quot;5&quot;-&quot;10&quot; |
| `sort_by` | string | No | min_price |
| `sort_order` | string | No | ascending or descending |

## Example response

```json
{
    "data": {
        "page": 1,
        "count": 10,
        "query": "harry potter",
        "total": 5853,
        "products": [
            {
                "id": "M03551551685",
                "ean": "9783551551689",
                "price": {
                    "amount": 5.71,
                    "currency": "EUR"
                },
                "title": "Harry Potter",
                "conditions": [
                    {
                        "price": {
                            "amount": 5.71,
                            "currency": "EUR"
                        },
                        "stock": 1755,
                        "condition": "UsedGood"
                    }
                ]
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | An invalid parameter or filter was sent. Failed requests are not billed. |
| 503 | Upstream Unavailable | The source is temporarily unreachable. Failed requests are not billed. |

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