{ "openapi": "3.0.1", "info": { "title": "eMAG Seller Scraper – Vendors, Contacts & Categories", "description": "Discover and enrich public eMAG marketplace seller profiles across Romania, Bulgaria, and Hungary, including company details, public contacts, categories, and resumable exports. Proxy support improves routing but does not guarantee access.", "version": "0.0", "x-build-id": "5hS5hKlND33M0yV5J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sergiumeserias~emag-seller-scraper-vendors-contacts-categories/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sergiumeserias-emag-seller-scraper-vendors-contacts-categories", "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/sergiumeserias~emag-seller-scraper-vendors-contacts-categories/runs": { "post": { "operationId": "runs-sync-sergiumeserias-emag-seller-scraper-vendors-contacts-categories", "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/sergiumeserias~emag-seller-scraper-vendors-contacts-categories/run-sync": { "post": { "operationId": "run-sync-sergiumeserias-emag-seller-scraper-vendors-contacts-categories", "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": { "operation": { "title": "Data package", "enum": [ "DISCOVERY", "FULL", "INTELLIGENCE" ], "type": "string", "description": "Discovery exports seller identities. Full profiles adds public company and contact fields. Intelligence also exports seller-category relationships.", "default": "FULL" }, "targetCountry": { "title": "Marketplace country", "enum": [ "RO", "BG", "HU", "ALL" ], "type": "string", "description": "Run one marketplace or all three sequentially with the matching country proxy pool.", "default": "RO" }, "startUrls": { "title": "Optional category, search, product, seller, or sitemap URLs", "type": "array", "description": "Leave empty to use the official category sitemap for the selected marketplace. Custom URLs must match the selected country.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "contactMode": { "title": "Public contact output", "enum": [ "full", "masked", "none" ], "type": "string", "description": "Full exports public phone and email values. Masked partially hides them. None returns only has_phone and has_email flags.", "default": "full" }, "resumeFromRunId": { "title": "Resume from run ID", "type": "string", "description": "Copies completed results and restores unfinished requests from a previous run of this Actor without charging copied results again." }, "maxVendors": { "title": "Maximum unique sellers", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Hard cap across the selected countries.", "default": 25000 }, "maxListingPages": { "title": "Maximum category/search pages", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum listing pages per country.", "default": 2500 }, "maxSitemapPages": { "title": "Maximum XML sitemap pages", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum sitemap index and sitemap files per country.", "default": 1000 }, "maxProductPages": { "title": "Maximum product pages", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Fallback discovery limit. Vendor filters are preferred because they use fewer requests.", "default": 0 }, "maxVendorFilterPages": { "title": "Maximum complete seller-filter requests", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Usually one request per category where the visible filter is truncated.", "default": 2500 }, "followPagination": { "title": "Follow listing pagination", "type": "boolean", "description": "Follow visible next-page links on category and search pages.", "default": false }, "followProducts": { "title": "Open product pages for discovery", "type": "boolean", "description": "Use only when category seller filters are insufficient; increases cost and runtime.", "default": false }, "useVendorFilters": { "title": "Use public seller filters", "type": "boolean", "description": "Extract seller IDs directly from the public Livrat de filter.", "default": true }, "maxConcurrency": { "title": "Concurrent stable sessions", "minimum": 1, "maximum": 6, "type": "integer", "description": "Separate sticky sessions with isolated cookies. Higher values can increase blocking.", "default": 3 }, "delaySeconds": { "title": "Minimum delay per session", "minimum": 2, "maximum": 120, "type": "integer", "description": "Minimum seconds between requests made by the same stable session.", "default": 4 }, "maxRequestRetries": { "title": "Transient retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "Retries network and temporary server failures only. Access challenges are recorded and skipped.", "default": 2 }, "wafFallbackEnabled": { "title": "Use capped recovery fetch", "type": "boolean", "description": "Optional paid recovery fetch for blocked public pages. It does not solve CAPTCHA and does not guarantee access.", "default": false }, "maxWafFallbackCalls": { "title": "Maximum paid recovery calls", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Hard cap for paid recovery child runs.", "default": 0 }, "wafFallbackMaxChargeUsd": { "title": "Maximum charge per recovery call", "minimum": 0.063, "maximum": 0.25, "type": "number", "description": "Maximum child-run charge in USD.", "default": 0.07 }, "userAgent": { "title": "User-Agent", "type": "string", "description": "Identifiable User-Agent sent with requests.", "default": "VendwiserResearchBot/1.0 (public marketplace research)" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }