SellerMagnet API for Amazon Sales Rank Monitoring

Building a Python Script to Monitor Amazon Sales Rank with SellerMagnet

By Alex Rodriguez | July 09, 2025

Python Web Scraping Amazon Ecommerce

Building a Python Script to Monitor Amazon Sales Rank with SellerMagnet

For Amazon businesses and market analysts, staying ahead of the competition requires constant monitoring of product performance. One of the most critical metrics is the Amazon Sales Rank (BSR), which provides insights into a product's popularity and sales velocity. In this post, we'll guide you through building a Python script that uses SellerMagnet's Amazon data API to automate this process, enabling you to track sales rank efficiently for competitive analysis, inventory management, and market research.

Why Monitor Amazon Sales Rank?

Amazon Sales Rank is a numerical indicator of how well a product is selling in its category. A lower BSR generally indicates higher sales. Monitoring BSR helps you:

  • Competitive Analysis: Identify trending products and analyze competitor performance.
  • Inventory Management: Optimize stock levels based on sales rank fluctuations.
  • Market Research: Understand market dynamics and identify potential opportunities.

Prerequisites

Before you begin, ensure you have the following:

  • Python 3.6 or higher installed.
  • A SellerMagnet API key.
  • The requests library installed (pip install requests).

Step-by-Step Guide

Let's build a Python script to fetch and monitor Amazon Sales Rank using SellerMagnet's API.

1. Import Libraries and Set Up Credentials

First, import the necessary libraries and set up your API key and the ASIN you want to monitor.


import requests
import json

API_KEY = 'YOUR_API_KEY'  # Replace with your actual API key
ASIN = 'B08N5WRWNW'  # Example ASIN
MARKETPLACE_ID = 'A1PA6795UKMFR9' # Example: Amazon.de

2. Define the API Request Function

Create a function to make the API request to Amazon Product Statistics endpoint.


def get_amazon_product_stats(asin, marketplace_id, api_key):
    url = 'https://sellermagnet-api.com/amazon-product-statistics'
    params = {
        'asin': asin,
        'marketplaceId': marketplace_id,
        'api_key': api_key
    }
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()  # Raise HTTPError for bad responses (4xx or 5xx)
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"API request failed: {e}")
        return None

3. Extract Sales Rank from the API Response

Implement a function to extract the Sales Rank from the JSON response.


def extract_sales_rank(json_response):
    if json_response and json_response['success']:
        return json_response['data']['bestSellerRank']
    else:
        print("Failed to retrieve sales rank.")
        return None

4. Main Script Execution

Combine the functions to fetch and print the sales rank.


if __name__ == '__main__':
    product_data = get_amazon_product_stats(ASIN, MARKETPLACE_ID, API_KEY)
    if product_data:
        sales_rank = extract_sales_rank(product_data)
        if sales_rank:
            print(f"The Sales Rank for ASIN {ASIN} is: {sales_rank}")

5. Complete Script

Here's the complete Python script:


import requests
import json

API_KEY = 'YOUR_API_KEY'  # Replace with your actual API key
ASIN = 'B08N5WRWNW'  # Example ASIN
MARKETPLACE_ID = 'A1PA6795UKMFR9' # Example: Amazon.de

def get_amazon_product_stats(asin, marketplace_id, api_key):
    url = 'https://sellermagnet-api.com/amazon-product-statistics'
    params = {
        'asin': asin,
        'marketplaceId': marketplace_id,
        'api_key': api_key
    }
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()  # Raise HTTPError for bad responses (4xx or 5xx)
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"API request failed: {e}")
        return None

def extract_sales_rank(json_response):
    if json_response and json_response['success']:
        return json_response['data']['bestSellerRank']
    else:
        print("Failed to retrieve sales rank.")
        return None

if __name__ == '__main__':
    product_data = get_amazon_product_stats(ASIN, MARKETPLACE_ID, API_KEY)
    if product_data:
        sales_rank = extract_sales_rank(product_data)
        if sales_rank:
            print(f"The Sales Rank for ASIN {ASIN} is: {sales_rank}")

6. Example Response

A sample response from the Amazon Product Statistics endpoint:


{
  "success": true,
  "data": {
    "asin": "B0CLTBHXWQ",
    "amazonPrice": 41800,
    "bestSellerRank": 15,
    "buyBoxPrice": 41800,
    "buyBoxFulfillment": "FBM",
    "buyBoxSellerIdHistory": [
      [
        "2025-06-14 17:08:00",
        "A2I59UVTUWUFH0"
      ]
    ],
    "salesRankHistory": [
      [
        "2025-06-14 01:58:00",
        15
      ]
    ],
    "trackingSince": "2023-12-30"
  }
}

7. Scheduling and Automation

To automate the monitoring process, you can use Python's sched library or a task scheduler like cron (on Linux) or Task Scheduler (on Windows) to run the script at specified intervals. Consider leveraging DataPipeline for more robust scheduling options.

Advanced Use Cases

  • Historical Data Analysis: Store the sales rank data in a database to analyze trends over time. SellerMagnet's Amazon Product Statistics endpoint provides historical sales rank data in the salesRankHistory field.
  • Alerting: Set up alerts to notify you when the sales rank of a product crosses a certain threshold, indicating a significant change in performance.
  • Competitor Tracking: Monitor the sales rank of competitor products to identify opportunities and threats.

Additional SellerMagnet Endpoints for Comprehensive Analysis

Enhance your Amazon monitoring strategy by integrating other SellerMagnet endpoints:

Conclusion

By building a Python script with SellerMagnet's Amazon data API, you can efficiently monitor Amazon Sales Rank, enabling informed decisions for competitive analysis, inventory management, and market research. Leverage the power of automation to stay ahead in the dynamic world of e-commerce. Explore Code Examples and Documentation for more ideas!

Don't have an API key yet? Try Free Today! You can also check our Pricing or Contact us for enterprise solutions.

Back to Blog