# ÁrGép (argep.hu) Product Price Scraper (`solidcode/argep-hu-scraper`) Actor

\[💰 $2.0 / 1K] Extract product prices from ÁrGép (argep.hu), Hungary's price-comparison portal — lowest/highest price in HUF, every merchant offer with shipping cost, total price, delivery time and shop rating, plus brand, GTIN and category path.

- **URL**: https://apify.com/solidcode/argep-hu-scraper.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 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?

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

## ÁrGép Price Scraper (argep.hu)

Pull live product prices from ÁrGép, Hungary's #2 price-comparison site, at scale — every product's lowest and highest HUF price, competing offer count, product identity (brand, GTIN, SKU), and the full list of merchant offers with shipping, total cost, delivery time, and shop rating. Built for Hungarian e-commerce sellers, pricing teams, and market researchers who need live ÁrGép prices across hundreds of products without checking each listing by hand.

### Why This Scraper?

- **Every merchant offer on one row** — shop name, item price, shipping fee, total (item + shipping), delivery time, shop star rating, and shop review count for every seller listing a product, not just the cheapest. A mainstream SKU can carry 50+ offers, all nested on a single result.
- **Lowest-and-highest HUF price spread** — see the full price range across every Hungarian webshop selling a product, alongside the exact number of competing offers.
- **Product identity you can join on** — brand, GTIN barcode, and ÁrGép SKU on every product, so you can match ÁrGép rows to your own catalog or a supplier feed.
- **Discover products without a URL list** — keyword search spans ÁrGép's full Hungarian webshop network across every major category, so you start from a term like `mosógép`, not a hand-built list of product links.
- **Category sweeps, not just product pages** — paste any category link and pull up to 40 products per page automatically; mix category links, search links, and product links freely in one run.
- **Exclude your own shop (or any competitor)** — drop named shops from the offer list by name or domain, so a merchant sees only rival pricing.
- **Focus a price segment** — minimum and maximum HUF price filters, plus low-to-high or high-to-low sorting, surface the cheapest products in a category first.
- **Fast price-only mode** — turn merchant offers off for a lightweight run that still returns each product's cheapest price and total shop count.
- **Full category path and product ratings** — root-to-leaf breadcrumb trail, product star rating, review count, spec summary, and image on every product.

### Use Cases

**Price Monitoring & Repricing**

- Track a product's lowest and highest HUF price across every seller
- Watch the total offer count to spot when new competitors start listing your SKU
- Benchmark your shop's price against the cheapest offer on ÁrGép
- Feed live competitor prices into a repricing workflow

**Competitive Intelligence**

- See which shops sell a product, at what total price including shipping
- Compare shop star ratings and review counts alongside price to gauge trust
- Track delivery times as a competitive lever, not just headline price
- Identify who consistently undercuts you, and by how much

**Market Research**

- Map the HUF price spread of an entire category from one link
- Measure how many merchants stock a product line across Hungary
- Track product ratings and review volume to find category winners
- Build a catalog of GTINs and SKUs for a product segment

**Reselling & Arbitrage**

- Find products with a wide lowest-to-highest gap to source cheaply
- Sort a category price low-to-high to surface the best entry points
- Use minimum and maximum price filters to focus a target margin band

**Retailer Lead Generation**

- Build a list of shops selling in your category, each with its ÁrGép shop-rating page
- Identify high-rated merchants as potential partners or suppliers
- Spot new entrants by watching a product's shop list grow over time

### Getting Started

#### Simple Keyword Search

The quickest start — one term, ten products:

```json
{
    "searchTerms": ["wifi router"],
    "maxResults": 10
}
```

#### Category Sweep with a Price Range

Pull a whole category, cheapest first, within a HUF band:

```json
{
    "startUrls": ["https://www.argep.hu/kat3-1370.html"],
    "sortBy": "priceAsc",
    "minPrice": 10000,
    "maxPrice": 40000,
    "maxResults": 80
}
```

#### Full Run (Search + Links + Filters)

Combine keyword searches, pasted links, filters, and a shop exclusion:

```json
{
    "searchTerms": ["mosógép", "hűtőszekrény"],
    "startUrls": [
        "https://www.argep.hu/product_1840685.html",
        "https://www.argep.hu/kat3-1370.html"
    ],
    "maxResults": 200,
    "sortBy": "priceAsc",
    "minPrice": 50000,
    "includeOffers": true,
    "excludeShops": ["mediamarkt"]
}
```

### Input Reference

#### What to Scrape

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `searchTerms` | string\[] | `["wifi router"]` | Words to search on ÁrGép, e.g. `wifi router` or `mosógép`. Each term runs its own search. Hungarian and English both work — Hungarian finds more. |
| `startUrls` | string\[] | `[]` | ÁrGép links — product pages, category pages, or search-result pages. The type of each link is worked out for you, so you can mix them freely. |

#### Results

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `maxResults` | integer | `10` | How many products to return per search term or category link. Whole pages are kept, so the total can land a little above your number. Set to `0` to take everything. Pasted product links never count against this limit. |
| `sortBy` | select | `Best match (ÁrGép default)` | The order ÁrGép returns products in: `Best match (ÁrGép default)`, `Price: low to high`, or `Price: high to low`. |
| `minPrice` | integer | *none* | Only return products priced at or above this amount in Hungarian forint. Leave empty for no lower limit. |
| `maxPrice` | integer | *none* | Only return products priced at or below this amount in Hungarian forint. Leave empty for no upper limit. |

#### Merchant Offers

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `includeOffers` | boolean | `true` | On: open each product and collect every shop selling it — name, price, shipping, total, delivery time, and star rating. Off: a much faster run returning only the product plus its cheapest price and shop count. |
| `excludeShops` | string\[] | `[]` | Shop names or web addresses to leave out of the offer list — for example your own shop, so you see only competitors. Case-insensitive, matches part of a name (`ipon` also removes `ipon.hu`). |

### Output

One row per product, with its competing merchant offers nested inside `offers[]`:

```json
{
    "productId": "1840685",
    "title": "TP-Link Archer AX55 router",
    "url": "https://www.argep.hu/product_1840685.html",
    "image": "https://www.argep.hu/images/products/1840685.jpg",
    "brand": "TP-Link",
    "category": "Wi-Fi Router",
    "categoryPath": ["Számítógép", "Hálózat", "Wi-Fi Router"],
    "description": "Wi-Fi 6, AX3000, 4 antenna, Gigabit LAN",
    "gtin": "6935364070533",
    "sku": "1840685",
    "lowestPrice": 24990,
    "highestPrice": 33499,
    "currency": "HUF",
    "offerCount": 18,
    "filteredOfferCount": 17,
    "rating": 4.6,
    "reviewCount": 42,
    "availability": "InStock",
    "offers": [
        {
            "shopName": "ipon.hu",
            "shopId": "1042",
            "shopRatingUrl": "https://www.argep.hu/bolt_ertekeles--1042.html",
            "shopRating": 4.8,
            "shopReviewCount": 5120,
            "offerTitle": "TP-Link Archer AX55 AX3000 Gigabit Wi-Fi 6 Router",
            "price": 24990,
            "shippingCost": 1290,
            "totalPrice": 26280,
            "currency": "HUF",
            "availability": "InStock",
            "deliveryTime": "1 munkanap",
            "offerId": "88421703",
            "merchantUrl": "https://www.argep.hu/click/..."
        },
        {
            "shopName": "aqua.hu",
            "shopId": "2288",
            "shopRatingUrl": "https://www.argep.hu/bolt_ertekeles--2288.html",
            "shopRating": 4.5,
            "shopReviewCount": 860,
            "offerTitle": "TP-Link Archer AX55 router",
            "price": 25490,
            "shippingCost": 0,
            "totalPrice": 25490,
            "currency": "HUF",
            "availability": "InStock",
            "deliveryTime": "2-3 munkanap",
            "offerId": "88422991",
            "merchantUrl": "https://www.argep.hu/click/..."
        }
    ],
    "searchTerm": "wifi router",
    "sourceUrl": "https://www.argep.hu/Katalog/Suche/wifi-router.html",
    "scrapedAt": "2026-08-05T14:30:00Z"
}
```

#### Product Core

| Field | Type | Description |
|-------|------|-------------|
| `productId` | string | ÁrGép product ID |
| `title` | string | Product name |
| `url` | string | Canonical ÁrGép product URL |
| `image` | string | Product image URL |
| `description` | string | One-line spec summary |
| `availability` | string | Stock status (`InStock` / `OutOfStock`) |
| `searchTerm` | string | Search term that produced this row (null for pasted links) |
| `sourceUrl` | string | The search or start link this row came from |
| `scrapedAt` | string | ISO 8601 timestamp of extraction |

#### Product Identity & Category

| Field | Type | Description |
|-------|------|-------------|
| `brand` | string | Manufacturer / brand name |
| `gtin` | string | EAN / GTIN barcode, as most often reported by merchants |
| `sku` | string | ÁrGép SKU |
| `category` | string | Leaf category name |
| `categoryPath` | string\[] | Full breadcrumb trail, root to leaf |

#### Pricing & Ratings

| Field | Type | Description |
|-------|------|-------------|
| `lowestPrice` | number | Cheapest offer, HUF |
| `highestPrice` | number | Most expensive offer, HUF |
| `currency` | string | Always `HUF` |
| `offerCount` | number | Number of merchant offers ÁrGép reports |
| `filteredOfferCount` | number | Offers returned after `excludeShops` (null when offers are off) |
| `rating` | number | Product rating, 1–5 |
| `reviewCount` | number | Number of product reviews |

#### Merchant Offer (nested in `offers[]`)

| Field | Type | Description |
|-------|------|-------------|
| `shopName` | string | Merchant name or domain |
| `shopId` | string | ÁrGép seller ID |
| `shopRatingUrl` | string | Link to the shop's ÁrGép rating page |
| `shopRating` | number | Shop star rating, 0–5 |
| `shopReviewCount` | number | Number of shop reviews |
| `offerTitle` | string | Merchant's own product title |
| `price` | number | Item price, HUF |
| `shippingCost` | number | Shipping fee, HUF |
| `totalPrice` | number | Item + shipping, HUF |
| `currency` | string | Always `HUF` |
| `availability` | string | Stock status for this offer |
| `deliveryTime` | string | Delivery text, e.g. `1 munkanap` |
| `offerId` | string | ÁrGép offer/tag ID |
| `merchantUrl` | string | ÁrGép click-through link to the merchant listing |

### Tips for Best Results

- **Start small, then scale** — set `maxResults` to 10–20 on a first run to confirm the data fits your needs, then raise it (up to 5,000).
- **Use category links for broad sweeps** — one category page yields up to 40 products in a single request, far more efficient than many separate keyword searches.
- **Turn off merchant offers for a fast price snapshot** — with `includeOffers` off you still get each product's cheapest price and shop count, in a fraction of the time.
- **Search in Hungarian for the most matches** — ÁrGép is a Hungarian site, so `mosógép` finds more than "washing machine". English works, but Hungarian terms surface the full catalog.
- **Exclude your own shop to see only rivals** — add your domain to `excludeShops` so every offer row is a competitor's price.
- **Focus a price band** — `minPrice` and `maxPrice` are applied by ÁrGép itself before results come back, so a tight band means a faster, more relevant run.
- **Paste `product_` links for guaranteed depth** — pasted product links are always opened in full and never count against `maxResults`, so use them when you need specific SKUs regardless of the cap.

### Pricing

**From $2.00 per 1,000 results** — the lowest per-result rate for full ÁrGép offer data, with every merchant offer nested on one product row so a 2-offer product and a 60-offer product bill exactly the same. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

| Results | No discount | Bronze | Silver | Gold |
|---------|-------------|--------|--------|------|
| 100 | $0.24 | $0.23 | $0.21 | $0.20 |
| 1,000 | $2.40 | $2.30 | $2.10 | $2.00 |
| 10,000 | $24.00 | $23.00 | $21.00 | $20.00 |
| 100,000 | $240.00 | $230.00 | $210.00 | $200.00 |

A "result" is one product row in the output dataset, with all of its merchant offers included. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger custom APIs on run completion
- **Apify API** — Full programmatic access

### Legal & Ethical Use

This actor is designed for legitimate price monitoring, competitive analysis, and market research. Users are responsible for complying with applicable laws and ÁrGép's Terms of Service. Do not use extracted data for spam, harassment, or any illegal purpose. Prices and offers change frequently — always treat collected data as a point-in-time snapshot.

# Actor input Schema

## `searchTerms` (type: `array`):

Words to search for on ÁrGép, for example 'wifi router' or 'mosógép'. Each term runs its own search and returns its own set of products. Hungarian and English both work — ÁrGép is a Hungarian site, so Hungarian words find more.

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

Paste ÁrGép links — product pages (argep.hu/product\_1840685.html), category pages (argep.hu/kat3-1370.html) or search result pages. The scraper works out what each link is on its own, so you can mix them freely. Any filters already built into the link are kept.

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

How many products to return for each search term or each category link. ÁrGép serves 20 products per search page and 40 per category page, and whole pages are kept — so the last page can take the total a little above your number rather than throwing results away. Set to 0 to take everything the search or category has (up to 300 pages). Product links you paste are always scraped and never count against this limit.

## `sortBy` (type: `string`):

The order ÁrGép returns products in. 'Best match' is the site's own default ranking. Sorting by price is handy when you want the cheapest products in a category first.

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

Only return products priced at or above this amount in Hungarian forint. ÁrGép applies the price range itself, so nothing is downloaded and thrown away. Leave empty for no lower limit. The price range applies to search terms and to category or search links — pasted product links are always returned in full.

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

Only return products priced at or below this amount in Hungarian forint. ÁrGép applies the price range itself, so nothing is downloaded and thrown away. Leave empty for no upper limit. The price range applies to search terms and to category or search links — pasted product links are always returned in full.

## `includeOffers` (type: `boolean`):

Turn this on to open each product and collect the shops selling it — shop name, price, shipping fee, total cost, delivery time and the shop's star rating. The full merchant offer list is collected for each product, up to about 300 offers (well above any real product — the most any product carries is a few dozen). Turn it off for a much faster run that returns only the product plus its cheapest price and the number of shops offering it. Product links you paste are always opened, so they keep their full product details either way.

## `excludeShops` (type: `array`):

Shop names or web addresses you don't want in the offer list — for example your own shop, so you only see your competitors. Matching ignores capitals and matches part of a name, so 'ipon' also removes 'ipon.hu'.

## Actor input object example

```json
{
  "searchTerms": [
    "wifi router"
  ],
  "startUrls": [],
  "maxResults": 10,
  "sortBy": "relevance",
  "includeOffers": true,
  "excludeShops": []
}
```

# Actor output Schema

## `overview` (type: `string`):

Table of products with cheapest price, number of shops offering it, rating and link.

## `details` (type: `string`):

Full per-product rows including brand, GTIN, category path, price range and every merchant offer.

# 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 = {
    "searchTerms": [
        "wifi router"
    ],
    "startUrls": [],
    "maxResults": 10,
    "sortBy": "relevance",
    "includeOffers": true,
    "excludeShops": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/argep-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 = {
    "searchTerms": ["wifi router"],
    "startUrls": [],
    "maxResults": 10,
    "sortBy": "relevance",
    "includeOffers": True,
    "excludeShops": [],
}

# Run the Actor and wait for it to finish
run = client.actor("solidcode/argep-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 '{
  "searchTerms": [
    "wifi router"
  ],
  "startUrls": [],
  "maxResults": 10,
  "sortBy": "relevance",
  "includeOffers": true,
  "excludeShops": []
}' |
apify call solidcode/argep-hu-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,solidcode/argep-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/CzXMGMuTDKdTSNjos/builds/D6ZmhJfkEnXdU4Is9/openapi.json
