{ "openapi": "3.0.1", "info": { "title": "Amazon Seller Scraper 🏪 (business name, address, VAT, phone)", "description": "The business behind any Amazon seller: legal name, address, VAT and trade-register numbers, phone and e-mail where Amazon publishes them, plus ratings. Give seller IDs, or products and searches to find every seller behind them. 11 marketplaces, no login.", "version": "0.1", "x-build-id": "67zrNXWMLVuEGZ50Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tagadanar~amazon-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tagadanar-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/tagadanar~amazon-seller-scraper/runs": { "post": { "operationId": "runs-sync-tagadanar-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/tagadanar~amazon-seller-scraper/run-sync": { "post": { "operationId": "run-sync-tagadanar-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": { "sellerIds": { "title": "Seller IDs or seller links", "type": "array", "description": "Sellers you already know, one per line: the seller ID (e.g. A2J3MHS8H5EIUE), the seller profile link (amazon.de/sp?seller=…) or the storefront link (amazon.de/s?me=…). A link's own Amazon site wins over the marketplace below.", "items": { "type": "string" } }, "asins": { "title": "Products (ASINs or product links)", "type": "array", "description": "Find every seller offering these products: ASINs (B0GGS2KT4G) or product links. All offers are read, up to 100 per product; products sold only by Amazon itself have no third-party seller to return.", "items": { "type": "string" } }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Optional. Find the sellers behind the top products of an Amazon search, one keyword per line (e.g. \"lego technic\"). The top products are taken in Amazon's order, sponsored ones left out.", "items": { "type": "string" } }, "marketplace": { "title": "Amazon marketplace", "enum": [ "DE", "UK", "FR", "IT", "ES", "NL", "SE", "PL", "BE", "US", "CA" ], "type": "string", "description": "The Amazon site to read. EU and UK sites show the seller's legally required business details (company name, address, VAT and trade-register numbers, often phone and e-mail); amazon.com shows the business name and address for most sellers.", "default": "DE" }, "maxSellers": { "title": "Max sellers to find", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop collecting sellers from products and searches after this many different sellers. Seller IDs you list yourself are always fetched. You only pay for sellers delivered.", "default": 50 }, "productsPerSearch": { "title": "Top products per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many of the top products of each search keyword to look up for sellers.", "default": 10 }, "includeFeedback": { "title": "Include ratings", "type": "boolean", "description": "Add the seller's feedback: positive % and average stars, with rating counts for the last 30 days, 90 days, 12 months and lifetime, and the star breakdown. It is on the same page, so it costs nothing extra.", "default": true } } }, "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 } } } } } } } } } }