{
"openapi": "3.0.1",
"info": {
"title": "Amazon Buy Box & Price Monitor 📦 (with seller ID check)",
"description": "Watch the Buy Box on any Amazon listing: live price, who is winning it, who fulfils it and whether stock moved, with a change record whenever one shifts. On EU marketplaces it also reads the seller identity Amazon must publish and checks it against the official VAT and company registers.",
"version": "0.1",
"x-build-id": "jiW45RB9eWbDgYhP1"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~amazon-product-monitor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-amazon-product-monitor",
"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-product-monitor/runs": {
"post": {
"operationId": "runs-sync-tagadanar-amazon-product-monitor",
"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-product-monitor/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-amazon-product-monitor",
"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": {
"asins": {
"title": "ASINs to watch",
"type": "array",
"description": "One ASIN per line, e.g. B00PGB7OKM. They are read on the marketplace chosen below. Each one returns the live Buy Box price, who is winning the Buy Box, who fulfils it, stock wording, rating, review count and Best Sellers Rank.",
"items": {
"type": "string"
}
},
"productUrls": {
"title": "Product URLs",
"type": "array",
"description": "Full Amazon product links, e.g. https://www.amazon.de/dp/B0DK955V6Z. Each URL keeps its own marketplace, so you can watch the same product on amazon.com and amazon.de in one run.",
"items": {
"type": "string"
}
},
"searchQueries": {
"title": "Search keywords",
"type": "array",
"description": "Keywords to run through Amazon search, e.g. wireless mouse. You get the ranked results with position, price, rating, review count and whether the slot is sponsored, which is how you track where a product sits against its competitors.",
"items": {
"type": "string"
}
},
"sellerIds": {
"title": "Sellers to verify by ID",
"type": "array",
"description": "Check a seller's identity without going through a product page. One entry per line: a seller ID (A3GX1RCD4Z9H04), a marketplace and ID together (de:A3GX1RCD4Z9H04), or a pasted storefront link (https://www.amazon.de/sp?seller=A3GX1RCD4Z9H04). A bare ID uses the marketplace chosen below. Each one returns a seller record with the legal identity Amazon publishes and the register check on it. Use this when you already know which sellers you care about, or when a run does not see a third-party Buy Box to start from.",
"items": {
"type": "string"
}
},
"marketplace": {
"title": "Marketplace",
"enum": [
"com",
"co.uk",
"de",
"fr",
"it",
"es"
],
"type": "string",
"description": "Which Amazon site the ASINs and keywords are read on. Product URLs override this per URL.",
"default": "com"
},
"maxResultsPerQuery": {
"title": "Max results per keyword",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Stop after this many search results for each keyword. You are only charged for results actually delivered.",
"default": 40
},
"verifySeller": {
"title": "Verify who the seller really is",
"type": "boolean",
"description": "For each third-party seller holding the Buy Box, open their storefront, read the legal identity EU law makes Amazon publish (business name, registered address, VAT number, trade register number) and check it against an official register: the EU VAT system for amazon.de/fr/it/es, the French company register, or Companies House for amazon.co.uk. You find out whether the \"German\" seller is a company in Shenzhen. Billed per seller checked, and only when a storefront was actually read.",
"default": false
},
"monitorMode": {
"title": "Track changes between runs",
"type": "boolean",
"description": "Remember each product's price, Buy Box seller and stock, and return an extra change record whenever one of them moves. The first run records the starting state; schedule the actor daily and later runs tell you what moved.",
"default": false
},
"onlyChanges": {
"title": "Only return products that changed",
"type": "boolean",
"description": "With change tracking on, leave out every product whose price, Buy Box seller and stock are all unchanged since the last run, so a 500-product watchlist returns a short list instead of 500 rows. Turning this on turns change tracking on.",
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}