# Vatera Scraper - Hungarian Marketplace & Auction Data (`studio-amba/vatera-scraper`) Actor

Extract listings from Vatera.hu, Hungary's largest online marketplace and auction site. Get titles, prices in HUF, seller info, condition, category, and images by keyword search. No login required.

- **URL**: https://apify.com/studio-amba/vatera-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

## Vatera Scraper - Hungarian Marketplace & Auction Data

Extract listings, prices, seller ratings, and images from [Vatera.hu](https://www.vatera.hu) — Hungary's largest online marketplace and auction site, combining fixed-price sales and bid-based auctions across electronics, fashion, collectibles, vehicles, home goods, and dozens more categories.

### How to scrape Vatera.hu data

Vatera Scraper collects structured listing data from Vatera.hu's search results by keyword. It reads the site's own tracking attributes embedded in each result card (product ID, price, category, seller type, listing type) so prices and categories are pulled from the same data Vatera itself uses for analytics, not fragile screen-scraped text. The scraper handles pagination automatically and filters by price range.

Vatera.hu is Hungary's equivalent of eBay — millions of active listings, a mix of private sellers and registered shops, and both "Fix" (fixed-price, buy-it-now) and auction-style listings with bid deadlines. All prices are in Hungarian Forints (HUF).

**No login or cookies required.**

**Popular use cases:**

- **Market research** — Track resale pricing for electronics, collectibles, and used goods across the Hungarian secondhand market.
- **Price comparison** — Compare fixed-price vs. auction pricing for the same item category.
- **Lead generation** — Find active sellers of specific products or categories in Hungary.
- **Academic research** — Study auction dynamics, seller reputation systems, and pricing behavior on a national marketplace.
- **Collectibles tracking** — Monitor stamps, coins, antiques, and other collector categories where Vatera is the dominant Hungarian venue.
- **Competitive intelligence** — Track how sellers price and describe products across Vatera's category tree.

### What data does Vatera Scraper extract?

Each listing includes:

- **itemTitle** — Title of the listing
- **price** — Listed price in HUF
- **currency** — Currency code (always HUF)
- **listingType** — `"fixed"` for buy-it-now listings, `"auction"` for bid-based listings
- **category** — Full category breadcrumb (e.g., Mobiltelefon / Mobiltelefonok / Apple iPhone)
- **condition** — Item condition (új = new, használt = used)
- **location** — Seller's region in Hungary
- **sellerName** — Seller's username
- **sellerRating** — Seller's positive rating count
- **sellerType** — Seller account type (e.g., premium\_seller, normal\_seller)
- **freeShipping** — Whether the listing includes free shipping
- **refurbished** — Whether the item is listed as refurbished
- **endDate** — Listing/auction end date
- **imageUrl** — Primary listing image URL
- **url** — Full listing URL on Vatera.hu
- **scrapedAt** — ISO 8601 timestamp of data extraction

### Input parameters

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `searchQuery` | String | `"iphone"` | Search keyword in Hungarian or product/brand name |
| `startUrls` | Array | — | Direct Vatera.hu search or listing URLs (overrides `searchQuery`) |
| `minPrice` | Integer | — | Minimum price filter in HUF |
| `maxPrice` | Integer | — | Maximum price filter in HUF |
| `maxResults` | Integer | `100` | Maximum listings to return (up to 2,000) |

#### Tips

- Use Hungarian search terms for best results: "laptop", "telefon" (phone), "bútor" (furniture), "kerékpár" (bicycle), "bélyeg" (stamps).
- Each search results page returns ~50 listings. For 500 results, the scraper paginates through 10 pages.
- `listingType` lets you split fixed-price and auction results in downstream analysis — categories like collectibles and antiques skew heavily toward auctions, while electronics skew toward fixed-price.
- Price filters use HUF. Typical ranges: phones 5,000–500,000 HUF, collectibles 500–50,000 HUF, vehicles 500,000–5,000,000 HUF.

### Output

Here is realistic example output from Vatera.hu:

```json
[
  {
    "itemTitle": "iPhone 15 Black 128GB AKCIÓ !",
    "price": 149990,
    "currency": "HUF",
    "listingType": "fixed",
    "category": "Mobiltelefon, vezetékes készülék/Mobiltelefonok/Apple iPhone mobiltelefonok/Apple iPhone 15",
    "condition": "új",
    "location": "Szabolcs-Szatmár-Bereg megye",
    "sellerName": "vaterjanos73",
    "sellerRating": 503,
    "sellerType": "premium_seller",
    "freeShipping": false,
    "refurbished": false,
    "endDate": "2026/09/06 18:41:51",
    "imageUrl": "https://images.vatera.hu/listings/95/2a/0ffc_/iphone-15-black-128gb-akcio-3488653913_1.jpg",
    "url": "https://www.vatera.hu/iphone-15-black-128gb-akcio-3488653913.html",
    "scrapedAt": "2026-08-23T14:14:16.952Z"
  },
  {
    "itemTitle": "Iphone xr alkatrésznek",
    "price": 15000,
    "currency": "HUF",
    "listingType": "fixed",
    "category": "Mobiltelefon, vezetékes készülék/Mobiltelefonok/Apple iPhone mobiltelefonok/Apple iPhone X, XS, XR",
    "condition": "használt",
    "location": "Baranya megye",
    "sellerName": "Hunyadigsm",
    "sellerRating": 518,
    "sellerType": "normal_seller",
    "freeShipping": false,
    "refurbished": false,
    "endDate": "2026/09/02 00:41:09",
    "imageUrl": "https://images.vatera.hu/listings/ed/54/3fbc_/iphone-xr-alkatresznek-3421717982_18.jpg",
    "url": "https://www.vatera.hu/iphone-xr-alkatresznek-3421717982.html",
    "scrapedAt": "2026-08-23T14:14:17.101Z"
  }
]
```

### How much does it cost?

Vatera Scraper fetches search-result pages directly (no browser rendering), so cost is driven by result volume, not compute time. This is a per-result cost estimate — you pay per scraped item, not per minute.

| Scenario | Listings | Estimated cost | Time |
|----------|----------|---------------|------|
| Quick search | 15 | ~$0.03 | ~15 sec |
| Standard search | 100 | ~$0.15 | ~1 min |
| Large search | 500 | ~$0.65 | ~5 min |
| Bulk extraction | 2,000 | ~$2.50 | ~20 min |

Usage cost only settles once a run reports **SUCCEEDED** — reading the dataset while a run is still in progress will undercount what you'll actually be charged.

### Can I integrate?

Vatera Scraper connects to the full Apify integration ecosystem:

- **Apify API** — Trigger runs programmatically, stream results in real-time
- **Webhooks** — Notify your systems when scraping completes
- **Google Sheets** — Auto-export Vatera listings for team review
- **Zapier / Make** — Build no-code automations triggered by new listings
- **Scheduled runs** — Set up daily monitoring with Apify Schedules
- **Direct download** — CSV, JSON, XML, or Excel export from the Apify Console

### Can I use it as an API?

Use Vatera Scraper as a Hungarian marketplace API. Start runs, poll for results, and process data in your application.

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("studio-amba/vatera-scraper").call(run_input={
    "searchQuery": "laptop",
    "maxResults": 100,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['itemTitle']} - {item['price']} HUF ({item.get('listingType', '')})")
```

#### JavaScript

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

const client = new ApifyClient({ token: "YOUR_API_TOKEN" });

const run = await client.actor("studio-amba/vatera-scraper").call({
  searchQuery: "bélyeg",
  maxResults: 200,
  maxPrice: 50000,
});

const { items } = await client
  .dataset(run.defaultDatasetId)
  .listItems();

items.forEach((item) => {
  console.log(`${item.itemTitle} - ${item.price} HUF (${item.listingType})`);
});
```

### FAQ

#### What is Vatera.hu?

Vatera.hu is Hungary's largest online marketplace and auction site, similar to eBay or Allegro. It combines fixed-price "Fix" listings with traditional bid-based auctions, used by both private sellers and registered shops across every product category.

#### What's the difference between "fixed" and "auction" listings?

`listingType: "fixed"` means the item can be bought immediately at the listed price. `listingType: "auction"` means the price shown is the current bid and the final price depends on bidding activity until the `endDate`. Collectibles categories (stamps, coins, antiques) have a much higher share of auction listings than electronics.

#### Can I filter by price?

Yes, use `minPrice` and `maxPrice` in HUF. Listings without a resolvable price are excluded from price-filtered runs.

#### Does this scraper handle anti-bot protection?

Vatera.hu is protected by Cloudflare. The scraper routes requests through a managed unlocking service to reliably bypass this without needing your own proxy or browser setup.

### Limitations

- **Phone numbers** — Seller contact details are not shown on search result pages and are not extracted.
- **Full descriptions** — Search result pages show titles and structured data only; full listing descriptions require visiting individual listing pages.
- **Bid history** — Individual bid amounts and bidder counts for auction listings are not extracted, only the current price and end date.
- **Rate limiting** — Very large runs (2,000+ listings) should use moderate `maxResults` per run to stay reliable.

### Other European classifieds & marketplace scrapers

Build a complete view of European secondhand and auction markets:

- **[Jofogas Scraper](https://apify.com/studio-amba/jofogas-scraper)** — Hungary's general classifieds marketplace
- **[OLX Scraper](https://apify.com/studio-amba/olx-scraper)** — Poland
- **[Bazos Scraper](https://apify.com/studio-amba/bazos-scraper)** — Czech Republic and Slovakia
- **[2dehands Scraper](https://apify.com/studio-amba/2dehands-scraper)** — Belgium and Netherlands
- **[Willhaben Scraper](https://apify.com/studio-amba/willhaben-scraper)** — Austria
- Check the [Apify Store](https://apify.com/store) for more European classifieds and marketplace scrapers from Studio AMBA.

### Your feedback

If you notice any data quality issues, missing fields, or broken runs, let us know through the Apify Console. We actively monitor and update this scraper to ensure reliable operation on Vatera.hu.

# Actor input Schema

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

Search keyword in Hungarian or brand/model name, e.g., "iphone", "laptop", "kerékpár" (bicycle), "bútor" (furniture). Defaults to "iphone" if empty.

## `startUrls` (type: `array`):

Vatera.hu search result pages (listings/index.php?q=...) or individual listing URLs. Overrides searchQuery if provided.

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

Only return listings priced at or above this amount in Hungarian Forints.

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

Only return listings priced at or below this amount in Hungarian Forints.

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

Maximum number of listings to scrape. Each search results page has ~50 listings.

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

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

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

Legacy field, kept for backwards compatibility. Fetching now goes through the built-in Bright Data Web Unlocker, so this is ignored.

## Actor input object example

```json
{
  "searchQuery": "iphone",
  "startUrls": [
    {
      "url": "https://www.vatera.hu/listings/index.php?q=iphone&view=list"
    }
  ],
  "maxResults": 20,
  "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",
    "startUrls": [
        {
            "url": "https://www.vatera.hu/listings/index.php?q=iphone&view=list"
        }
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/vatera-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",
    "startUrls": [{ "url": "https://www.vatera.hu/listings/index.php?q=iphone&view=list" }],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/vatera-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",
  "startUrls": [
    {
      "url": "https://www.vatera.hu/listings/index.php?q=iphone&view=list"
    }
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call studio-amba/vatera-scraper --silent --output-dataset

```

## MCP server setup

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