Search Aukro.cz Offers (Active & Archived)
aukro_search_offersSearch active or archived Aukro.cz marketplace offers by keyword, category, price, condition, seller, location, and curated feeds; use filters to find specific listings or check sold prices.
Instructions
Search active or completed/archived (finished: true) marketplace offers on Aukro.cz. Supports keyword search, category ID/SEO URL, price bounds, offer format (auction vs buy-now vs hot auction), item condition (NEW, USED, etc.), seller username/ID, shipping/payment filters, geolocation (postCode + distanceKm), dynamic category attribute filters, and curated feeds (ENDING_SOON, FROM_1_CZK, UP_TO_300_CZK, NEW_OFFERS, POPULAR, PRICE_HITS, CHARITY, OUTLET). Works anonymously without login.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "aukro_search_offers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 0-indexed page number (0 = first page) | |
| sort | No | Sorting field and direction | relevance:DESC |
| query | No | Search keyword or phrase (or numeric offer ID) | |
| queries | No | Multiple keyword query variants to execute in parallel and deduplicate by `itemId` (e.g. ['8GB', '8/128', '8/256', '12GB']) | |
| currency | No | Override response currency (defaults to CZK) | |
| finished | No | When true, searches completed/ended/archived listings (useful for checking historical sold prices) | |
| pageSize | No | Number of offers per page (1..180, default 20) | |
| postCode | No | Czech postal code (PSČ, e.g. '110 00') for radius distance filtering | |
| priceMax | No | Maximum price in selected currency | |
| priceMin | No | Minimum price in selected currency | |
| sellerId | No | Filter by numeric seller userId | |
| aukroPlus | No | Only Aukro+ offers | |
| offerType | No | Filter by listing type: ALL, AUCTION, BUY_NOW (Kup teď), or HOT_AUCTION (Žhavé aukce) | ALL |
| categoryId | No | Numeric category ID to filter by (from `aukro_get_categories`) | |
| conditions | No | Filter by item condition (Stav zboží) | |
| distanceKm | No | Maximum distance in kilometers from `postCode` | |
| sellerNames | No | Filter by one or more seller usernames (e.g. ['Alza_prodej']) | |
| specialFeed | No | Filter by curated Aukro special marketplace feed | |
| endingWithin | No | Relative time window before offer ends (e.g. '1h', '3h', '6h', '12h', '24h', '3d', '7d') | |
| excludeWords | No | Case-insensitive words/substrings to exclude from returned offer titles (e.g. ['iphone', 'lumia', 'kryt']) | |
| freeShipping | No | Only items with free shipping | |
| withShipping | No | When true, only returns offers that can be shipped (excludes personal-pickup-only listings) | |
| cashOnDelivery | No | Only items supporting cash on delivery (Dobírka) | |
| categorySeoUrl | No | Category SEO slug (e.g. 'mobilni-telefony-apple') | |
| personalPickup | No | Only items allowing personal pickup (Osobní převzetí) | |
| paymentViaAukro | No | Only items supporting secure Payment via Aukro (Platba přes Aukro / Buyer Protection) | |
| attributeFilters | No | Dynamic category parameter/attribute filters | |
| excludeCategoryIds | No | Leaf category IDs to exclude from results (e.g. [107152] to exclude iPhones) | |
| includeAggregations | No | When true, includes category and attribute facet aggregations in the response | |
| searchInDescription | No | When true, searches inside offer descriptions as well as titles | |
| destinationCountries | No | Shipping destination country codes (e.g. ['cz', 'sk']) | |
| priceDeliveryIncluded | No | When true, `priceMin` and `priceMax` are evaluated against the total price including shipping (`priceWithShipping`) |