bazos.cz APIbazos.cz ↗
Access Bazos.cz listings via API. Search across all sections, retrieve full listing details, and browse categories with keyword, location, and price filters.
curl -X GET 'https://api.parse.bot/scraper/7648a460-48bb-464a-a075-dcc31f713941/search_listings?query=mobil§ion=www' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for listings across different sections (www, prace, sluzby, auto, reality, etc.) of bazos.cz with various filters. Returns paginated results.
| Param | Type | Description |
|---|---|---|
| query | string | Search query text (e.g. 'mobil', 'řidič') |
| offset | integer | Pagination offset |
| radius | string | Search radius in km from location |
| section | string | Site section/subdomain. Accepted values: www, prace, sluzby, reality, auto, deti, dum, zvirata, stroje, moto, hudba, vstupenky, knihy, nabytek, sport, ostatni, pc, mobily, foto, elektro, obleceni. |
| location | string | Location filter (e.g. 'Praha', 'Praha 4') |
| max_price | string | Maximum price filter |
| min_price | string | Minimum price filter |
{
"type": "object",
"fields": {
"count": "integer, number of listings returned",
"offset": "integer, current pagination offset",
"section": "string, the section searched",
"listings": "array of listing objects, each with id, title, link, price, description_snippet, location, date_posted, views"
},
"sample": {
"data": {
"count": 20,
"offset": 0,
"section": "www",
"listings": [
{
"id": "218312213",
"link": "https://auto.bazos.cz/inzerat/218312213/skoda-superb-3-lk-20-tdi-110kw-dsg-zaruka-autodraft.php",
"price": "529 000 Kč",
"title": "Škoda Superb 3 L&K 2.0 TDI 110kW DSG",
"views": "1542 x",
"location": "Praha 10 101 00",
"date_posted": "3.5. 2026",
"description_snippet": "Škoda Superb 3 Combi Laurin & Klement..."
}
]
},
"status": "success"
}
}About the bazos.cz API
The Bazos.cz API provides 3 endpoints for accessing the Czech classifieds marketplace, covering listings across sections like auto, reality, prace, sluzby, and more. Use search_listings to query across any subdomain with keyword, location, price range, and pagination controls. Each listing result returns fields including title, price, location, date_posted, and view count, while get_listing_detail delivers the full description, contact name, images, and phone numbers found in the listing text.
Search Listings
The search_listings endpoint queries listings across Bazos.cz's section subdomains: www, prace (jobs), sluzby (services), auto (vehicles), reality (real estate), deti, dum, zvirata, stroje, and moto. You can supply a query string alongside optional filters for location (e.g. Praha, Praha 4), radius in km, min_price, max_price, and a pagination offset. Results include a count of returned listings and an array of listing objects, each carrying id, title, link, price, description_snippet, location, date_posted, and views.
Listing Detail
get_listing_detail accepts the full URL of any individual listing and returns the complete record: title, description (full text), price, location with postal code, views, contact_name, an images array of URL strings, and a phones_in_description array of phone numbers parsed from the listing body. Prices may appear as a numeric string or the Czech convention Dohodou (negotiable).
Categories
get_categories accepts a section subdomain and returns a list of category objects, each with a name and url. Passing www returns top-level site links rather than a meaningful category tree; use specific subdomains like auto, prace, or reality to retrieve actionable category listings. This is useful for building navigation or scoping subsequent search_listings calls to a particular category URL.
- Monitor Czech used-car listings across the
autosection with price and location filters - Aggregate rental and property listings from the
realitysection filtered by city - Track job postings under the
pracesection with keyword search for specific roles - Extract seller contact names and phone numbers from individual listing detail pages
- Build a price-comparison tool by querying the same keyword across multiple sections
- Index available service categories in
sluzbyfor directory or recommendation apps - Watch listing view counts over time to gauge demand for specific goods in Czech classifieds
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Bazos.cz offer an official developer API?+
What does get_listing_detail return beyond what search_listings provides?+
search_listings returns a description_snippet per listing, whereas get_listing_detail returns the full description text, the complete images array, the contact_name, and any phones_in_description extracted from the body. It also resolves the location field to include a postal code, and returns the listing's views count.Are there any quirks with the `get_categories` endpoint and the `www` section?+
section=www returns top-level site navigation links rather than a structured category list. To get a useful category tree, use a specific subdomain value such as auto, prace, sluzby, reality, or dum. The endpoint documentation explicitly calls this out as the recommended approach.Does the API expose seller profile pages or historical listing data for a given user?+
Can I retrieve listings from a specific category URL rather than a free-text query?+
search_listings endpoint does not currently accept a category URL as an input parameter. It filters by section, query, location, radius, and price range. You can use get_categories to retrieve category URLs for a section, then fork the API on Parse and revise search_listings to accept a category path as an additional filter.