{ "openapi": "3.0.1", "info": { "title": "Amazon DE Sellers Leads Scraper — Product Price & Ratings", "description": "Scrape Amazon Germany seller leads with product prices, ratings, seller details, product categories, reviews, and marketplace data. Ideal for B2B lead generation, supplier discovery, competitor research, product analysis, and market intelligence.", "version": "1.0", "x-build-id": "NjGnyOacQ5Mtw8MDT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~amazon-de-sellers-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-amazon-de-sellers-leads-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/simpleapi~amazon-de-sellers-leads-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-amazon-de-sellers-leads-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/simpleapi~amazon-de-sellers-leads-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-amazon-de-sellers-leads-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": { "searchKeyword": { "title": "🔎 Product search keyword", "type": "string", "description": "🧩 What to search for (e.g. shirt, shoes, phone case) to discover products and their sellers on Amazon.de. Falls back to the legacy 'keyword' field below when left empty." }, "productCategory": { "title": "🗂️ Amazon product category", "enum": [ "fashion-womens", "fashion-mens", "fashion-kids", "electronics", "grocery", "toys", "sports", "books", "beauty", "home-garden", "automotive", "pet-supplies", "tools-garden", "baby", "health" ], "type": "string", "description": "📚 Category to narrow results and find relevant sellers faster. Falls back to the legacy 'amazon_category' field below when left empty." }, "resultsSortOrder": { "title": "↕️ Sort results by", "enum": [ "Featured", "Best Sellers", "Price: Low to High", "Price: High to Low", "Avg. Customer Review", "Newest Arrivals", "Relevance", "Select..." ], "type": "string", "description": "📌 How Amazon search results should be ordered before seller/price extraction. Falls back to the legacy 'sort_by' field below when left empty." }, "maxLeads": { "title": "📈 Maximum seller leads", "minimum": 1, "maximum": 50000, "type": "integer", "description": "🔢 Maximum number of unique seller leads to collect in this run (1-50,000). Falls back to the legacy 'maxResults' field below when left empty. Higher values may increase run time." }, "amazonUrls": { "title": "🔗 Amazon URLs (search or product)", "type": "array", "description": "📝 Optional: paste Amazon.de search/product URLs to scrape directly. Falls back to the legacy 'startUrls' field below when left empty.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keyword": { "title": "🔁 Legacy keyword (base compatibility)", "type": "string", "description": "Legacy alias of 'searchKeyword'. Only used when 'searchKeyword' is empty." }, "amazon_category": { "title": "🔁 Legacy category (base compatibility)", "enum": [ "fashion-womens", "fashion-mens", "fashion-kids", "electronics", "grocery", "toys", "sports", "books", "beauty", "home-garden", "automotive", "pet-supplies", "tools-garden", "baby", "health" ], "type": "string", "description": "Legacy alias of 'productCategory'. Only used when 'productCategory' is empty." }, "sort_by": { "title": "🔁 Legacy sort (base compatibility)", "enum": [ "Featured", "Best Sellers", "Price: Low to High", "Price: High to Low", "Avg. Customer Review", "Newest Arrivals", "Relevance", "Select..." ], "type": "string", "description": "Legacy alias of 'resultsSortOrder'. Only used when 'resultsSortOrder' is empty." }, "maxResults": { "title": "🔁 Legacy max results (base compatibility)", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Legacy alias of 'maxLeads'. Only used when 'maxLeads' is empty." }, "startUrls": { "title": "🔁 Legacy start URLs (base compatibility)", "type": "array", "description": "Legacy alias of 'amazonUrls'. Only used when 'amazonUrls' is empty.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includePriceAndRatings": { "title": "💶 Harvest product price & ratings", "type": "boolean", "description": "📊 When ON (default), each lead includes the product's price, currency, list price (guarded, only when genuinely higher), star rating, review count and image URL from the product page already visited to find the seller. Turn OFF to skip these six fields.", "default": true }, "computeLeadScore": { "title": "🧮 Compute lead-quality score", "type": "boolean", "description": "🎯 When ON (default), each lead gets a computed productToSellerValueRatio sourcing score (price weighted against rating/reviews) and a hasFullImpressum compliance flag, both derived only from already-collected fields. Requires price & ratings above to be ON for the ratio to populate.", "default": true }, "proxyConfiguration": { "title": "🛡️ Proxy configuration", "type": "object", "description": "⚙️ Uses Apify Proxy (residential, pinned to Germany) by default for reliable access to Amazon.de. Change this only if you have a specific reason to." } } }, "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 } } } } } } } } } }