Building a SellerMagnetAPI Tool for Amazon Category Penetration Analysis
Amazon is a vast and competitive marketplace. For businesses looking to thrive, understanding category penetration is crucial. This involves analyzing product performance, seller activity, and overall market trends within specific Amazon categories. Building a custom tool using the SellerMagnet API provides a powerful, enterprise-grade solution for in-depth category analysis.
SellerMagnet (https://sellermagnet-api.com) offers an enterprise-grade Amazon data API designed for businesses focused on competitive analysis, inventory management, and comprehensive market research. This blog post will guide you through creating a tool to analyze Amazon category penetration using SellerMagnet's powerful API.
Why Build a Custom Category Penetration Analysis Tool?
Off-the-shelf solutions often lack the flexibility and granularity needed for specific business requirements. A custom tool, powered by the SellerMagnet API, allows you to:
- Tailor data extraction: Focus on the exact metrics that matter most to your business.
- Automate data collection: Schedule regular data pulls for continuous market monitoring using a DataPipeline.
- Integrate with existing systems: Seamlessly incorporate Amazon data into your internal dashboards and reporting tools.
- Gain a competitive edge: Uncover hidden opportunities and make data-driven decisions faster.
Key Features of a Category Penetration Analysis Tool
A comprehensive category penetration analysis tool should include these features:
- Product Performance Tracking: Monitor sales rank, review counts, and pricing trends for top products in a category.
- Seller Analysis: Identify key sellers and analyze their review history and product offerings.
- Market Trend Identification: Track pricing fluctuations, identify emerging product trends, and assess overall category competitiveness.
- Bestseller Analysis: Determine top-selling product using Amazon Bestsellers endpoint.
Leveraging SellerMagnet’s API for Category Penetration
SellerMagnet's API provides several key endpoints that are instrumental in building your analysis tool.
1. Identifying Products within a Category
Begin by identifying relevant products within a target category. You can use the Amazon Search endpoint to retrieve a list of products based on category-specific keywords.
curl --location --request GET 'https://sellermagnet-api.com/amazon-search?q=Playstation%205&marketplaceId=ATVPDKIKX0DER&api_key=YOUR_API_KEY'
This call searches for "Playstation 5" in the US marketplace. The searchResults array in the response contains ASINs of relevant products. A sample response is as follows:
{
"data": {
"searchResults": [
{
"asin": "B0CL5KNB9M",
"discount_info": "",
"link": "https://www.amazon.com/dp/B0CL5KNB9M",
"listingPrice": {
"price": {
"currency_code": "USD",
"currency_name": "United States Dollar",
"currency_symbol": "$",
"total": "449.00"
}
},
"mainImage": "https://m.media-amazon.com/images/I/51fM0CKG+HL._AC_UY218_.jpg",
"on_sale": false,
"position": 1,
"productTitle": "PlayStation®5 Digital Edition (slim)",
"reviewAmount": 7209,
"reviewRating": 4.7,
"sponsored": false
},
// More search results...
]
},
"success": true
}
2. Analyzing Product Statistics
Once you have a list of ASINs, use the Amazon Product Statistics endpoint to gather detailed information about each product. This includes sales rank, pricing history, and review data.
curl --location --request GET 'https://sellermagnet-api.com/amazon-product-statistics?asin=B0CL61F39H&marketplaceId=ATVPDKIKX0DER&api_key=YOUR_API_KEY'
This API call retrieves statistics for the product with ASIN "B0CL61F39H" in the US marketplace. The response includes crucial data for category penetration analysis, such as bestSellerRank, buyBoxPrice, and historical salesRankHistory. A sample response is as follows:
{
"data": {
"asin": "B0CLTBHXWQ",
"productTitle": "Playstation 5 Console Edizione Digital Slim",
"buyBoxPrice": 41800,
"buyBoxFulfillment": "FBM",
"buyBoxSellerIdHistory": [
[
"2025-06-14 17:08:00",
"A2I59UVTUWUFH0"
]
],
"categoryTree": [
{
"catId": 412603031,
"name": "Videogiochi"
},
{
"catId": 20904349031,
"name": "PlayStation 5"
},
{
"catId": 20904364031,
"name": "Console"
}
],
"graphs": {
"amazonAsSellerPriceHistory": "https://sellermagnet-api-webspace.s3.eu-central-1.amazonaws.com/amazon/api/charts/B0CLTBHXWQ/1749913774/B0CLTBHXWQ_amazon_price_1749913773.png",
"lowestFBAPriceHistory": "https://sellermagnet-api-webspace.s3.eu-central-1.amazonaws.com/amazon/api/charts/B0CLTBHXWQ/1749913776/B0CLTBHXWQ_fba_price_1749913773.png",
"lowestFBMPriceHistory": "https://sellermagnet-api-webspace.s3.eu-central-1.amazonaws.com/amazon/api/charts/B0CLTBHXWQ/1749913775/B0CLTBHXWQ_fbm_price_1749913773.png",
"monthlySoldHistory": "https://sellermagnet-api-webspace.s3.eu-central-1.amazonaws.com/amazon/api/charts/B0CLTBHXWQ/1749913778/B0CLTBHXWQ_monthly_sold_1749913773.png",
"productRatingHistory": "https://sellermagnet-api-webspace.s3.eu-central-1.amazonaws.com/amazon/api/charts/B0CLTBHXWQ/1749913777/B0CLTBHXWQ_rating_1749913773.png"
},
"listedSince": "2023-12-30 01:00:00",
"lowestFBAPrice": 44999,
"lowestFBMPrice": 41700,
"marketplaceId": "APJ6JRA9NG5V4",
"marketplaceNewPriceHistory": [
[
"2025-06-14",
41700
]
],
"offers": {
"A11IL2PNWYJU7H": {
"isFBA": true,
"lastUpdated": "2025-06-14 17:08:00",
"priceHistory": [
[
"2025-06-14 06:22:00",
44999,
0
]
],
"stockHistory": [
[
"2025-05-29 11:32:00",
1
]
]
},
},
"productReviewAverage": 4.7,
"productTotalReviews": 3129,
"rootCategory": {
"id": 412603031,
"name": "Videogiochi"
},
"stats": {
"amazonAsSellerPriceHistory": [
[
"2025-06-14",
44999
]
],
"buyBoxPriceHistory": [
[
"2025-06-13",
41700
]
],
"monthlySoldHistory": [
[
"2025-06",
1000
]
],
"productRatingCountHistory": [
[
"2025-06-14 15:28:00",
3129
]
],
"productRatingHistory": [
[
"2025-02-02 01:30:00",
4.7
]
],
"salesRankHistory": [
[
"2025-06-14 01:58:00",
15
]
]
}
},
"success": true
}
3. Evaluating Seller Performance
Identify the top sellers in a category and analyze their performance using the Amazon Seller Review endpoint. This allows you to assess seller reputation and customer satisfaction.
curl --location --request GET 'https://sellermagnet-api.com/amazon-seller-review?sellerId=A1CWSGXIR635I6&marketplaceId=ATVPDKIKX0DER&api_key=YOUR_API_KEY'
This call retrieves reviews for the seller with ID "A1CWSGXIR635I6" in the US marketplace. Key metrics include average ratings over different time periods and recent customer reviews. A sample response is as follows:
{
"data": {
"marketplace": {
"ATVPDKIKX0DER": {
"last5Reviews": [
{
"dateRated": "By gary kraus on June 5, 2025.",
"reviewText": "great",
"starRating": "5 out of 5 stars"
},
// More reviews...
],
"sellerFeedback": {
"30": {
"rating": "3.3",
"reviewsCount": "7"
},
"90": {
"rating": "3.6",
"reviewsCount": "30"
},
"365": {
"rating": "3.9",
"reviewsCount": "114"
},
"lifetime": {
"rating": "4.5",
"reviewsCount": "1,535"
}
}
}
},
"sellerId": "A1CWSGXIR635I6"
},
"success": true
}
4. Monitoring Product Offers
Track product availability, pricing, and seller information using the Amazon Product Offers endpoint. This is critical for understanding competitive pricing dynamics.
curl --location --request GET 'https://sellermagnet-api.com/amazon-product-offers?asin=B0CL61F39H&marketplaceId=ATVPDKIKX0DER&api_key=YOUR_API_KEY'
This API call retrieves offers for the product with ASIN "B0CL61F39H" in the US marketplace. The response includes buy box information, currency details, and a list of offers from different sellers with their respective pricing, fulfillment types, and inventory levels. A sample response is as follows:
{
"data": {
"asin": "B0CL61F39H",
"buyBox": {
"condition": "New",
"deliveryDate": "2025-06-28",
"fulfillmentType": "FBA",
"inventory": 30,
"positivePercentage": 0,
"priceWithoutShipping": 499,
"sellerId": "Amazon",
"sellerName": "Amazon",
"shippingPrice": 0,
"totalPrice": 499,
"totalReviews": 0
},
"currency": {
"code": "USD",
"name": "United States Dollar",
"symbol": "$"
},
"marketplaceId": "ATVPDKIKX0DER",
"offers": [
{
"condition": "New",
"deliveryDate": "2025-06-28",
"fulfillmentType": "FBA",
"inventory": 30,
"positivePercentage": 0,
"priceWithoutShipping": 499,
"sellerId": "Amazon",
"sellerName": "Amazon",
"shippingPrice": 0,
"totalPrice": 499,
"totalReviews": 0
},
// More offers...
],
"productLink": "https://www.amazon.com/dp/B0CL61F39H",
"productMainImage": "https://m.media-amazon.com/images/I/31kTNmpm6vL.jpg",
"productTitle": "PlayStation®5 console (slim)"
},
"success": true
}
5. Finding Product Details
Retrieve detailed product information, including descriptions, images, and variations, using the Amazon Product Lookup endpoint.
curl --location --request GET 'https://sellermagnet-api.com/amazon-product-lookup?asin=B0CL61F39H&marketplaceId=ATVPDKIKX0DER&api_key=YOUR_API_KEY'
This API call fetches detailed product information for the specified ASIN in the US marketplace, providing data such as title, description, bullet points, images, and bestsellers ranks. A sample response is as follows:
{
"data": {
"productInfo": {
"additionalDetails": {
"ASIN": "B0CL61F39H",
"Batteries": "1 Lithium Ion batteries required. (included)",
"Best Sellers Rank": "Nr. 31 in Video Games Nr. 1 in PlayStation 5 Consoles",
"Customer Rating": "4.7 out of 5 stars",
"Date First Available": "December 10, 2023",
"Item Weight": "10.6 pounds",
"Item model number": "CFI-2015",
"Manufacturer": "Sony",
"Number of Reviews": "7,092 ratings",
"Product Dimensions": "14 x 17 x 7 inches; 10.6 Pounds",
"Release date": "December 10, 2023",
"Type of item": "Video Game"
},
"asin": "B0CL61F39H",
"bestsellerRanks": {
"main_category": {
"name": "Video Games",
"rank": 31
},
"subcategory": {
"name": "PlayStation",
"rank": 1
}
},
"bulletPoints": [
"Model Number CFI-2000",
"Includes DualSense Wireless Controller, 1TB SSD, Disc Drive, 2 Horizontal Stand Feet, HDMI Cable, AC power cord, USB cable, printed materials, ASTRO’s PLAYROOM (Pre-installed game)",
"Vertical Stand sold separately"
],
"buyBoxInfo": {
"currencyCode": "USD",
"currencyName": "United States Dollar",
"currencySymbol": "$",
"price": 444.99,
"sellerId": "A3853PJW50SJG8"
},
"categories": {
"bestsellerCategory": [
{
"id": "20972781011",
"index": 1,
"name": "PlayStation 5",
"url": "https://www.amazon.com/b/ref=dp_bc_2?ie=UTF8&node=20972781011"
},
{
"id": "20972796011",
"index": 2,
"name": "Consoles",
"url": "https://www.amazon.com/b/ref=dp_bc_3?ie=UTF8&node=20972796011"
}
],
"rootCategory": {
"id": "468642",
"name": "Video Games",
"url": "https://www.amazon.com/computer-video-games-hardware-accessories/b/ref=dp_bc_1?ie=UTF8&node=468642"
}
},
"description": [
"Model Number CFI-2000",
"Includes DualSense Wireless Controller, 1TB SSD, Disc Drive, 2 Horizontal Stand Feet, HDMI Cable, AC power cord, USB cable, printed materials, ASTRO’s PLAYROOM (Pre-installed game)",
"Vertical Stand sold separately",
"The PS5 console unleashes new gaming possibilities that you never anticipated. Experience lightning fast loading with an ultra-high speed SSD, deeper immersion with support for haptic feedback, adaptive triggers, and 3D Audio*, and an all-new generation of incredible PlayStation games. Lightning Speed - Harness the power of a custom CPU, GPU, and SSD with Integrated I/O that rewrite the rules of what a PlayStation console can do. Stunning Games - Marvel at incredible graphics and experience new PS5 features. Play a back catalog of supported PS4 games. Breathtaking Immersion - Discover a deeper gaming experience with support for haptic feedback, adaptive triggers, and 3D Audio technology. Vertical stand sold separately. *3D audio via built-in TV speakers or analog/USB stereo headphones. Set up and latest system software update required."
],
"details": {
"ASIN": "B0CL61F39H",
"Batteries": "1 Lithium Ion batteries required. (included)",
"Date First Available": "December 10, 2023",
"Item Weight": "10.6 pounds",
"Item model number": "CFI-2015",
"Manufacturer": "Sony",
"Platform": "PlayStation 5",
"Product Dimensions": "14 x 17 x 7 inches; 10.6 Pounds",
"Release date": "December 10, 2023",
"Type of item": "Video Game"
},
"hasAPlusContent": true,
"images": [
"https://m.media-amazon.com/images/I/41ECK5cY-2L._SL1000_.jpg",
"https://m.media-amazon.com/images/I/41srF-iY93L._SL1000_.jpg",
"https://m.media-amazon.com/images/I/41tVr19I3zL._SL1000_.jpg",
"https://m.media-amazon.com/images/I/41HMaO9jO3L._SL1000_.jpg",
"https://m.media-amazon.com/images/I/61e8hPmeoYL._SL1000_.jpg",
"https://m.media-amazon.com/images/I/61Gj1Kc5R5L._SL1000_.jpg",
"https://m.media-amazon.com/images/I/61r6PutKGwL._SL1000_.jpg",
"https://m.media-amazon.com/images/I/717Id5h1fhL._SL1000_.jpg"
],
"link": "https://www.amazon.com/dp/B0CL61F39H",
"listedSinceDate": "2023-12-10",
"mainImage": "https://m.media-amazon.com/images/I/31kTNmpm6vL.jpg",
"marketplaceId": "ATVPDKIKX0DER",
"reviews": {
"averageRating": 4.7,
"reviewSummary": "4.7 out of 5 stars",
"totalReviews": 7092
},
"title": "PlayStation®5 console (slim)",
"variations": [
{
"asin": "B0F6968Y5G",
"attributes": {
"Pattern Name": "PS5 w/ Black Ops Bundle",
"Style": "PlayStation®5 Digital Edition (slim)"
}
},
{
"asin": "B0CL5KNB9M",
"attributes": {
"Pattern Name": "PS5 Only",
"Style": "PlayStation®5 Digital Edition (slim)"
}
},
{
"asin": "B0CL61F39H",
"attributes": {
"Pattern Name": "PS5 Only",
"Style": "PlayStation®5 console (slim)"
}
},
{
"asin": "B0F691TJTP",
"attributes": {
"Pattern Name": "PS5 w/ Black Ops Bundle",
"Style": "PlayStation®5 console (slim)"
}
},
{
"asin": "B0FD54CGQ8",
"attributes": {
"Pattern Name": "PS5 w/ $100 PlayStation Store GC",
"Style": "PlayStation®5 Digital Edition (slim)"
}
},
{
"asin": "B0FD4WGVH5",
"attributes": {
"Pattern Name": "PS5 w/ $100 PlayStation Store GC",
"Style": "PlayStation®5 console (slim)"
}
}
],
"videos": [
"https://m.media-amazon.com/S/vse-vms-transcoding-artifact-us-east-1-prod/8af0ddf1-55f5-4e71-9463-39602c3edbae/default.jobtemplate.hls.m3u8",
"https://m.media-amazon.com/S/vse-vms-transcoding-artifact-us-east-1-prod/50938d5c-2a9b-427a-b766-21b7cd63502e/default.jobtemplate.hls.m3u8"
]
}
},
"success": true
}
Building the Tool: A Practical Example
Here’s a simplified Python example demonstrating how to use SellerMagnet API to fetch product statistics:
import requests
API_KEY = "YOUR_API_KEY"
ASIN = "B0CL61F39H"
MARKETPLACE_ID = "ATVPDKIKX0DER"
url = f"https://sellermagnet-api.com/amazon-product-statistics?asin={ASIN}&marketplaceId={MARKETPLACE_ID}&api_key={API_KEY}"
try:
response = requests.get(url)
response.raise_for_status() # Raises HTTPError for bad responses (4xx or 5xx)
data = response.json()
if data["success"]:
product_data = data["data"]
print(f"Product Title: {product_data.get('productTitle', 'N/A')}")
print(f"Best Seller Rank: {product_data.get('bestSellerRank', 'N/A')}")
print(f"Buy Box Price: {product_data.get('buyBoxPrice', 'N/A')}")
else:
print(f"API Error: {data.get('errors', 'Unknown error')}")
except requests.exceptions.RequestException as e:
print(f"Request failed: {e}")
except (KeyError, TypeError) as e:
print(f"Error parsing JSON: {e}")
This script fetches product statistics for a given ASIN and prints the product title, best seller rank, and Buy Box price. Remember to replace YOUR_API_KEY with your actual SellerMagnet API key.
Advanced Analysis Techniques
- Trend Analysis: Use the
salesRankHistoryfrom the Amazon Product Statistics endpoint to chart sales rank trends over time. - Competitor Benchmarking: Compare the
buyBoxPriceandbuyBoxFulfillmentacross multiple products to understand competitive dynamics. - Seller Performance Monitoring: Track changes in seller ratings and review counts over time to identify top performers and potential risks.
Ensuring Data Quality and Compliance
When building your tool, adhere to these best practices:
- Handle API rate limits: Implement error handling and retry mechanisms to manage API rate limits gracefully.
- Respect Amazon's terms of service: Ensure your data collection practices comply with Amazon's terms of service and avoid Amazon Web Scraping.
- Store data securely: Protect sensitive data and comply with relevant privacy regulations.
Conclusion
Building a custom category penetration analysis tool using the SellerMagnet API empowers businesses to gain a deeper understanding of the Amazon marketplace. By leveraging SellerMagnet’s robust data and flexible API, you can uncover valuable insights, optimize your product strategy, and achieve sustainable growth on Amazon. You can use Amazon Product Estimate Sales to estimate sales and use Amazon Product Bestseller History to see historical data.
Start building your competitive advantage today with SellerMagnet. Try Free or Contact us for more information.