# LiveAuctioneers Search

Search online LiveAuctioneers lots with searchTerm, page, pageSize and sort. Each row carries the item id, seller id, catalog id, seller name, estimates, start price, bid count, ISO sale date and a full-size image. The ids are accepted unchanged by the lot and auction routes. Only searchTerm, page, pageSize and sort are exposed; no sold-price filter is offered. A valid empty page is billable; an upstream failure is not.

- **Documentation:** [https://scrappa.co/docs/liveauctioneers-api/liveauctioneers_search](https://scrappa.co/docs/liveauctioneers-api/liveauctioneers_search)
- **API group:** LiveAuctioneers API
- **Endpoint:** `GET https://scrappa.co/api/liveauctioneers/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 |
| --- | --- | --- | --- |
| `searchTerm` | string | Yes | Free text search, e.g. rolex. |
| `page` | integer | No | Result page, 1-based. Default: 1. |
| `pageSize` | integer | No | Results per page: 24, 48 or 96. Default: 48. |
| `sort` | string | No | -publishDate (default), publishDate, saleStartTs or -saleStartTs. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/liveauctioneers/search?searchTerm=rolex&page=1&pageSize=48"
```

## Example response

```json
{
    "success": true,
    "data": {
        "query": "rolex",
        "page": 1,
        "page_size": 48,
        "has_more": true,
        "results": [
            {
                "id": "247955736",
                "seller_id": "12345",
                "catalog_id": "439140",
                "seller_name": "Example Auctions",
                "estimate_low": 1000,
                "estimate_high": 2000,
                "currency": "USD",
                "sale_date": "2026-10-04T12:00:00+00:00"
            }
        ]
    },
    "meta": {
        "endpoint_family": "search"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. The request is not billed. |
| 503 | Upstream Unavailable | The auction source did not answer. 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)
