# Osta.ee Scraper - Estonian Classifieds & Auctions (`studio-amba/osta-ee-scraper`) Actor

Scrape classified listings and auctions from Osta.ee, Estonia's general classifieds and online auction marketplace. Extract titles, prices, buy-now prices, conditions, sellers, and images by keyword or category. No login or cookies required.

- **URL**: https://apify.com/studio-amba/osta-ee-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Osta.ee Scraper

Scrape classified listings and auctions from [Osta.ee](https://www.osta.ee), Estonia's general classifieds and online auction marketplace, by keyword or category.

### Why use this actor?

Osta.ee mixes fixed-price listings with eBay-style auctions across everything from phones and electronics to antiques, tools, and real estate. This actor lets you pull structured listing data — titles, prices, buy-now prices, bid counts, conditions, sellers, and images — without writing scraping code or logging in. Useful for price monitoring, market research on the Estonian secondhand and auction market, or feeding listings into your own search/alert tool.

### How to scrape Osta.ee data

1. Enter a `searchQuery` (e.g. `"iphone"`), a `categorySlug` (e.g. `"telefonid"`), or both.
2. Optionally narrow with `minPrice`, `maxPrice`, or `buyNowOnly`.
3. Set `maxResults` for how many listings you want.
4. Run the actor. Results stream into the dataset as they're found, so you can start using data before the run finishes.
5. Export the dataset as JSON, CSV, or Excel, or pull it via the Apify API.

No account, login, or cookies are required — this reads the public Osta.ee listing and category pages.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | Keyword to search for (e.g. `"iphone"`, `"jalgratas"`, `"diivan"`). Leave empty to browse a whole category. |
| `categorySlug` | String | No | One of Osta.ee's top-level categories (e.g. `"telefonid"`, `"arvutid"`, `"sport"`, `"automoto"`, `"kinnisvara"`). Combine with `searchQuery` to search within a category. |
| `minPrice` | Integer | No | Minimum price in EUR. |
| `maxPrice` | Integer | No | Maximum price in EUR. |
| `buyNowOnly` | Boolean | No | Only return listings with an instant buy-now (OstaKohe) price, skipping bid-only auctions. Default: `false`. |
| `maxResults` | Integer | No | Maximum number of listings to return. Default: `100`. |
| `scrapeDetails` | Boolean | No | OFF by default. When enabled, fetches each listing's detail page for its full category breadcrumb, seller feedback count/trust score, full description, and full image gallery — roughly doubles run time and cost. |
| `brightDataApiKey` | String | No | Optional: bring your own Bright Data Web Unlocker key. The built-in key is used if left empty. |

If you leave every field empty, the actor defaults to searching `"telefon"` in the `"telefonid"` category so a bare run always returns data.

### Output

Each result contains:

| Field | Type | Example |
|-------|------|---------|
| `listingId` | String | `"257583484"` |
| `listingTitle` | String | `"360-kraadilise pöördenurgaga telefoni hoidja armatuurlauale"` |
| `price` | Number | `1.5` |
| `currency` | String | `"EUR"` |
| `buyNowPrice` | Number | null | `19.99` |
| `isAuction` | Boolean | `true` |
| `bidCount` | Number | null | `1` |
| `condition` | String | null | `"Uus"` |
| `category` | String | null | `"Telefonid"` |
| `categorySlug` | String | null | `"telefonid"` |
| `categoryPath` | Array | null | `["Telefonid", "Mobiiltelefonide tarvikud"]` (detail mode only) |
| `sellerName` | String | null | `"mihhail-b"` |
| `sellerFeedbackCount` | Number | null | `28` (detail mode only) |
| `sellerTrustPercent` | Number | null | `100` (detail mode only) |
| `location` | String | null | `null` — rarely exposed by the site |
| `endsAtRaw` | String | null | `"Pühapäev 14:30"` (raw weekday+time, only for auctions ending soon) |
| `description` | String | null | Full text (detail mode only) |
| `imageUrl` | String | null | Primary listing image URL |
| `imageUrls` | Array | null | Full gallery (detail mode only) |
| `url` | String | Full listing URL |
| `scrapedAt` | String | ISO 8601 timestamp |
| `searchQuery` | String | null | Input echo |

### Example output

```json
{
    "listingId": "257583484",
    "listingTitle": "360-kraadilise pöördenurgaga telefoni hoidja armatuurlauale",
    "price": 1.5,
    "currency": "EUR",
    "buyNowPrice": 19.99,
    "isAuction": true,
    "bidCount": 1,
    "condition": "Uus",
    "category": "Telefonid",
    "categorySlug": "telefonid",
    "sellerName": "mihhail-b",
    "endsAtRaw": "Pühapäev 14:30",
    "imageUrl": "https://img-osta.ee/item/5/3138/133103138.avif",
    "url": "https://www.osta.ee/360-kraadilise-poordenurgaga-telefoni-hoidja-armatuurlauale-257583484.html",
    "scrapedAt": "2026-09-07T09:15:00.000Z",
    "searchQuery": "telefon"
}
```

### Price field: current bid vs. buy-now

Osta.ee runs both auctions and fixed-price listings side by side. `price` is always the current price a buyer would pay right now: the current bid on an auction, or the fixed price on a plain listing. When a seller also allows skipping the bidding entirely, that instant price shows up separately in `buyNowPrice`. Use `isAuction` and `bidCount` to tell the two listing types apart.

### Cost estimate

This actor uses Bright Data's Web Unlocker to get past Osta.ee's Cloudflare protection, but each request returns a full page of up to 120 listings, so the per-result cost stays low — roughly **1 request per 120 results** in list-only mode (the default). Enabling `scrapeDetails` adds one request per listing and roughly doubles the run's Bright Data usage in exchange for richer category, seller, and description data.

### Limitations

- A run's usage cost only settles after it reports SUCCEEDED — reading the dataset mid-run shows a cost far below the final total, so don't estimate spend from an in-progress run.
- Osta.ee rarely exposes a per-listing pickup location, so `location` is usually `null`.
- The site shows auction end times only as a relative weekday+time string for auctions ending soon (e.g. "Pühapäev 14:30"), not a full date — `endsAtRaw` is passed through as-is.
- Full category breadcrumb, seller feedback/trust score, description, and image gallery require `scrapeDetails: true`.
- Data is scraped from the public website and may change without notice.
- Respect Osta.ee's terms of service and use responsibly.

### Maintained by Studio Amba

We run 700+ scrapers for European websites, and the priority is keeping
every one of them working. Automated runs test this actor against the live
site and verify the output is complete. When the website changes, the
scraper usually gets repaired the same day, without you having to report
anything. Questions and issues go straight to the people who built it, and
most get an answer the same day.

### Need this data on a schedule, or a custom version?

We run this scraper as a managed service for businesses: scheduled runs,
deduplication, delta detection, and delivery to your inbox, Google Sheets,
or API, maintenance included. We can also build a custom version with your
exact fields and filters, or combine multiple sources into one feed.

See [studioamba.dev/services](https://studioamba.dev/services/) or email
<hello@studioamba.dev> for a free data sample.

### Related scrapers

- [okidoki-ee-scraper](https://apify.com/studio-amba/okidoki-ee-scraper) — Estonia's other general classifieds marketplace
- [kaup24-ee-scraper](https://apify.com/studio-amba/kaup24-ee-scraper) — Estonian online marketplace and e-shop
- [olx-scraper](https://apify.com/studio-amba/olx-scraper) — Poland's largest classifieds platform
- [blocket-scraper](https://apify.com/studio-amba/blocket-scraper) — Sweden's largest classifieds platform
- [finn-no-scraper](https://apify.com/studio-amba/finn-no-scraper) — Norway's largest classifieds platform

# Actor input Schema

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

Search for listings by keyword on Osta.ee (e.g., 'iphone', 'jalgratas', 'diivan'). Leave empty to browse a whole category via categorySlug instead.

## `categorySlug` (type: `string`):

Restrict results to one of Osta.ee's top-level categories (e.g. 'telefonid', 'arvutid', 'sport', 'automoto', 'kinnisvara'). Combine with searchQuery to search within a category. Leave empty to search all categories.

## `minPrice` (type: `integer`):

Filter: minimum price in EUR.

## `maxPrice` (type: `integer`):

Filter: maximum price in EUR.

## `buyNowOnly` (type: `boolean`):

Only return listings that can be bought instantly (OstaKohe), skipping pure bid-only auctions.

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

Maximum number of listings to return.

## `scrapeDetails` (type: `boolean`):

OFF by default. When enabled, fetches each listing's detail page for its full category breadcrumb, seller feedback count/trust score, full description, and full image gallery — at the cost of one extra request per result (roughly doubles run time and Bright Data usage). When OFF, category is still populated whenever you set categorySlug, and title/price/condition/images/seller name still come from the listing page.

## `brightDataApiKey` (type: `string`):

Optional: your own Bright Data Web Unlocker API key. Leave empty to use the built-in key.

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

Kept for compatibility — requests are routed through Bright Data Web Unlocker to bypass osta.ee's Cloudflare protection, so Apify proxies are not used.

## Actor input object example

```json
{
  "searchQuery": "iphone",
  "categorySlug": "telefonid",
  "buyNowOnly": false,
  "maxResults": 20,
  "scrapeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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",
    "categorySlug": "telefonid",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/osta-ee-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",
    "categorySlug": "telefonid",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/osta-ee-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",
  "categorySlug": "telefonid",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call studio-amba/osta-ee-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/osta-ee-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/g0jkPDSyjbBJHQxMy/builds/ZKFQIXjrVbmwNWyLf/openapi.json