# Free Amazon Sales History & Analytics (`easyparser/amazon-sales-history`) Actor Retrieve Amazon product sales history, traffic, BSR trends, price history, and offer count data for up to 12 months. Powered by Easyparser real-time API. - **URL**: https://apify.com/easyparser/amazon-sales-history.md - **Developed by:** [Easyparser](https://apify.com/easyparser) (community) - **Categories:** E-commerce - **Stats:** 29 total users, 5 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ## Free Amazon Sales History & Analytics Retrieve Amazon product sales history, traffic data, BSR trends, price history, and offer count changes for up to 12 months. Powered by [Easyparser's](https://easyparser.com) real-time Amazon Sales Analysis API. > **No API key required to get started.** This actor includes a shared demo key so you can try it immediately. For higher limits and bulk processing, [sign up free at Easyparser](https://app.easyparser.com/signup). *** ### What This Actor Returns A single dataset item per run containing the full product snapshot and weekly historical data: **Product Snapshot:** - ASIN, name, brand, category, marketplace, currency - Launch date and product age - Physical dimensions and weight - Traffic: total views, views last 30/90/360 days, month-over-month change - Sales: purchases last 30/90/360 days - Pricing: 90-day and 360-day average prices, FBA fees, referral fees, offer min/max prices - Reviews: total count and average rating - Ranking: current BSR, average BSR, category **Weekly History Array** (per week, up to 52 entries for 12 months): - `date` - week start date - `views` - weekly traffic - `purchases` - weekly units sold - `average_price` - average Buy Box price that week - `total_offers` - number of active sellers - `best_seller_rank` - BSR that week - `review_count` - new reviews that week - `review_rating` - average rating of new reviews *** ### How to Use #### Option A - Try It Now (No Sign-Up) Fill in the `asin`, `domain`, and `history_range` fields and run. A shared Easyparser key is built in. #### Option B - Use Your Own API Key (Recommended for Scale) 1. Sign up free at [app.easyparser.com/signup](https://app.easyparser.com/signup) - **100 free credits/month**, no credit card required 2. Copy your API key from the [Plan Page](https://app.easyparser.com/account/plan) 3. Paste it into the `api_key` field *** ### Input Fields | Field | Required | Default | Description | |-------|----------|---------|-------------| | `asin` | Yes | | Amazon ASIN (e.g., `B00KTLXB4C`) | | `domain` | Yes | | Amazon marketplace (e.g., `.com`, `.co.uk`, `.de`) | | `history_range` | Yes | `3` | Months of history: `0`, `3`, `6`, `9`, or `12` | | `api_key` | No | shared demo key | Your personal Easyparser API key | #### Credit Consumption | history\_range | Data Retrieved | Credits Used | |---------------|---------------|--------------| | `0` | Current snapshot only | 5 credits | | `3` | Last 3 months (13 weeks) | 8 credits | | `6` | Last 6 months (26 weeks) | 11 credits | | `9` | Last 9 months (39 weeks) | 14 credits | | `12` | Last 12 months (52 weeks) | 17 credits | *** ### Example **Input:** ```json { "asin": "B00KTLXB4C", "domain": ".com", "history_range": "3" } ``` **Output (truncated):** ```json { "asin": "B00KTLXB4C", "name": "NIVEA Cocoa Butter Body Lotion...", "brand": "NIVEA", "category": "Skin Care/Body/Moisturizers", "launch_date": "2014-06-20T00:00:00.000Z", "traffic": { "views_last_30_days": 27344, "views_last_90_days": 53219, "month_over_month_change": 1.56 }, "sales": { "purchases_last_30_days": 7944, "purchases_last_90_days": 15461 }, "average_price_last_90_days": 15.82, "reviews": { "total_count": 4360, "average_rating": 4.8 }, "ranking": { "current_rank": 32, "category": "Lotions" }, "history": [ { "date": "2025-12-28T00:00:00.000Z", "views": 10674, "purchases": 3100, "average_price": 7.04, "total_offers": 14, "best_seller_rank": 62, "review_count": 0, "review_rating": 0 } ], "history_weeks": 13, "history_range_months": 3 } ``` *** ### Use Cases - **Demand Validation**: Compare views vs purchases to assess conversion quality before sourcing - **Price & BSR Trend Analysis**: Track whether current pricing reflects stable demand or short-term spikes - **Competitor Monitoring**: Audit competitor growth velocity, launch strategy, and pricing evolution - **Seasonality Detection**: Identify recurring demand cycles from weekly historical data - **BI Dashboards & Forecasting**: Feed structured JSON into analytics pipelines and visualization tools - **Product Lifecycle Visualization**: Plot launch momentum, saturation, decline, and revival phases - **Inventory & Turnover Optimization**: Calculate precise restock dates from sales velocity trends - **Wholesale & Arbitrage Scouting**: Monitor offer count history to detect saturation and hijacker spikes - **Launch Strategy Engineering**: Decode competitor launch trajectories from BSR history - **Promotional Impact Analysis**: Track view and purchase spikes during Lightning Deals and coupons *** ### Need More? For **better pricing**, **higher limits**, and **dedicated throughput**: - 🚀 [Sign Up Free](https://app.easyparser.com/signup) - 100 credits/month, no credit card - 💰 [View Pricing Plans](https://easyparser.com/pricing) - 🎮 [Try the API Playground](https://app.easyparser.com/playground) - 📄 [Full Documentation](https://easyparser.gitbook.io/easyparser-documentation/real-time-integration/sales-analysis-and-history) *** ### Related Actors - [Free Amazon Product Detail Scraper](https://apify.com/easyparser/amazon-product-detail): Full product data including title, price, ratings, images, specifications, and variants - [Free Amazon Product Offers Scraper](https://apify.com/easyparser/amazon-product-offers): All seller offers with pricing, Buy Box winner, and fulfillment details - [Free Amazon Search Results Scraper](https://apify.com/easyparser/amazon-search-results): Ranked Amazon listings with prices, ratings, sponsored flags, and refinements - [Free Amazon Package Dimensions and Shipping Weight](https://apify.com/easyparser/amazon-package-dimensions): Package dimensions, shipping weight, FBA fee category *** ### About Easyparser [Easyparser](https://easyparser.com) is a real-time Amazon scraping API built for developers and data teams. No IP blocks, no CAPTCHAs, fast response times. # Actor input Schema ## `asin` (type: `string`): The Amazon Standard Identification Number of the product to analyze. Example: B00KTLXB4C ## `domain` (type: `string`): The Amazon marketplace to query. ## `history_range` (type: `string`): Number of months of historical weekly data to retrieve. 0 returns current snapshot only (5 credits). 3 months = 8 credits, 6 months = 11 credits, 9 months = 14 credits, 12 months = 17 credits. ## `api_key` (type: `string`): Your personal Easyparser API key for higher request limits. Leave empty to use the shared demo key (limited usage). Get your own free key at https://app.easyparser.com/signup - 100 free credits/month, no credit card required. ## Actor input object example ```json { "asin": "B00KTLXB4C", "domain": ".com", "history_range": "12" } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing the product snapshot and full weekly history array with views, purchases, average\_price, best\_seller\_rank, total\_offers, review\_count, and review\_rating per week. # 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 = { "asin": "B0FC5SJNQX", "domain": ".com", "history_range": "12" }; // Run the Actor and wait for it to finish const run = await client.actor("easyparser/amazon-sales-history").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 = { "asin": "B0FC5SJNQX", "domain": ".com", "history_range": "12", } # Run the Actor and wait for it to finish run = client.actor("easyparser/amazon-sales-history").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "asin": "B0FC5SJNQX", "domain": ".com", "history_range": "12" }' | apify call easyparser/amazon-sales-history --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,easyparser/amazon-sales-history" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/halbkUPLQ0831pRz5/builds/ng3ddS0qRnyu6w0xJ/openapi.json