{ "openapi": "3.0.1", "info": { "title": "eMag Product & Offers Scraper", "description": "Extract structured product and pricing data from eMag — the largest online marketplace in Bulgaria, Romania, and Hungary. Supports category pages, brand filters, and multi-seller offer comparison.", "version": "0.3", "x-build-id": "jI0dCb0wbtJv8Ghk6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraping_crew~emag-product-and-offers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraping_crew-emag-product-and-offers", "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/scraping_crew~emag-product-and-offers/runs": { "post": { "operationId": "runs-sync-scraping_crew-emag-product-and-offers", "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/scraping_crew~emag-product-and-offers/run-sync": { "post": { "operationId": "run-sync-scraping_crew-emag-product-and-offers", "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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "URLs to start with", "default": [ { "url": "https://www.emag.bg/" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "allowedDomains": { "title": "Allowed domains", "type": "array", "description": "Domains that the scraper is allowed to crawl.", "default": [ "www.emag.bg", "www.emag.ro", "www.emag.hu", "sapi.emag.ro", "sapi.emag.bg", "sapi.emag.hu" ] }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings for the scraper. For Hungary (emag.hu) a RESIDENTIAL proxy is required. Datacenter proxies are not recommended — eMAG rate-limits their IP ranges. You can also supply your own proxy URLs.", "default": { "useApifyProxy": false, "apifyProxyGroups": [], "proxyUrls": [] } }, "getReviews": { "title": "Extract all reviews per product", "type": "boolean", "description": "When enabled, the scraper will collect all customer reviews for each product and append them as a 'reviews' field in the dataset output. Charges $0.0003 per 100 reviews (or part thereof) per product — e.g. 1–100 reviews = $0.0003, 101–200 = $0.0006. The minimum charge per product is $0.0003. Note: some products may have no reviews, in which case the 'reviews' field will be an empty array and no charge is applied. Tip: configuring a proxy significantly increases success rates when fetching reviews.", "default": false }, "getOffers": { "title": "Get all product offers", "type": "boolean", "description": "When enabled, the scraper will collect all seller offers for each product and append them as an 'offers' field in the dataset output. This is included at no extra charge. Note: only products listed by multiple sellers will have an 'offers' array; products with a single seller will have an empty array. Tip: configuring a proxy significantly increases success rates when fetching offers.", "default": false }, "concurrentRequests": { "title": "Concurrent requests", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of concurrent HTTP requests the scraper will make. Higher values increase speed but widen the gap between scraped items and the Max Items soft limit. Each in-flight request returns up to 100 products, so with 16 concurrent requests you could overshoot Max Items by up to 1,600 products. Keep this low if an accurate item count matters.", "default": 1 }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of products to scrape. Set to 0 to scrape all products without limit.", "default": 10 } } }, "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 } } } } } } } } } }