{ "openapi": "3.0.1", "info": { "title": "Amazon Seller & Brand Intel - Sellers, Offers, Sales Estimates", "description": "Amazon seller and brand intelligence: seller storefront records, product offers, brand audits, and modeled sales estimates from public listing signals. For brand owners, agencies, and investors - the Jungle Scout/Helium 10 intel layer, priced per record.", "version": "0.1", "x-build-id": "WkR4k2xq92kC782FV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seibs.co~amazon-seller-intel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seibs.co-amazon-seller-intel", "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/seibs.co~amazon-seller-intel/runs": { "post": { "operationId": "runs-sync-seibs.co-amazon-seller-intel", "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/seibs.co~amazon-seller-intel/run-sync": { "post": { "operationId": "run-sync-seibs.co-amazon-seller-intel", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "seller_profile", "asin_offers", "brand_audit", "seller_monitor" ], "type": "string", "description": "seller_profile = seller ids / storefront URLs -> seller records (name, published business name + address, rating %, ratings count, Just-Launched flag). asin_offers = ASINs -> product summary + one offer record per All-Offers-Display offer (seller, price+shipping, condition, FBA/FBM/AMZ, Buy Box winner) + a BSR-based sales estimate per ASIN. brand_audit = brand names -> sampled products -> one aggregate brand record (distinct sellers + est share, price dispersion, Buy-Box control %, total est monthly sales band) - the brand-protection record. seller_monitor = a seller-id watchlist for Apify Schedules (rating / catalog deltas).", "default": "seller_profile" }, "seller_ids": { "title": "Seller ids or storefront / profile URLs", "maxItems": 25, "type": "array", "description": "Amazon seller ids (the 13-14 char alphanumeric token like A2R2RITDJNW1Q6) or full sp?seller= / storefront s?me= URLs. Used by seller_profile and seller_monitor. Find the id in any 'Sold by' link or a storefront URL. Hard cap of 25.", "default": [], "items": { "type": "string" } }, "asins": { "title": "ASINs", "maxItems": 100, "type": "array", "description": "Amazon ASINs (10-char product ids, e.g. B07ZPKBL9V) or /dp/ URLs. Used by asin_offers. Each ASIN returns a product summary, its All-Offers-Display offers, and a BSR-based sales estimate. Hard cap of 100.", "default": [], "items": { "type": "string" } }, "brands": { "title": "Brand names", "maxItems": 10, "type": "array", "description": "Brand names to audit, e.g. ['Anker', 'AcmeBasics']. Used by brand_audit. Each brand is searched, up to max_products_per_brand products are sampled, and one aggregate brand record is produced (distinct sellers, price dispersion, Buy-Box control, est monthly sales band). Hard cap of 10.", "default": [], "items": { "type": "string" } }, "marketplace": { "title": "Marketplace", "enum": [ "com", "co.uk", "de", "ca" ], "type": "string", "description": "Which Amazon marketplace to query. com = amazon.com (US), co.uk = amazon.co.uk, de = amazon.de, ca = amazon.ca. URLs and currency are built per marketplace.", "default": "com" }, "max_products_per_brand": { "title": "Max products sampled per brand", "minimum": 1, "maximum": 48, "type": "integer", "description": "brand_audit: how many products to sample per brand from the search results. More products = a more representative seller map and sales band, but more residential bandwidth. Default 16, hard cap 48.", "default": 16 }, "max_offers_per_asin": { "title": "Max offers per ASIN", "minimum": 1, "maximum": 20, "type": "integer", "description": "asin_offers / brand_audit: how many offers to keep per product from the All Offers Display (the Buy Box winner is always first). Default 10, hard cap 20.", "default": 10 }, "monitor_webhook_url": { "title": "Monitor webhook URL (Slack / email, optional)", "type": "string", "description": "When this actor runs under an Apify Schedule (seller_monitor), post the change digest (rating / catalog deltas) to this Slack-compatible webhook URL.", "default": "" }, "use_apify_proxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route requests through Apify Proxy. Strongly recommended - Amazon blocks datacenter and unproxied traffic aggressively. Leave on.", "default": true }, "apify_proxy_groups": { "title": "Proxy groups", "type": "array", "description": "Apify Proxy groups. RESIDENTIAL is the default and the realistic choice - Amazon is among the most bot-protected sites and routinely blocks DATACENTER. Residential bandwidth is the main cost driver of this actor (see the README).", "default": [ "RESIDENTIAL" ], "items": { "type": "string" } }, "concurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 3, "type": "integer", "description": "Parallel Amazon fetches. Kept low on purpose - high concurrency trips Amazon's bot protection and wastes bandwidth on blocks. Default 2, hard cap 3.", "default": 2 } } }, "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 } } } } } } } } } }