# Amazon Buy Box & Seller Offers Tracker API (`clearpath/amazon-buybox-api`) Actor Get all Amazon seller offers per ASIN with Buy Box winner, prices, FBA status, and stock data. Tracks price changes, buybox rotations, and new sellers across amazon.com, .de, .co.uk, .fr, .it, .es, .co.jp, .ca. Perfect for repricing and analytics. - **URL**: https://apify.com/clearpath/amazon-buybox-api.md - **Developed by:** [ClearPath](https://apify.com/clearpath) (community) - **Categories:** Developer tools, Automation, E-commerce - **Stats:** 7 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $24.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Amazon Buybox API | Track Seller Offers and Price Changes Across 8 Domains Extract every seller offer for any Amazon product — prices, conditions, fulfillment method, and buybox winner status. Supports amazon.com, .de, .fr, .co.uk, .it, .es, .co.jp, and .ca. Schedule recurring runs to detect price changes, new sellers, and buybox winner shifts automatically. Pass ASINs or full Amazon URLs. The Actor fetches all available offers, identifies the buybox winner, and returns structured data per offer. On scheduled runs, it compares against the previous state and flags what changed. #### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ```` clearpath/amazon-buybox-api on Apify. Call: ApifyClient("TOKEN").actor("clearpath/amazon-buybox-api").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items for results. Key inputs: productUrls (array of strings, required), amazonDomain (string, default "amazon.com"), condition (string, default "all"). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/clearpath~amazon-buybox-api/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Pricing: $29/month rental, unlimited ASINs and runs. Get token: https://console.apify.com/account/integrations ```` ### Rental Pricing **$29 per month** — unlimited ASINs, unlimited runs, no per-item fees. - Process any number of products per run - Run as often as you need - All 8 Amazon domains included - Built-in price change monitoring - Cancel anytime ### What Data You Get Each offer in the dataset includes: - **Price data** — current price, original/list price, currency, price delta vs last run - **Seller info** — seller name, seller ID, ships-from location, FBA status - **Buybox status** — whether this offer holds the buybox, and whether the winner changed - **Product context** — ASIN, condition (New, Used - Like New, Refurbished, etc.), total offer count - **Change tracking** — price changed flag, previous price, new seller flag, first-seen timestamp ### How Amazon Buybox Monitoring Works 1. **First run** — collects all offers and saves a snapshot per ASIN 2. **Subsequent runs** — compares current offers against the saved snapshot 3. **Change detection** — flags price changes (with delta), new sellers, and buybox winner switches 4. **Per-offer granularity** — tracks each seller's offer independently, even when a seller has multiple offers at different conditions Schedule runs hourly, daily, or weekly depending on how closely you need to track competition. ### Supported Amazon Domains | Domain | Country | Currency | |--------|---------|----------| | amazon.com | United States | USD ($) | | amazon.de | Germany | EUR (€) | | amazon.fr | France | EUR (€) | | amazon.co.uk | United Kingdom | GBP (£) | | amazon.it | Italy | EUR (€) | | amazon.es | Spain | EUR (€) | | amazon.co.jp | Japan | JPY (¥) | | amazon.ca | Canada | CAD ($) | Mix domains freely in one run — pass URLs from different Amazon sites and each product is fetched with the correct locale and proxy. ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `productUrls` | string[] | Yes | — | Amazon product URLs or bare ASINs. Domain auto-detected from URLs. | | `amazonDomain` | enum | No | amazon.com | Default domain for bare ASINs. Ignored when URLs contain a domain. | | `condition` | enum | No | all | Filter offers by condition: all, new, used, usedLikeNew, usedVeryGood, usedGood, usedAcceptable, collectible, refurbished. | | `maxOffersPerProduct` | integer | No | 0 | Max offers per ASIN. 0 = all offers. | | `proxyConfiguration` | object | No | Apify Residential | Proxy country auto-set from domain (.de → DE, .co.jp → JP). | ### Quick Start #### Single product ```json { "productUrls": ["B0DZZWMB2L"] } ```` #### Multiple products across domains ```json { "productUrls": [ "https://www.amazon.com/dp/B0DZZWMB2L", "https://www.amazon.de/dp/B0D1XD1ZV3", "https://www.amazon.co.jp/dp/B09LCHH618" ], "condition": "new", "maxOffersPerProduct": 10 } ``` #### Bare ASINs on a specific domain ```json { "productUrls": ["B0DZZWMB2L", "B0D1XD1ZV3", "B07ZPKN6YR"], "amazonDomain": "amazon.de", "condition": "all" } ``` ### Output #### Offer fields ```json { "asin": "B0DZZWMB2L", "condition": "New", "price": 1399.99, "originalPrice": 1499.99, "currency": "$", "sellerName": "Amazon.com", "sellerId": "ATVPDKIKX0DER", "shipsFrom": "Amazon.com", "isBuyboxWinner": true, "isFBA": true, "offerIndex": 0, "maxQuantity": 2, "offerId": "h%2F9gUZFb...", "totalOffersForProduct": 18, "amazonDomain": "amazon.com", "scrapedAt": "2026-02-27T12:43:36Z" } ``` #### Monitor fields (2nd+ run) On scheduled runs, every offer includes change tracking: ```json { "priceChanged": true, "previousPrice": 1499.99, "priceDelta": -100.0, "buyboxWinnerChanged": false, "previousBuyboxWinner": "Amazon.com", "isNewSeller": false, "firstSeenAt": "2026-02-25T08:00:00Z" } ``` | Field | Type | Description | |-------|------|-------------| | `priceChanged` | boolean | Whether this seller's price changed since last run | | `previousPrice` | number | Last known price for this seller + condition | | `priceDelta` | number | Price difference. Negative = price drop. | | `buyboxWinnerChanged` | boolean | Whether the buybox winner is a different seller | | `previousBuyboxWinner` | string | Seller name of the previous buybox holder | | `isNewSeller` | boolean | First time this seller appears for this ASIN | | `firstSeenAt` | string | ISO timestamp when the seller was first observed | ### Use Cases #### For Amazon Sellers - **Track competitor pricing** — monitor every seller on your listing, detect undercuts within hours - **Buybox win rate** — log buybox winner changes over time to understand rotation patterns - **Repricer validation** — verify your repricing tool is working by comparing expected vs actual prices #### For E-commerce Analysts - **Cross-market pricing** — compare the same ASIN across US, EU, UK, and JP simultaneously - **Seller landscape** — identify how many sellers compete per product, FBA vs FBM distribution - **Price history** — schedule daily runs to build a price trend dataset #### For Arbitrage and Resale - **Price gap detection** — spot products priced differently across Amazon domains - **New seller alerts** — detect when new sellers enter a listing (often signals supply changes) - **Condition-based analysis** — track used/refurbished pricing separately from new offers ### How to Extract Amazon Buybox Data with Python ```python from apify_client import ApifyClient client = ApifyClient("your_api_token") run = client.actor("clearpath/amazon-buybox-api").call(run_input={ "productUrls": ["B0DZZWMB2L", "B0D1XD1ZV3"], "condition": "new" }) for offer in client.dataset(run["defaultDatasetId"]).iterate_items(): if offer["isBuyboxWinner"]: print(f"{offer['asin']}: {offer['sellerName']} @ {offer['currency']}{offer['price']}") ``` ### How to Extract Amazon Buybox Data with JavaScript ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'your_api_token' }); const run = await client.actor('clearpath/amazon-buybox-api').call({ productUrls: ['B0DZZWMB2L', 'B0D1XD1ZV3'], condition: 'new', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.filter(i => i.isBuyboxWinner).forEach(offer => { console.log(`${offer.asin}: ${offer.sellerName} @ ${offer.currency}${offer.price}`); }); ``` ### Advanced Usage #### Monitor buybox changes on a schedule Set up a daily schedule in the Apify Console. On each run, the Actor loads the previous state and enriches every offer with change flags. Filter the dataset for `buyboxWinnerChanged: true` to see only products where the winner shifted. ```json { "productUrls": ["B0DZZWMB2L", "B0D1XD1ZV3", "B0CL61F39H"], "condition": "new" } ``` #### Filter by condition to track used market ```json { "productUrls": ["B0DZZWMB2L"], "condition": "usedLikeNew" } ``` #### Cap offers per product When a listing has 50+ sellers and you only need the top offers: ```json { "productUrls": ["B0DZZWMB2L"], "maxOffersPerProduct": 5 } ``` ### Data Export Export results from the Apify Console or API in: - **JSON** — structured data for programmatic use - **CSV** — spreadsheet analysis and reporting - **Excel** — pivot tables, charting, dashboards ### Proxy Configuration The Actor uses residential proxies by default. Proxy country is auto-matched to the Amazon domain — .de routes through Germany, .co.jp through Japan, etc. Default configuration (recommended): ```json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` ### FAQ **How many products can I process per run?** No limit. Pass as many ASINs or URLs as you need. Each product is processed sequentially. **How many offers does it return per product?** All of them by default. Amazon shows up to 10 offers per page; the Actor paginates through all pages automatically. Use `maxOffersPerProduct` to cap if needed. **Does it work for products with no buybox?** Yes. If no buybox winner exists, all offers are returned with `isBuyboxWinner: false`. **What happens if a product has zero offers?** It's skipped gracefully. No error, no empty record in the dataset. **Are prices in local currency?** Yes. amazon.de returns EUR, amazon.co.jp returns JPY, amazon.co.uk returns GBP, etc. The `currency` field tells you which. **How does change tracking work?** The Actor stores a snapshot after each run in a named key-value store. On the next run, it compares current offers against the snapshot by offer ID. Only real changes are flagged — same data across runs produces `priceChanged: false` for every offer. **Is condition text normalized across languages?** Yes. German "Neu", French "Neuf", Japanese "新品" are all normalized to "New". Used sub-conditions are normalized too (e.g., "Usato - Come nuovo" becomes "Used - Like New"). **Can I mix domains in one run?** Yes. Pass full URLs from different Amazon sites. Each URL is processed with the correct locale, currency, and proxy country. ### Support - **Email**: max@mapa.slmail.me - **Bugs and feature requests**: Issues tab on this Actor's page # Actor input Schema ## `productUrls` (type: `array`): Amazon product URLs or ASINs. Accepts full URLs (https://www.amazon.de/dp/B0DZZWMB2L) or bare ASINs (B0DZZWMB2L). Domain is auto-detected from URLs. ## `amazonDomain` (type: `string`): Default Amazon domain for bare ASINs. Ignored when input contains full URLs (domain extracted automatically). ## `condition` (type: `string`): Filter offers by product condition ## `maxOffersPerProduct` (type: `integer`): Maximum number of offers to collect per ASIN. 0 = collect all offers. ## `proxyConfiguration` (type: `object`): Proxy country is auto-set based on Amazon domain (.de → DE, .co.jp → JP, etc.) ## Actor input object example ```json { "productUrls": [ "https://www.amazon.com/dp/B0DZZWMB2L", "B0D1XD1ZV3" ], "amazonDomain": "amazon.com", "condition": "all", "maxOffersPerProduct": 0, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "productUrls": [ "B0DZZWMB2L" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("clearpath/amazon-buybox-api").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "productUrls": ["B0DZZWMB2L"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("clearpath/amazon-buybox-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "productUrls": [ "B0DZZWMB2L" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call clearpath/amazon-buybox-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=clearpath/amazon-buybox-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Amazon Buy Box & Seller Offers Tracker API", "description": "Get all Amazon seller offers per ASIN with Buy Box winner, prices, FBA status, and stock data. Tracks price changes, buybox rotations, and new sellers across amazon.com, .de, .co.uk, .fr, .it, .es, .co.jp, .ca. Perfect for repricing and analytics.", "version": "0.0", "x-build-id": "TqBUWPp9Bga81drMA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clearpath~amazon-buybox-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clearpath-amazon-buybox-api", "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/clearpath~amazon-buybox-api/runs": { "post": { "operationId": "runs-sync-clearpath-amazon-buybox-api", "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/clearpath~amazon-buybox-api/run-sync": { "post": { "operationId": "run-sync-clearpath-amazon-buybox-api", "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": [ "productUrls" ], "properties": { "productUrls": { "title": "Product URLs or ASINs", "type": "array", "description": "Amazon product URLs or ASINs. Accepts full URLs (https://www.amazon.de/dp/B0DZZWMB2L) or bare ASINs (B0DZZWMB2L). Domain is auto-detected from URLs.", "items": { "type": "string" } }, "amazonDomain": { "title": "Amazon Domain", "enum": [ "amazon.com", "amazon.de", "amazon.fr", "amazon.co.uk", "amazon.it", "amazon.es", "amazon.co.jp", "amazon.ca" ], "type": "string", "description": "Default Amazon domain for bare ASINs. Ignored when input contains full URLs (domain extracted automatically).", "default": "amazon.com" }, "condition": { "title": "Condition Filter", "enum": [ "all", "new", "used", "usedLikeNew", "usedVeryGood", "usedGood", "usedAcceptable", "collectible", "refurbished" ], "type": "string", "description": "Filter offers by product condition", "default": "all" }, "maxOffersPerProduct": { "title": "Max offers per product", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum number of offers to collect per ASIN. 0 = collect all offers.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy country is auto-set based on Amazon domain (.de → DE, .co.jp → JP, etc.)" } } }, "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 } } } } } } } } } } ```