{ "openapi": "3.0.1", "info": { "title": "Amazon DE Sellers Leads Scraper : Multi-Niche Lead Sourcing", "description": "Scrape Amazon Germany sellers across multiple niches to discover business leads. Extract seller names, profiles, product categories, ratings, locations, and contact details for B2B prospecting, lead generation, market research, and niche sourcing.", "version": "1.0", "x-build-id": "fDbv2XC8bvLFE5TQE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~amazon-de-sellers-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-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/api-empire~amazon-de-sellers-leads-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-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/api-empire~amazon-de-sellers-leads-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-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": { "searchQueries": { "title": "๐Ÿงบ Niches to search (batch)", "type": "array", "description": "๐Ÿ“ฆ One niche per line, in the form keyword:amazon_category โ€” e.g. yoga mat:sports. Every queued pair is searched in turn (shared run budget from Maximum seller leads below), and every output row is tagged sourceKeyword/sourceCategory. amazon_category must be one of: fashion-womens, fashion-mens, fashion-kids, electronics, grocery, toys, sports, books, beauty, home-garden, automotive, pet-supplies, tools-garden, baby, health. Leave empty to fall back to the single Product keyword + Amazon category fields below, treated as a 1-item batch.", "items": { "type": "string" } }, "keyword": { "title": "๐Ÿ”Ž Product keyword (legacy fallback, single niche)", "type": "string", "description": "๐Ÿงฉ Used only when Niches to search (searchQueries) above is empty. Enter what you want to search (e.g. shirt, shoes, phone case) โ€” treated as a 1-item batch alongside amazon_category below." }, "amazon_category": { "title": "๐Ÿ—‚๏ธ Amazon category (legacy fallback, single niche)", "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": "๐Ÿ“š Paired with the legacy keyword above when searchQueries is empty. Choose the category to narrow results." }, "sort_by": { "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": "๐Ÿ“Œ Pick how Amazon search results should be ordered before seller extraction. Applies to every queued niche." }, "maxResults": { "title": "๐Ÿ“ˆ Maximum seller leads (total across all queued niches)", "minimum": 1, "maximum": 50000, "type": "integer", "description": "๐Ÿ”ข Maximum number of unique seller leads to collect in this run, shared across ALL queued searches combined (1-50,000) โ€” not per niche. Higher values may increase run time." }, "startUrls": { "title": "๐Ÿ”— Amazon URLs (search or product)", "type": "array", "description": "๐Ÿ“ Optional: Paste Amazon.de search/product URLs. When provided, these are processed directly instead of the queued niches/legacy keyword above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "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 } } } } } } } } } }