{ "openapi": "3.0.1", "info": { "title": "Amazon Seller Contacts Scraper", "description": "Amazon seller scraper for B2B leads: give seller IDs or product, search or best seller links, get one row per seller with business name, email, phone, VAT and register numbers, address, ratings and buyer feedback. Any Amazon marketplace, no login.", "version": "0.1", "x-build-id": "AoHpwkRpTb0Bvgcsg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deepmine~amazon-seller-contacts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deepmine-amazon-seller-contacts-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/deepmine~amazon-seller-contacts-scraper/runs": { "post": { "operationId": "runs-sync-deepmine-amazon-seller-contacts-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/deepmine~amazon-seller-contacts-scraper/run-sync": { "post": { "operationId": "run-sync-deepmine-amazon-seller-contacts-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": { "startUrls": { "title": "🔗 Amazon links (sellers, products, lists)", "type": "array", "description": "Seller profiles (amazon.de/sp?seller=…) or storefronts, products (/dp/ASIN), searches (/s?k=…) or best seller lists, on any Amazon site: each link is read on its own site. A product's sellers come from its offers, buy box first.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keywords": { "title": "🔍 Search keywords", "type": "array", "description": "Products to search for, as a shopper types them, e.g. phone case. The sellers of the results come back in result order, buy box first. Searched on 🌍 Marketplace.", "items": { "type": "string" } }, "domain": { "title": "🌍 Marketplace", "pattern": "^\\s*(https?://)?((www|smile|m)\\.)?amazon\\.[a-z.]{2,8}/?\\s*$", "type": "string", "description": "For keywords, seller IDs and ASINs (a link keeps its own site). EU sites publish sellers' email, phone, VAT and register numbers; amazon.com their business name and address.", "default": "www.amazon.com" }, "maxSellersPerInput": { "title": "🏪 Max sellers per link or keyword", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Sellers per link or keyword, in the order found. You pay per seller: once per run, however many products show it. Products checked are free.", "default": 100 }, "maxFeedbackPerSeller": { "title": "💬 Buyer feedback per seller", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Newest buyer feedback per seller: rating, date, text, Amazon's strike-through and the seller's reply. The newest 5 are on the seller's row, in its price. Above 5, the rest (up to 5,000 per seller) go one row each to the 💬 Buyer feedback dataset, at $0.25 per 1,000. 0 = none.", "default": 5 }, "findWebsite": { "title": "🌐 Find the seller's website", "type": "boolean", "description": "Adds the seller's own website, kept only when it shows the seller's VAT or register number, postcode or legal name, and the emails, phones and social links on it. Slower. No extra charge.", "default": false }, "sellerIds": { "title": "🏪 Seller IDs", "type": "array", "description": "Amazon merchant ids, e.g. A18EE9GVRFMIY1 (the seller= part of a seller link), read on 🌍 Marketplace.", "items": { "type": "string" } }, "asins": { "title": "📦 ASINs", "type": "array", "description": "Products by ASIN, e.g. B0D1CHFY21: their sellers come back, buy box first.", "items": { "type": "string" } }, "maxProductsPerInput": { "title": "📦 Products to check per search or list", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How far down a search or list to look for sellers. Many products are sold by Amazon itself (no seller row): check more to find more sellers. Free.", "default": 100 }, "maxItems": { "title": "Max sellers in the run", "minimum": 1, "maximum": 10000000, "type": "integer", "description": "Stops the whole run at this many sellers. Empty = no limit but the one per link or keyword." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as is: Apify datacenter proxies work for Amazon. Residential is replaced by datacenter (it costs more per page than a row earns).", "default": { "useApifyProxy": true } }, "maxItemsPerStartUrl": { "title": "Max sellers per start URL", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "The same as 🏪 Max sellers per link or keyword." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000000, "type": "integer", "description": "The same as Max sellers in the run." } } }, "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 } } } } } } } } } }