{
"openapi": "3.0.1",
"info": {
"title": "Amazon Seller Scraper | Emails, Phones and Ratings",
"description": "Amazon seller scraper that turns any keyword, product link, ASIN or seller id into a contact list of third-party sellers: business name, VAT and trade register numbers, email, phone, address and ratings. 15 sellers in 46 seconds from 1 keyword, 35 fields each, every row with an email. No login.",
"version": "1.0",
"x-build-id": "mxOf7EKxg5U3e7hlQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~amazon-seller-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-amazon-seller-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/silentflow~amazon-seller-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-amazon-seller-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/silentflow~amazon-seller-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-amazon-seller-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": {
"keywords": {
"title": "🔎 Search keywords",
"type": "array",
"description": "Products to search on the marketplace, as a shopper would type them: phone case, yoga mat, coffee grinder. The actor opens the offers of each product found and returns the third-party sellers behind them, one row per seller. One results page brought 16 sellers for phone case on amazon.de; the search goes page after page until your maximum is reached.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "🔗 Amazon links",
"type": "array",
"description": "Paste links copied from any Amazon store:- a seller profile:
https://www.amazon.de/sp?seller=A18EE9GVRFMIY1 - a storefront:
https://www.amazon.de/s?me=A18EE9GVRFMIY1 - a product, for every seller offering it:
https://www.amazon.de/dp/B0CTCD7CS5 - a search, best-seller or category page, for the sellers of its products:
https://www.amazon.com/gp/bestsellers/kitchen/
The store in the link wins over the marketplace field, so one run can mix countries.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"ids": {
"title": "🆔 Seller ids or ASINs",
"type": "array",
"description": "A seller id (A18EE9GVRFMIY1, the value after seller= in a profile link) reads that seller. An ASIN (B0CTCD7CS5, the 10 characters after /dp/) reads every seller offering that product. Both are read on the marketplace below. An id Amazon does not know gives no row and is counted in the run summary.",
"items": {
"type": "string"
}
},
"marketplace": {
"title": "🌍 Marketplace",
"enum": [
"de",
"com",
"co.uk",
"fr",
"it",
"es",
"nl",
"pl",
"se",
"com.be",
"ca",
"com.mx",
"com.br",
"com.au",
"co.jp",
"in",
"sg",
"ae",
"sa",
"com.tr"
],
"type": "string",
"description": "The Amazon store to search. European stores publish each business seller's legal details: email, phone, VAT number, trade register number and address. amazon.com publishes the business name and address. Links keep their own store.",
"default": "de"
},
"maxItems": {
"title": "🔢 Max sellers",
"minimum": 1,
"type": "integer",
"description": "Stop after this many sellers, shared fairly across your keywords, links and ids. 20 sellers from a keyword take under a minute. Set it to what you need, the cost grows with it.",
"default": 50
},
"sellerCountry": {
"title": "📍 Seller country",
"type": "string",
"description": "Keep only sellers whose business address is in this country, as a two-letter code: DE, IT, FR, GB, US, CN. Most sellers of a typical keyword are based abroad (10 Italian sellers out of 66 read for borraccia termica on amazon.it), so the search reads more products to fill your maximum and takes longer. Leave empty for every seller."
},
"includeStorefront": {
"title": "🏪 Add storefront size",
"type": "boolean",
"description": "Open each seller's storefront to add how many products it lists (productCount) and its departments, a quick way to tell a large brand from a small shop. Adds one page per seller. A storefront that cannot be read leaves the row with every other field.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}