{ "openapi": "3.0.1", "info": { "title": "ÁrGép (argep.hu) Product Price Scraper", "description": "[💰 $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.", "version": "1.0", "x-build-id": "D6ZmhJfkEnXdU4Is9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~argep-hu-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-argep-hu-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/solidcode~argep-hu-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-argep-hu-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/solidcode~argep-hu-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-argep-hu-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "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.", "items": { "type": "string" } }, "startUrls": { "title": "ÁrGép URLs", "type": "array", "description": "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.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum Products", "minimum": 0, "maximum": 5000, "type": "integer", "description": "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": { "title": "Sort Products By", "enum": [ "relevance", "priceAsc", "priceDesc" ], "type": "string", "description": "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": { "title": "Minimum Price (Ft)", "minimum": 0, "maximum": 99999999, "type": "integer", "description": "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": { "title": "Maximum Price (Ft)", "minimum": 0, "maximum": 99999999, "type": "integer", "description": "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": { "title": "Include Every Merchant Offer", "type": "boolean", "description": "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": { "title": "Shops to Leave Out", "type": "array", "description": "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'.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }