# Sauto.cz API scraper — search Seznam's Czech vehicle marketplace (~121 000 live ads across cars, vans, trucks, motorcycles, quads, trailers, campers, machinery and buses): make/model, price, mileage, power, engine size, fuel, gearbox, colour, drivetrain, dealer-vs-private, region/district and seven sorts, plus the full detail document with VIN, equipment list, roadworthiness date and every photo. Prices are the source's own CZK integers; an ad priced 'by agreement' returns null, not a fake zero. Every filter Sauto can silently drop is proved against a same-run control before the answer is returned. No account, public logged-out data only; the seller phone number and dealer contacts come back as Sauto publishes them.

> Search Sauto listings. Everything is optional — with no filters at all it returns the newest cars (category `osobni`). 🔴 Sauto applies `make`/`model` only inside a category and drops an unknown make or model in silence with HTTP 200, so this action re-runs the identical query without that filter in the same call and raises INVALID_PARAM when the source's own total did not move. Paid 'topped' ads come back in the position Sauto puts them, flagged `promoted: true`.
> ReefAPI engine `sauto` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/sauto/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/sauto/v1/search — 1 credit
Search Sauto listings. Everything is optional — with no filters at all it returns the newest cars (category `osobni`). 🔴 Sauto applies `make`/`model` only inside a category and drops an unknown make or model in silence with HTTP 200, so this action re-runs the identical query without that filter in the same call and raises INVALID_PARAM when the source's own total did not move. Paid 'topped' ads come back in the position Sauto puts them, flagged `promoted: true`.

**Parameters:**
- `category` (enum, optional, default "osobni") — Sauto's own vehicle section. The numeric id (838…846) is accepted too. `make`, `model` and `body` are only applied inside a category, which is why one is always sent. [one of: osobni, uzitkova, nakladni, motorky, ctyrkolky, privesy-navesy, obytne, pracovni-stroje, autobusy]
- `query` (string, optional) — Free-text phrase, passed to Sauto's own `phrase` search over the ad title and variant.
- `make` (string, optional) — Manufacturer, as Sauto's own url slug (`skoda`, `bmw`, `mercedes-benz`). Call the `filters` action with filter=manufacturer_cb for the live list. A make Sauto does not know is rejected, not silently ignored.
- `model` (string, optional) — Model slug, e.g. `octavia`, `rada-3`. Requires `make` (Sauto keys models under the make). Call `filters` with filter=model_cb&make=<make> for the live list.
- `condition` (enum, optional) — Vehicle condition, Sauto's own value. [one of: nove, ojete, havarovane, predvadeci, veteran]
- `fuel` (enum, optional) — Fuel type. [one of: benzin, nafta, lpg-benzin, elektro, hybridni, cng-benzin, ethanol, jine, vodik]
- `gearbox` (enum, optional) — Transmission. [one of: manualni, poloautomaticka, automaticka, variator]
- `body` (string, optional) — Body style, Sauto's own slug. The vocabulary differs per category (cars: hatchback, sedanlimuzina, kombi, suv, kupe, kabriolet, van, mpv, terenni, pick-up, liftback, roadster, cuv; motorcycles: skutr, nakedbike, enduro, chopper…), so outside `osobni` it is resolved against that category's live codebook. Call `filters` with filter=vehicle_body_cb for the list.
- `color` (enum, optional) — Exterior colour. [one of: bila, cerna, seda, stribrna, modra, cervena, zelena, hneda, bezova, zluta, oranzova, vinova, ruzova, fialova, zlata, bronzova, jina]
- `drive` (enum, optional) — Drivetrain. [one of: 4x4, pohon-prednich-kol, pohon-zadnich-kol]
- `seller_type` (enum, optional) — Who is selling. [one of: soukromy, autobazar]
- `dealer_id` (integer, optional) — Only this dealership's stock. The id is the `dealer.id` of any listing it sells.
- `price_min` (integer, optional) — Lowest asking price, in CZK.
- `price_max` (integer, optional) — Highest asking price, in CZK. Ads priced 'by agreement' carry no number and drop out of a price band — that is Sauto's behaviour, not a parse gap.
- `mileage_min` (integer, optional) — Lowest odometer reading, in km.
- `mileage_max` (integer, optional) — Highest odometer reading, in km.
- `power_min` (integer, optional) — Lowest engine power, in kW (Sauto's own unit; 100 kW ≈ 136 hp).
- `power_max` (integer, optional) — Highest engine power, in kW.
- `engine_volume_min` (integer, optional) — Smallest engine displacement, in cm³.
- `engine_volume_max` (integer, optional) — Largest engine displacement, in cm³.
- `seats_min` (integer, optional) — Fewest seats.
- `seats_max` (integer, optional) — Most seats.
- `region_id` (integer, optional) — Czech region (kraj) id, as printed in every listing's `locality.region_id`. Sauto has no radius search and no postcode filter — region or district is the whole locality vocabulary it offers.
- `district_id` (integer, optional) — Czech district (okres) id, as printed in every listing's `locality.district_id`. Cannot be combined with region_id.
- `sort` (enum, optional, default "newest") — Result order. [one of: newest, price_asc, price_desc, mileage_asc, mileage_desc, year_asc, year_desc]
- `page` (integer, optional, default 1) — 1-based page. Sauto stops answering past offset 10 000, so the last reachable page is 10000 / page_size.
- `page_size` (integer, optional, default 20) — Listings per page, 1-100.

**Returns:** category, total_results, page, page_size, has_more, next_page, applied (the filters Sauto actually honoured) and listings[] with id, url, title, variant, make/model/category {value,name,seo_name}, price, price_currency (CZK), price_kind (fixed|by_agreement|absent), mileage_km, fuel, gearbox, manufacturing_date, in_operation_date, locality (region/district/municipality + ids), dealer {id,name,seo_name,logo,url,phones,emails,web — contacts null on search}, seller_type, user (a private seller's block as Sauto sends it), image, image_count, promoted, home_delivery, cebia_verified, dealer_reference, created_at, updated_at. Body, colour, power, engine size, VIN and equipment are NOT in Sauto's search document — call `listing` for those.

**Example request body:**
```json
{
  "category": "osobni"
}
```

### POST https://api.reefapi.com/sauto/v1/listing — 1 credit
The full detail document of one Sauto ad: description, condition, body, colour, drivetrain, engine power and displacement, doors, seats, airbags, VIN, roadworthiness (STK) expiry, service book, VAT treatment, the complete equipment list with its categories, every photo, and the seller's phone number and the dealer's phones, e-mails and website as Sauto publishes them. Takes the numeric id or a sauto.cz detail url.

**Parameters:**
- `id` (integer, optional) — Sauto item id — the number at the end of every detail url, and the `id` of every search hit. Give this or `url`.
- `url` (string, optional) — A sauto.cz detail link; the id is read off the end of it. Give this or `id`.

**Returns:** Every search field plus description, condition, body, color, color_type, drive, aircondition, euro_level, certification, country_of_origin, gearbox_levels, engine_power_kw, engine_volume_ccm, doors, seats, airbags, vin, stk_date, service_book, first_owner, price_original, price_without_vat, price_is_without_vat, price_is_vat_deductible, cebia_smart_code_url, images[], videos[], equipment[] {value,name,category}, equipment_count, status, valid_to, deal_type, phone and dont_show_phone (as Sauto publishes them). A field Sauto does not publish for that ad comes back null.

**Example request body:**
```json
{
  "url": "https://www.sauto.cz/osobni/detail/skoda/karoq/211075173"
}
```

### POST https://api.reefapi.com/sauto/v1/filters — 1 credit
The resolver for `search`: Sauto's own codebooks, per category. With no `filter` it lists every filter that category publishes (name_id + Czech label + whether the search endpoint honours it). With a `filter` it returns that codebook's values — makes, models, body styles, colours, equipment codes — each with the seo slug `search` expects. Needed because the body and model vocabularies are different for cars, motorcycles and trucks.

**Parameters:**
- `category` (enum, optional, default "osobni") — Which section's codebooks to read. [one of: osobni, uzitkova, nakladni, motorky, ctyrkolky, privesy-navesy, obytne, pracovni-stroje, autobusy]
- `filter` (string, optional) — A filter `name_id` from this action's own no-filter listing, e.g. manufacturer_cb, model_cb, vehicle_body_cb, color_cb, equipment_cb. Omit it to see the list.
- `make` (string, optional) — Only with filter=model_cb: keep just this manufacturer's models. Sauto has no server-side parent filter, so the full model codebook is read and matched on each value's own parent.
- `page` (integer, optional, default 1) — 1-based page over a codebook's values.
- `page_size` (integer, optional, default 200) — Values per page, 1-1000.

**Returns:** Without `filter`: category and filters[] with name_id, label, codebook_id, multiselect and search_supported. With `filter`: category, filter, total_values, page, page_size, has_more and values[] with value (what `search` takes), seo_name, name, and parent {value,name} for models.

**Example request body:**
```json
{
  "category": "osobni"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=sauto
- Human docs page: https://reefapi.com/docs/sauto
- Overview page: https://reefapi.com/sauto-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
