# Allegro.hu Scraper: Category Sizes, Reviews & Offer Checks (`extractify-labs/allegro-hu-scraper`) Actor

Get Allegro.hu market data no one else offers: how many offers every category holds, filter breakdowns by condition, price and ships-from, complete product reviews, and a live check for the offers you track. Unofficial, not affiliated with Allegro.

- **URL**: https://apify.com/extractify-labs/allegro-hu-scraper.md
- **Developed by:** [Extractify Labs](https://apify.com/extractify-labs) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.25 / 1,000 results

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

## Allegro.hu Scraper: Category Sizes, Reviews & Offer Checks

> Unofficial tool. Not affiliated with, endorsed by, or sponsored by Allegro.

### What it does

Allegro.hu is Allegro's Hungarian marketplace, with tens of millions of offers priced in HUF. This actor
gives you three kinds of data from it:

1. **Market data**: for any category, keyword or seller, how many offers exist, how they split by
   condition, price band and ships-from country, and which subcategories hold them. It is the fastest way to size
   a niche or track how a category grows.
2. **Complete product reviews**: every review of a product in one go, with rating, text, pros and cons, date,
   photos and the seller it was bought from.
3. **Offer checks**: for the offer or product links you provide, whether each offer is still listed, its name
   and image, and how many competing offers the product has. Handy for watching a list of offers go live or disappear.

No other Apify Store actor offers category sizes, filter breakdowns or complete reviews for Allegro.hu.

### Input

Pick a **mode**, then fill in the targets for it.

| Mode | You provide | You get one row per |
|---|---|---|
| Market data (default) | category links or IDs, keywords, or seller names | category or query |
| Reviews | product links | review |
| Offers | offer or product links | offer |

Optional filters for market data: price range in HUF, condition, ships-from country, Allegro warehouse only,
subcategory walk, and splitting large categories by price so no count is capped.

No proxy is needed for any mode.

### Output

Each run returns one kind of row, so your export is never mixed. Field names are camelCase, prices are in HUF,
and Hungarian labels are kept as the site shows them. Every row says which mode produced it, when it was
scraped, and where it came from.

### Pricing

You pay only for rows delivered: $2.50 per 1,000 rows on the Apify Free plan, with automatic discounts on paid plans
(down to $2.25 per 1,000 rows). No proxy or other add-on costs.

### Limitations

- **No keyword search for offers.** Allegro.hu blocks automated access to its search and category result pages,
  so this actor cannot list offers for a keyword. Market data gives you the counts; for offer checks, supply the
  offer or product links.
- **Market data counts offers but does not list them.** Allegro shows at most 6,000 results per query. With
  price splitting on, large categories are divided so the counts stay complete, and any segment that is still
  over the limit is flagged.
- **No offer prices, stock, specifications or seller details.** Allegro.hu protects its individual offer pages against
  automated access, so this actor does not open them. Offer checks cover what Allegro serves openly: live status, name,
  image and competing-offer count.
- Reviews come newest-first. With a minimum star rating they are grouped by star, newest-first within each. Allegro.hu does not reliably serve other review orders.
- Allegro.hu only. Allegro.pl, .cz and .sk are separate sites.

### Legal

This actor reads publicly available data only, without logging in. Review author names appear exactly as Allegro.hu
displays them. You are responsible for using the data lawfully,
including GDPR where it applies.

# Changelog

This Actor's version history is a separate document: https://apify.com/extractify-labs/allegro-hu-scraper/changelog.md

# Actor input Schema

## `mode` (type: `string`):

Market data counts offers per category or query. Reviews returns every review of a product. Offers checks whether the offers you give are still listed.

## `categoryUrls` (type: `array`):

Allegro.hu category pages (…/kategoria/name-12345) or just the number at the end. Used by Market data. The example category (Laptops) is only used when you give no keywords, sellers or categories of your own.

## `searchQueries` (type: `array`):

Words to count offers for, as a buyer would type them. Used by Market data.

## `sellerLogins` (type: `array`):

Seller logins as shown on Allegro.hu, to count and break down a seller's offers. Used by Market data.

## `productUrls` (type: `array`):

Allegro.hu product pages (…/termek/…). Used by Reviews, and by Offers for the competing-offer count.

## `offerUrls` (type: `array`):

Allegro.hu offer pages (…/ajanlat/…-12345678901) or the offer number. Used by Offers.

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

Only count offers in this price range, in Hungarian forint.

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

Only count offers in this price range, in Hungarian forint.

## `condition` (type: `string`):

Only count offers in this condition (new, used, refurbished and every other condition Allegro.hu lists).

## `shipsFrom` (type: `string`):

Only count offers shipped from Hungary, Poland, Czechia, Slovakia or other EU countries, or from the Allegro warehouse (same as Allegro warehouse only).

## `allegroWarehouseOnly` (type: `boolean`):

Only count offers fulfilled from Allegro's own warehouse.

## `facetFilters` (type: `object`):

Any other Allegro.hu filter, as its name and value from the category page (for example {"ram": "16 GB"}). For power users.

## `descendSubcategories` (type: `boolean`):

Also count every subcategory under the ones you give, level by level.

## `splitByPrice` (type: `boolean`):

Divides categories over 6,000 offers into price bands so no count is capped. More requests, complete numbers.

## `includeParameterDefinitions` (type: `boolean`):

Adds the full list of filter names and values per category (large, about 0.5 MB each).

## `maxNodes` (type: `integer`):

Stop after this many market-data rows. The default of 3 keeps a first run quick; raise it when walking subcategories or splitting by price.

## `maxReviewsPerProduct` (type: `integer`):

Stop after this many reviews for each product. Leave empty for all.

## `minRating` (type: `integer`):

Only reviews with at least this many stars.

## `withPhotosOnly` (type: `boolean`):

Only reviews that include buyer photos.

## `maxItems` (type: `integer`):

The run stops after this many rows in total. The default of 20 keeps a first run quick; raise it for full reviews, full subcategory walks or price splitting.

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

Not needed for any mode. Leave it off unless you have a reason to route through Apify Proxy.

## Actor input object example

```json
{
  "mode": "market",
  "categoryUrls": [
    "491"
  ],
  "condition": "any",
  "shipsFrom": "any",
  "allegroWarehouseOnly": false,
  "descendSubcategories": false,
  "splitByPrice": false,
  "includeParameterDefinitions": false,
  "maxNodes": 3,
  "withPhotosOnly": false,
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

One row type per run, chosen by the mode input: market data, reviews, or offers.

## `coverage` (type: `string`):

What the run covered: rows saved, targets, pages skipped and why it stopped.

# 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 = {
    "mode": "market",
    "categoryUrls": [
        "491"
    ],
    "maxNodes": 3,
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("extractify-labs/allegro-hu-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 = {
    "mode": "market",
    "categoryUrls": ["491"],
    "maxNodes": 3,
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("extractify-labs/allegro-hu-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 '{
  "mode": "market",
  "categoryUrls": [
    "491"
  ],
  "maxNodes": 3,
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call extractify-labs/allegro-hu-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,extractify-labs/allegro-hu-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/IYMwbwKyxIHXpNosk/builds/tD06TochmSWLz6m9U/openapi.json