{ "openapi": "3.0.1", "info": { "title": "Amazon Seller Scraper - Ratings, Feedback & Business Info", "description": "Scrape public Amazon seller profiles in US, UK, DE, FR, IT, ES, CA, JP and more: store name, star rating, feedback counts (30d/90d/12m/lifetime), positive %, recent feedback, business name, address & VAT (EU), product count and storefront. Input seller IDs, URLs or ASINs.", "version": "1.0", "x-build-id": "d1Xu6iADtSJ84t3hV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lsdflying~amazon-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lsdflying-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/lsdflying~amazon-seller-scraper/runs": { "post": { "operationId": "runs-sync-lsdflying-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/lsdflying~amazon-seller-scraper/run-sync": { "post": { "operationId": "run-sync-lsdflying-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", "type": "array", "description": "Amazon merchant/seller IDs (e.g. A294P4X9EWVXLJ). Add the marketplace after a colon to override the default country: A1PY5LZZWKVRVS:DE, A1PY5LZZWKVRVS:FR.", "default": [ "A294P4X9EWVXLJ" ], "items": { "type": "string" } }, "sellerUrls": { "title": "Seller or storefront URLs", "type": "array", "description": "Seller profile URLs (amazon.de/sp?seller=...) or storefront URLs (amazon.com/s?me=...). The marketplace is read from the URL.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "asins": { "title": "ASINs (find seller from product page)", "type": "array", "description": "Product ASINs or product URLs. The Actor reads the seller(s) publicly shown in the product's buy box and scrapes their profiles. Use ASIN:COUNTRY (e.g. B088NRLMPV:US) to pick a marketplace. Best effort: products sold by Amazon or without a buy box have no third-party seller.", "default": [], "items": { "type": "string" } }, "country": { "title": "Default marketplace", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "NL", "SE", "PL", "BE", "CA", "MX", "BR", "JP", "AU", "IN", "AE", "SA", "SG", "TR" ], "type": "string", "description": "Marketplace used for seller IDs / ASINs without an explicit country.", "default": "US" }, "includeProducts": { "title": "Include storefront products", "type": "boolean", "description": "Open each seller's storefront to get the number of listed products and a sample of them (1 extra request per seller).", "default": true }, "maxProductsPerSeller": { "title": "Sample products per seller", "minimum": 0, "maximum": 16, "type": "integer", "description": "How many storefront products to include (max 16 from the first page).", "default": 5 }, "maxFeedbackPerSeller": { "title": "Recent feedback per seller", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of recent public feedback texts (rating, text, date) to include. Reviewer names are never collected.", "default": 5 }, "includeAboutSeller": { "title": "Include 'About seller' text", "type": "boolean", "description": "Add the seller's free-text 'About seller' section (phone numbers and emails are removed). It can contain names of individuals (e.g. managing directors) - only enable if you have a lawful basis to process them.", "default": false }, "maxItems": { "title": "Max sellers", "minimum": 1, "type": "integer", "description": "Stop after saving this many sellers.", "default": 10 }, "englishInterface": { "title": "Use English page version", "type": "boolean", "description": "Add language=en_* to page URLs on non-English marketplaces. Usually not needed (labels in German/French/Italian/Spanish are understood too).", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for requests (runs on your Apify account). Datacenter proxy (default) works for US seller pages. For EU marketplaces (DE, FR, IT, ES, UK, NL...) and JP, select RESIDENTIAL proxy group and set the proxy country to the marketplace country (e.g. DE for amazon.de) - datacenter IPs are often blocked there.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel requests. Keep low to avoid blocks.", "default": 2 }, "debugSaveHtml": { "title": "Debug: save HTML", "type": "boolean", "description": "Save the first 10 fetched pages to the key-value store (for troubleshooting).", "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 } } } } } } } } } }