Sauto.cz API & Scraper
Sauto.cz API returns live Sauto.cz data as clean JSON for sauto.cz The primary endpoint, search, returns category, total_results, page, page_size, has_more, next_page, applied (the filters Sauto actually honoured) and listings[] with id, url,….
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Sauto.cz scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, listing, filters. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/sauto/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"category": "osobni"
}
}{
"ok": true,
"meta": {
"api": "sauto",
"endpoint": "search",
"mode": "live",
"latency_ms": 1198.2,
"record_count": 20,
"bytes": 35183,
"cache_hit": false,
"source_url": "https://www.sauto.cz/api/v1/items/search?category_id=838&limit=20&offset=0",
"promoted_count": 5,
"priced_count": 20,
"filters_verified": null,
"next_page": 2,
"max_reachable_page": 500,
"offset_ceiling": 10000,
"charged_credits": 1,
"version": "1.0.1",
"request_id": "170dc345a848474b",
"queue_ms": 1.6,
"fetched_at": "2026-11-03T17:32:12.153Z"
},
"data": {
"category": "osobni",
"category_id": 838,
"currency": "CZK",
"total_results": 109368,
"page": 1,
"page_size": 20,
"has_more": true,
"listings": [
{
"id": 211314156,
"url": "https://www.sauto.cz/osobni/detail/skoda/fabia/211314156",
"title": "Škoda Fabia, 1.2 TSI 66 kW Ambition",
"variant": "1.2 TSI 66 kW Ambition",
"make": {
"value": 93,
"name": "Škoda",
"seo_name": "skoda"
},
"model": {
"value": 707,
"name": "Fabia",
"seo_name": "fabia"
},
"category": {
"value": null,
"name": "Osobní",
"seo_name": "osobni"
},
"price": 159900,
"price_currency": "CZK",
"price_kind": "fixed",
"mileage_km": 142000,
"fuel": {
"value": 1,
"name": "Benzín",
"seo_name": "benzin"
},
"gearbox": {
"value": 1,
"name": "Manuální",
"seo_name": "manualni"
},
"manufacturing_date": "2016-09-01",
"in_operation_date": null,
"locality": {
"region": "Pardubický kraj",
"region_id": 7,
"region_seo_name": "pardubicky-kraj",
"district": "Pardubice",
"district_id": 32,
"district_seo_name": "pardubice",
"municipality": "Pardubice",
"municipality_id": 1258,
"zip": null,
"country_id": 112
},
"dealer": null,
"seller_type": "private",
"user": {
"id": 9087385
},
"image": "https://d19-a.sdn.cz/d_19/c_img_qG_B/nPQ64TBsMvD902hFuZIIdVsp/fca7.jpeg",
"image_count": 17,
"promoted": false,
"home_delivery": null,
"cebia_verified": false,
"dealer_reference": null,
"created_at": "2026-10-20T21:13:51",
"updated_at": "2026-11-03T18:31:40"
},
{
"id": 211387749,
"url": "https://www.sauto.cz/osobni/detail/ford/galaxy/211387749",
"title": "Ford Galaxy, 1,9tdi padá nafta delší start",
"variant": "1,9tdi padá nafta delší start",
"make": {
"value": 24,
"name": "Ford",
"seo_name": "ford"
},
"model": {
"value": 196,
"name": "Galaxy",
"seo_name": "galaxy"
},
"category": {
"value": null,
"name": "Osobní",
"seo_name": "osobni"
},
"price": 19000,
"price_currency": "CZK",
"price_kind": "fixed",
"mileage_km": 399000,
"fuel": {
"value": 2,
"name": "Nafta",
"seo_name": "nafta"
},
"gearbox": {
"value": 1,
"name": "Manuální",
"seo_name": "manualni"
},
"manufacturing_date": null,
"in_operation_date": "2004-06-01",
"locality": {
"region": "Hlavní město Praha",
"region_id": 10,
"region_seo_name": "hlavni-mesto-praha",
"district": "Hlavní město Praha",
"district_id": 47,
"district_seo_name": "hlavni-mesto-praha",
"municipality": null,
"municipality_id": null,
"zip": null,
"country_id": 112
},
"dealer": {
"id": 13073994,
"name": "Autobazar Motol",
"seo_name": "autobazar-motol",
"logo": "https://d48-a.sdn.cz/d_48/c_img_oc_A/kcukOQcMmCfTdKZAD6UBQP/b32a.png",
"url": "https://www.sauto.cz/bazar/autobazar-motol/13073994",
"phones": null,
"emails": null,
"web": null
},
"seller_type": "dealer",
"user": null,
"image": "https://d19-a.sdn.cz/d_19/c_img_qH_A/nQO0xPd86TDhsIbH4jtIQmK7e/bf74.jpeg",
"image_count": 5,
"promoted": false,
"home_delivery": false,
"cebia_verified": false,
"dealer_reference": "00237809-EBM",
"created_at": "2026-11-03T18:30:25",
"updated_at": "2026-11-03T18:30:27"
},
{
"id": 211305453,
"url": "https://www.sauto.cz/osobni/detail/skoda/scala/211305453",
"title": "Škoda Scala",
"variant": null,
"make": {
"value": 93,
"name": "Škoda",
"seo_name": "skoda"
},
"model": {
"value": 8155,
"name": "Scala",
"seo_name": "scala"
},
"category": {
"value": null,
"name": "Osobní",
"seo_name": "osobni"
},
"price": 249000,
"price_currency": "CZK",
"price_kind": "fixed",
"mileage_km": 49560,
"fuel": {
"value": 6,
"name": "CNG + benzín",
"seo_name": "cng-benzin"
},
"gearbox": null,
"manufacturing_date": "2020-08-01",
"in_operation_date": "2020-09-01",
"locality": {
"region": "Hlavní město Praha",
"region_id": 10,
"region_seo_name": "hlavni-mesto-praha",
"district": "Hlavní město Praha",
"district_id": 47,
"district_seo_name": "hlavni-mesto-praha",
"municipality": "Praha",
"municipality_id": 3468,
"zip": null,
"country_id": 112
},
"dealer": null,
"seller_type": "private",
"user": {
"id": 72245635
},
"image": "https://d19-a.sdn.cz/d_19/c_img_qG_B/kPw320bnC5Dv66YlgIHyc3k/1727.jpeg",
"image_count": 7,
"promoted": false,
"home_delivery": null,
"cebia_verified": false,
"dealer_reference": null,
"created_at": "2026-10-19T18:03:30",
"updated_at": "2026-11-03T18:30:22"
}
],
"applied": {
"category": "osobni",
"sort": "newest",
"page": 1,
"page_size": 20
}
}
}What the Sauto.cz API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | 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`. | Price-intelligence teams call search to search Sauto listings. | category, query, make, model, condition, ... |
| listing | 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. | Classifieds aggregators call listing to get the full detail document of one Sauto ad. | id, url |
| filters | 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. | Resale and arbitrage tools call filters to get the resolver for `search`. | category, filter, make, page, page_size |
Call search from your stack
curl -X POST https://api.reefapi.com/sauto/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"category":"osobni"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/sauto/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"category": "osobni"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/sauto/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"category": "osobni"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.sauto.search with {"category":"osobni"}.Who uses this API and why
- Price-intelligence teams use Sauto.cz to search Sauto listings.
- Classifieds aggregators use Sauto.cz to get the full detail document of one Sauto ad.
- Resale and arbitrage tools use Sauto.cz to get the resolver for `search`.
Questions developers ask before integrating
What is the Sauto.cz API?
Sauto.cz API is a ReefAPI endpoint group for sauto.cz It returns live JSON through POST requests under /sauto/v1.
Is the Sauto.cz API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Sauto.cz calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Sauto.cz login or account?
No login to Sauto.cz is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Sauto.cz data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Sauto.cz API use?
Sauto.cz actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Sauto.cz from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call sauto actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Sauto.cz API a Sauto.cz scraper?
It is the managed alternative to a DIY Sauto.cz scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same sauto.cz back as clean JSON.
Why does my Sauto.cz scraper keep getting blocked?
Most Sauto.cz scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.