# Aukro.cz Scraper - Czech Marketplace Listings and Prices (`studio-amba/aukro-scraper`) Actor

Scrape listings from aukro.cz, the largest Czech online marketplace. Get title, price, shipping, condition, brand, category, seller and auction end time for auctions and fixed-price listings.

- **URL**: https://apify.com/studio-amba/aukro-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 92.9% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Aukro.cz Scraper

Pull listings from aukro.cz, the largest Czech online marketplace. The actor returns one row per listing with the current price in CZK, price including shipping, buy-now price, retail price, condition, brand, category path, seller location, seller feedback and the end time of the auction. It covers auctions and fixed-price listings, new and used goods, from private sellers and companies.

Aukro sells phones, electronics, cars and parts, clothing, home goods, collectibles, books, toys and sports gear. Rows can be used to follow second-hand prices in the Czech Republic, to find listings below market value, or to watch a category for new offers.

### How to scrape Aukro.cz data

There are two ways to tell the actor what to read. They can be combined.

1. Set `searchQuery` to search words, for example `iphone 13` or `horské kolo`. The actor reads every listing that matches.
2. Set `categories` to category page addresses, for example `mobilni-telefony` or `https://aukro.cz/mobilni-telefony`. The address is the last part of the category page's web address on aukro.cz. Several categories can be given.

With both empty, the actor reads all of aukro.cz, starting from the top-level categories. Set `listingType` to `auction` or `buyNow` to read only auctions or only fixed-price listings.

The actor stops at `maxResults`. A listing is returned once, even when it matches more than one category.

The site returns at most 10,000 results for one query. When a query is larger than that, the actor splits it on the child categories and reads each one. A search with very broad words and no category can still be cut off, so combine broad words with a category.

The actor uses the listing data that the aukro.cz pages themselves load. It does not log in, bid, or open the cart.

### Input

| Field | Type | Description |
|---|---|---|
| `searchQuery` | text | Search words |
| `categories` | list | Category page addresses |
| `listingType` | choice | All listings, auctions, or buy now |
| `maxResults` | number | Maximum number of rows (default 50) |
| `proxyConfiguration` | proxy | Apify Residential, Czech Republic, by default |

### What you get back

| Field | Description |
|---|---|
| `itemId` | Aukro listing number |
| `name` | Listing title |
| `url` | Listing page address |
| `listingType` | `auction`, `auctionWithBuyNow` or `buyNow` |
| `price` | Current price in CZK: highest bid for an auction, asking price otherwise |
| `priceWithShipping` | Price plus the cheapest shipping option |
| `buyNowPrice` | Buy-now price on an auction that has one |
| `retailPrice` | Original retail price given by the seller |
| `currency` | CZK |
| `condition` | Condition text from the listing |
| `brand` | Brand attribute, when the seller filled it in |
| `attributes` | All listing attributes as name and value |
| `category`, `categoryPath`, `categorySlug` | Lowest category, the path above it, and its page address |
| `quantity` | Pieces on offer |
| `freeShipping`, `personalPickup` | Delivery options |
| `location`, `postcode` | Seller location |
| `startsAt`, `endsAt` | Listing start and end time |
| `watchers` | Users watching the listing |
| `imageUrl` | Main image |
| `sellerName`, `sellerIsCompany` | Seller login and whether it is a company account |
| `sellerPositiveFeedback`, `sellerFeedbackCount` | Share of positive feedback in percent, and the number of users who gave feedback |
| `scrapedAt` | Time of the read |
| `country` | CZ |

Fields the listing does not show are empty.

### Example output

```json
{
  "itemId": "7140688133",
  "name": "IPhone 11 Pro",
  "url": "https://aukro.cz/iphone-11-pro-7140688133",
  "listingType": "auction",
  "price": 524,
  "priceWithShipping": 593,
  "currency": "CZK",
  "condition": "Nefunkční / na díly",
  "brand": "Apple",
  "category": "iPhone",
  "categoryPath": ["Mobily a chytrá elektronika", "Mobilní telefony", "iPhone"],
  "location": "Praha",
  "endsAt": "2026-11-11T14:09:43+01:00",
  "watchers": 16,
  "sellerName": "oksanah6",
  "sellerPositiveFeedback": 96.3,
  "country": "CZ"
}
```

### Use cases

- Follow second-hand prices for phones, laptops, cars or any other category in the Czech Republic.
- Find auctions that end soon with a low current bid.
- Compare the price of the same product on aukro.cz and on Czech shops.
- Watch a category for new listings by running the actor on a schedule.
- Build a dataset of Czech marketplace listings with seller and location data.

### Cost and speed

The actor reads 100 listings per request and needs no browser. The site refuses datacenter addresses, so every request goes through a Czech residential proxy. One thousand listings take about 20 seconds. Pricing is per result, see the pricing box on this page. The usage cost of a run only settles after the run reports SUCCEEDED, so a cost checked during the run is too low.

### Notes and limits

- The default proxy is Apify Residential in the Czech Republic. Leave it on the default, other proxy types are refused by the site.
- Prices are in CZK including VAT where the seller charges it.
- For an auction, `price` is the current highest bid and changes until the auction ends. `endsAt` gives the end time.
- A query is limited to 10,000 results by the site. The actor splits larger queries on child categories.
- Some common search words make aukro.cz jump to a category or topic page, for example `kolo` leads to the bicycle category. The actor reads the page the site jumps to.
- A search that matches nothing ends the run as SUCCEEDED with no rows.
- The actor reads publicly visible data only. It does not log in.
- You are responsible for how you use the data. Check the site's terms and the rules that apply to your use case.

### Frequently asked questions

#### Does it return auctions and fixed-price listings?

Yes, both. `listingType` shows which kind each row is, and the input field of the same name selects one kind.

#### Can I search by keyword?

Yes, with `searchQuery`. Combine it with `categories` to narrow the result.

#### How do I find a category address?

Open the category on aukro.cz. The address is the last part of the web address, for example `mobilni-telefony` in `https://aukro.cz/mobilni-telefony`.

#### Does the price include shipping?

`price` does not. `priceWithShipping` is the price plus the cheapest shipping option.

#### How often can I run it?

As often as you like. Runs on a schedule on the same category give a price history.

### Related scrapers

- [Marktplaats.nl Scraper](https://apify.com/studio-amba/marktplaats-scraper) for Dutch classifieds
- [Kaufland.cz Scraper](https://apify.com/studio-amba/kaufland-cz-scraper) for Czech marketplace prices
- [Datart.cz Scraper](https://apify.com/studio-amba/datart-scraper) for Czech electronics prices

# Actor input Schema

## `searchQuery` (type: `string`):

Words to search for in listing titles and descriptions, for example iphone 13 or horské kolo. Leave empty to read whole categories.

## `categories` (type: `array`):

Category page addresses from aukro.cz, for example mobilni-telefony or https://aukro.cz/mobilni-telefony. Several can be given. Leave empty to search every category.

## `listingType` (type: `string`):

Read all listings, only auctions, or only fixed-price (buy now) listings.

## `maxResults` (type: `integer`):

Maximum number of rows (one row per listing).

## `proxyConfiguration` (type: `object`):

The site refuses datacenter addresses, so the actor uses a Czech residential address. Leave the default.

## Actor input object example

```json
{
  "searchQuery": "iphone 13",
  "listingType": "all",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CZ"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "iphone 13",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "CZ"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/aukro-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "iphone 13",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "CZ",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/aukro-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "iphone 13",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "CZ"
  }
}' |
apify call studio-amba/aukro-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/aukro-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/7bX5leLzFZjqdwnRE/builds/hrqkf1KvDfze4YtLS/openapi.json
