SellerMagnetAPI Documentation
Integrate real-time Amazon data with our robust API. Explore endpoints, schemas, and code examples.
API Endpoints
Detailed documentation for SellerMagnetAPI endpoints, including parameters, JSON schemas, and code examples in multiple languages.
Amazon Product Statistics
Endpoint: /amazon-product-statistics
Method: GET
Description: Retrieve detailed statistics for an Amazon product, including sales rank and review counts.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| asin | text | Yes | Product ASIN (e.g., "B08N5WRWNW") |
| marketplaceId | text | Yes | Marketplace ID (e.g., "A1PA6795UKMFR9") |
| api_key | text | Yes | Your API key |
| graphs | text | No | Generate visually graphs for history data |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"description": "The response schema for Amazon item tracking data, including core item details, historical data, and optional extensions for graphs or metadata.",
"properties": {
"data": {
"additionalProperties": true,
"description": "Core data object with item tracking details and optional extensions.",
"properties": {
"amazonPrice": {
"description": "The current price of the item on Amazon (in cents), or null if not available.",
"type": [
"number",
"null"
]
},
"asin": {
"description": "The Amazon Standard Identification Number (ASIN) for the item, a 10-character alphanumeric identifier.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"bestSellerRank": {
"description": "The current best seller rank of the item in its category.",
"minimum": 1,
"type": "integer"
},
"buyBoxFulfillment": {
"description": "The fulfillment method for the Buy Box. Possible values: \u0027FBM\u0027 (Fulfilled by Merchant), \u0027FBA\u0027 (Fulfilled by Amazon), \u0027AMZ\u0027 (sold directly by Amazon).",
"enum": [
"FBM",
"FBA",
"AMZ"
],
"type": "string"
},
"buyBoxPrice": {
"description": "The current price of the item in the Buy Box (in cents).",
"minimum": 0,
"type": "integer"
},
"buyBoxSellerIdHistory": {
"description": "A chronological list of Buy Box seller changes, including timestamps and seller IDs.",
"items": {
"description": "A tuple of [timestamp, sellerId] representing a Buy Box seller change.",
"items": [
{
"description": "The timestamp when the Buy Box seller was recorded, in ISO 8601 format.",
"format": "date-time",
"type": "string"
},
{
"description": "The seller ID for the Buy Box at the given timestamp, or \u0027-1\u0027 if no seller held the Buy Box.",
"type": "string"
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"graphs": {
"additionalProperties": true,
"description": "Placeholder for graph-related data, allowing flexibility for additional visualization types.",
"properties": {
"priceTrend": {
"description": "Data points for visualizing price trends over time.",
"items": {
"properties": {
"price": {
"description": "The price at the given timestamp (in cents).",
"minimum": 0,
"type": "integer"
},
"timestamp": {
"description": "The timestamp for the price data point.",
"format": "date-time",
"type": "string"
}
},
"required": [
"timestamp",
"price"
],
"type": "object"
},
"type": "array"
},
"rankTrend": {
"description": "Data points for visualizing sales rank trends over time.",
"items": {
"properties": {
"rank": {
"description": "The sales rank at the given timestamp.",
"minimum": 1,
"type": "integer"
},
"timestamp": {
"description": "The timestamp for the rank data point.",
"format": "date-time",
"type": "string"
}
},
"required": [
"timestamp",
"rank"
],
"type": "object"
},
"type": "array"
}
},
"type": [
"object",
"null"
]
},
"metadata": {
"additionalProperties": true,
"description": "Flexible metadata field for additional item or tracking information.",
"properties": {
"category": {
"description": "The Amazon category of the item (e.g., \u0027Electronics\u0027).",
"type": "string"
},
"lastUpdated": {
"description": "The timestamp when the data was last updated.",
"format": "date-time",
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"salesRankHistory": {
"description": "A chronological list of the item\u0027s sales rank changes, including timestamps and rank values.",
"items": {
"description": "A tuple of [timestamp, salesRank] representing a sales rank record.",
"items": [
{
"description": "The timestamp when the sales rank was recorded, in ISO 8601 format.",
"format": "date-time",
"type": "string"
},
{
"description": "The sales rank of the item at the given timestamp.",
"minimum": 1,
"type": "integer"
}
],
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"trackingSince": {
"description": "The date when tracking of the item began, in YYYY-MM-DD format.",
"format": "date",
"type": "string"
}
},
"required": [
"asin",
"amazonPrice",
"bestSellerRank",
"buyBoxPrice",
"buyBoxFulfillment",
"buyBoxSellerIdHistory",
"salesRankHistory",
"trackingSince"
],
"type": "object"
},
"errors": {
"description": "Optional list of error messages if the request was not fully successful. Not present in the provided document but included for robustness.",
"items": {
"properties": {
"code": {
"description": "A unique error code.",
"type": "string"
},
"message": {
"description": "A human-readable error message.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": [
"array",
"null"
]
},
"success": {
"description": "Indicates whether the request to retrieve the item tracking data was successful.",
"type": "boolean"
}
},
"required": [
"success",
"data"
],
"title": "Amazon Item Tracking Response Schema",
"type": "object"
}Response Example
{
"data": {
"asin": "B0CLTBHXWQ",
"buyBoxFulfillment": "FBM",
"buyBoxPrice": 41800,
"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
]
]
},
"A12FLY25DT7QO0": {
"isFBA": false,
"lastUpdated": "2025-06-14 17:08:00",
"priceHistory": [
[
"2025-06-09 15:32:00",
41800,
0
]
],
"stockHistory": [
[
"2025-06-14 13:34:00",
49
]
]
},
"A18KSDUE00UP6J": {
"isFBA": false,
"lastUpdated": "2025-06-14 17:08:00",
"priceHistory": [
[
"2025-05-29 11:32:00",
42890,
0
]
],
"stockHistory": [
[
"2025-05-30 18:30:00",
3
]
]
}
},
"productReviewAverage": 4.7,
"productTitle": "Playstation 5 Console Edizione Digital Slim",
"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
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"asin": "Product ASIN "B08N5WRWNW"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"api_key": "api_key",
"graphs": "graphs",
}
response = requests.get("https://sellermagnet-api.com/amazon-product-statistics", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"asin" => "Product ASIN "B08N5WRWNW"",
"marketplaceId" => "Marketplace ID "A1PA6795UKMFR9"",
"api_key" => "api_key",
"graphs" => "graphs",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-product-statistics", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"asin": "Product ASIN "B08N5WRWNW"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"api_key": "api_key",
"graphs": "graphs",
});
fetch("https://sellermagnet-api.com/amazon-product-statistics?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("asin", "Product ASIN "B08N5WRWNW"");
params.put("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"");
params.put("api_key", "api_key");
params.put("graphs", "graphs");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-product-statistics?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("asin", "Product ASIN "B08N5WRWNW"")
params.Add("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"")
params.Add("api_key", "api_key")
params.Add("graphs", "graphs")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-product-statistics?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Amazon ASIN Converter
Endpoint: /amazon-asin-converter
Method: GET
Description: Convert between ASIN and EAN identifiers for Amazon products.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| asin | text | Yes | ASIN or EAN to convert (e.g., "B08N5WRWNW" or "9781234567890") |
| marketplaceId | text | Yes | Marketplace ID (e.g., "A1PA6795UKMFR9") |
| conversion_direction | text | Yes | Conversion direction: "asin-to-ean" or "ean-to-asin" |
| api_key | text | Yes | Your API key |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"eanList": {
"description": "List of EAN codes associated with the product.",
"items": {
"description": "European Article Number (EAN), a 12- or 13-digit identifier.",
"pattern": "^[0-9]{12,14}$",
"type": "string"
},
"minItems": 1,
"type": "array"
},
"listedSince": {
"description": "Timestamp indicating when the product was first listed, in ISO 8601 format.",
"format": "date-time",
"type": "string"
},
"productTitle": {
"description": "Title or name of the product.",
"minLength": 1,
"type": "string"
}
},
"required": [
"asin",
"eanList",
"listedSince",
"productTitle"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
{
"data": {
"asin": "B0CLTBHXWQ",
"eanList": [
"0711719577294"
],
"listedSince": "2023-12-30 01:00:00",
"productTitle": "Playstation 5 Console Edizione Digital Slim"
},
"success": true
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"asin": "ASIN or EAN to convert "B08N5WRWNW" or "9781234567890"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"conversion_direction": "asin-to-ean",
"api_key": "api_key",
}
response = requests.get("https://sellermagnet-api.com/amazon-asin-converter", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"asin" => "ASIN or EAN to convert "B08N5WRWNW" or "9781234567890"",
"marketplaceId" => "Marketplace ID "A1PA6795UKMFR9"",
"conversion_direction" => "asin-to-ean",
"api_key" => "api_key",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-asin-converter", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"asin": "ASIN or EAN to convert "B08N5WRWNW" or "9781234567890"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"conversion_direction": "asin-to-ean",
"api_key": "api_key",
});
fetch("https://sellermagnet-api.com/amazon-asin-converter?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("asin", "ASIN or EAN to convert "B08N5WRWNW" or "9781234567890"");
params.put("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"");
params.put("conversion_direction", "asin-to-ean");
params.put("api_key", "api_key");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-asin-converter?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("asin", "ASIN or EAN to convert "B08N5WRWNW" or "9781234567890"")
params.Add("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"")
params.Add("conversion_direction", "asin-to-ean")
params.Add("api_key", "api_key")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-asin-converter?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Get Amazon Seller Review
Endpoint: /amazon-seller-review
Method: GET
Description: Fetch review details for a specific Amazon seller.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| sellerId | text | Yes | Seller ID (e.g., "A1B2C3D4E5F6G7") |
| marketplaceId | text | Yes | Marketplace ID (e.g., "A1PA6795UKMFR9") |
| api_key | text | Yes | Your API key |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"marketplace": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"last5Reviews": {
"description": "List of up to 5 most recent customer reviews.",
"items": {
"additionalProperties": false,
"properties": {
"dateRated": {
"description": "Date and reviewer name of the review, in a human-readable format.",
"type": "string"
},
"reviewText": {
"description": "Text content of the review.",
"minLength": 1,
"type": "string"
},
"starRating": {
"description": "Star rating of the review, formatted as \u0027X out of 5 stars\u0027.",
"pattern": "^[1-5] out of 5 stars$",
"type": "string"
}
},
"required": [
"dateRated",
"reviewText",
"starRating"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"sellerFeedback": {
"additionalProperties": false,
"description": "Seller feedback ratings and review counts over different time periods.",
"properties": {
"30": {
"additionalProperties": false,
"properties": {
"rating": {
"description": "Average rating over the last 30 days.",
"pattern": "^[0-5](\\.\\d)?$",
"type": "string"
},
"reviewsCount": {
"description": "Number of reviews over the last 30 days.",
"pattern": "^[0-9]+$",
"type": "string"
}
},
"required": [
"rating",
"reviewsCount"
],
"type": "object"
},
"365": {
"additionalProperties": false,
"properties": {
"rating": {
"description": "Average rating over the last 365 days.",
"pattern": "^[0-5](\\.\\d)?$",
"type": "string"
},
"reviewsCount": {
"description": "Number of reviews over the last 365 days.",
"pattern": "^[0-9]+$",
"type": "string"
}
},
"required": [
"rating",
"reviewsCount"
],
"type": "object"
},
"90": {
"additionalProperties": false,
"properties": {
"rating": {
"description": "Average rating over the last 90 days.",
"pattern": "^[0-5](\\.\\d)?$",
"type": "string"
},
"reviewsCount": {
"description": "Number of reviews over the last 90 days.",
"pattern": "^[0-9]+$",
"type": "string"
}
},
"required": [
"rating",
"reviewsCount"
],
"type": "object"
},
"lifetime": {
"additionalProperties": false,
"properties": {
"rating": {
"description": "Average rating over the seller\u0027s lifetime.",
"pattern": "^[0-5](\\.\\d)?$",
"type": "string"
},
"reviewsCount": {
"description": "Total number of reviews over the seller\u0027s lifetime, with optional comma for thousands.",
"pattern": "^[0-9]+(,[0-9]+)?$",
"type": "string"
}
},
"required": [
"rating",
"reviewsCount"
],
"type": "object"
}
},
"required": [
"30",
"90",
"365",
"lifetime"
],
"type": "object"
}
},
"required": [
"last5Reviews",
"sellerFeedback"
],
"type": "object"
},
"description": "Marketplace-specific data, keyed by marketplace ID.",
"type": "object"
},
"sellerId": {
"description": "Unique identifier for the seller.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
}
},
"required": [
"marketplace",
"sellerId"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
{
"data": {
"marketplace": {
"ATVPDKIKX0DER": {
"last5Reviews": [
{
"dateRated": "By gary kraus on June 5, 2025.",
"reviewText": "great",
"starRating": "5 out of 5 stars"
},
{
"dateRated": "By Amazon Customer on June 5, 2025.",
"reviewText": "Ok",
"starRating": "5 out of 5 stars"
},
{
"dateRated": "By Graciela Casta\u00f1eda on May 21, 2025.",
"reviewText": "Excelente",
"starRating": "5 out of 5 stars"
}
],
"sellerFeedback": {
"30": {
"rating": "3.3",
"reviewsCount": "7"
},
"365": {
"rating": "3.9",
"reviewsCount": "114"
},
"90": {
"rating": "3.6",
"reviewsCount": "30"
},
"lifetime": {
"rating": "4.5",
"reviewsCount": "1,535"
}
}
}
},
"sellerId": "A1CWSGXIR635I6"
},
"success": true
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"sellerId": "Seller ID "A1B2C3D4E5F6G7"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"api_key": "api_key",
}
response = requests.get("https://sellermagnet-api.com/amazon-seller-review", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"sellerId" => "Seller ID "A1B2C3D4E5F6G7"",
"marketplaceId" => "Marketplace ID "A1PA6795UKMFR9"",
"api_key" => "api_key",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-seller-review", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"sellerId": "Seller ID "A1B2C3D4E5F6G7"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"api_key": "api_key",
});
fetch("https://sellermagnet-api.com/amazon-seller-review?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("sellerId", "Seller ID "A1B2C3D4E5F6G7"");
params.put("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"");
params.put("api_key", "api_key");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-seller-review?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("sellerId", "Seller ID "A1B2C3D4E5F6G7"")
params.Add("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"")
params.Add("api_key", "api_key")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-seller-review?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Get Amazon Product
Endpoint: /amazon-product-lookup
Method: GET
Description: Retrieve detailed product information for a given ASIN.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| asin | text | Yes | Product ASIN (e.g., 'B08N5WRWNW') |
| marketplaceId | text | Yes | Marketplace ID (e.g., 'A1PA6795UKMFR9') |
| api_key | text | Yes | Your API key |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"productInfo": {
"additionalProperties": false,
"description": "Detailed product information.",
"properties": {
"additionalDetails": {
"additionalProperties": true,
"description": "Detailed product information.",
"properties": {
"ASIN": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"Batteries": {
"description": "Battery requirements.",
"type": "string"
},
"Best Sellers Rank": {
"description": "Bestseller rank information.",
"type": "string"
},
"Customer Rating": {
"description": "Customer review summary.",
"type": "string"
},
"Date First Available": {
"description": "Date the product was first available.",
"type": "string"
},
"Item Weight": {
"description": "Weight of the item.",
"type": "string"
},
"Item model number": {
"description": "Model number of the item.",
"type": "string"
},
"Manufacturer": {
"description": "Manufacturer of the product.",
"type": "string"
},
"Number of Reviews": {
"description": "Total number of reviews with \u0027ratings\u0027 suffix.",
"type": "string"
},
"Product Dimensions": {
"description": "Dimensions of the product.",
"type": "string"
},
"Release date": {
"description": "Release date of the product.",
"type": "string"
},
"Type of item": {
"description": "Type of the item.",
"type": "string"
}
},
"required": [
"ASIN"
],
"type": "object"
},
"asin": {
"description": "Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"bestsellerRanks": {
"additionalProperties": false,
"description": "Bestseller rank information.",
"properties": {
"main_category": {
"additionalProperties": false,
"properties": {
"name": {
"description": "Name of the main category.",
"minLength": 1,
"type": "string"
},
"rank": {
"description": "Bestseller rank in the main category.",
"minimum": 1,
"type": "integer"
}
},
"required": [
"name",
"rank"
],
"type": "object"
},
"subcategory": {
"additionalProperties": false,
"properties": {
"name": {
"description": "Name of the subcategory (may be empty).",
"type": "string"
},
"rank": {
"description": "Bestseller rank in the subcategory (0 if not applicable).",
"minimum": 0,
"type": "integer"
}
},
"required": [
"name",
"rank"
],
"type": "object"
}
},
"required": [
"main_category",
"subcategory"
],
"type": "object"
},
"bulletPoints": {
"description": "List of product bullet points.",
"items": {
"description": "A product feature or specification.",
"minLength": 1,
"type": "string"
},
"type": "array"
},
"buyBoxInfo": {
"additionalProperties": false,
"description": "Buy box information.",
"properties": {
"currencyCode": {
"description": "Currency code (e.g., USD).",
"type": "string"
},
"currencyName": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"currencySymbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
},
"price": {
"description": "Buy box price.",
"minimum": 0,
"type": "number"
},
"sellerId": {
"description": "Unique identifier of the buy box seller.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
}
},
"required": [
"currencyCode",
"currencyName",
"currencySymbol",
"price",
"sellerId"
],
"type": "object"
},
"categories": {
"additionalProperties": false,
"description": "Bestseller category information.",
"properties": {
"bestsellerCategory": {
"description": "List of bestseller categories.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Category identifier.",
"type": "string"
},
"index": {
"description": "Index of the category in the hierarchy.",
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name of the category.",
"minLength": 1,
"type": "string"
},
"url": {
"description": "URL to the category page on Amazon.",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"index",
"name",
"url"
],
"type": "object"
},
"type": "array"
},
"rootCategory": {
"additionalProperties": false,
"description": "Root category details.",
"properties": {
"id": {
"description": "Root category identifier.",
"type": "string"
},
"name": {
"description": "Name of the root category.",
"minLength": 1,
"type": "string"
},
"url": {
"description": "URL to the root category page on Amazon.",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"name",
"url"
],
"type": "object"
}
},
"required": [
"bestsellerCategory",
"rootCategory"
],
"type": "object"
},
"description": {
"description": "Product description (may be empty).",
"items": {
"description": "A description segment.",
"type": "string"
},
"type": "array"
},
"details": {
"additionalProperties": true,
"description": "Additional product details.",
"properties": {
"ASIN": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"Batteries": {
"description": "Battery requirements.",
"type": "string"
},
"Date First Available": {
"description": "Date the product was first available.",
"type": "string"
},
"Item Weight": {
"description": "Weight of the item.",
"type": "string"
},
"Item model number": {
"description": "Model number of the item.",
"type": "string"
},
"Manufacturer": {
"description": "Manufacturer of the product.",
"type": "string"
},
"Platform": {
"description": "Platform of the product.",
"type": "string"
},
"Product Dimensions": {
"description": "Dimensions of the product.",
"type": "string"
},
"Release date": {
"description": "Release date of the product.",
"type": "string"
},
"Type of item": {
"description": "Type of the item.",
"type": "string"
}
},
"required": [
"ASIN"
],
"type": "object"
},
"hasAPlusContent": {
"description": "Indicates if the product has A+ Content.",
"type": "boolean"
},
"images": {
"description": "List of product image URLs.",
"items": {
"description": "URL to a product image.",
"format": "uri",
"type": "string"
},
"type": "array"
},
"link": {
"description": "URL to the product page on Amazon.",
"format": "uri",
"type": "string"
},
"listedSinceDate": {
"description": "Date when the product was first listed, in YYYY-MM-DD format, or null if unavailable.",
"format": "date",
"type": [
"string",
"null"
]
},
"mainImage": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"marketplaceId": {
"description": "Unique identifier for the marketplace.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
},
"reviews": {
"additionalProperties": false,
"description": "Product review summary.",
"properties": {
"averageRating": {
"description": "Average star rating.",
"maximum": 5,
"minimum": 0,
"type": "number"
},
"reviewSummary": {
"description": "Title of the review summary.",
"type": "string"
},
"totalReviews": {
"description": "Total number of reviews.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"averageRating",
"reviewSummary",
"totalReviews"
],
"type": "object"
},
"title": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
},
"variations": {
"description": "List of product variations.",
"items": {
"additionalProperties": false,
"description": "A product variation.",
"properties": {
"asin": {
"description": "ASIN of the variation.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"attributes": {
"additionalProperties": true,
"description": "Attributes of the variation (e.g., Pattern Name, Style).",
"type": "object"
}
},
"required": [
"asin",
"attributes"
],
"type": "object"
},
"type": "array"
},
"videos": {
"description": "List of product video URLs.",
"items": {
"description": "URL to a product video.",
"format": "uri",
"type": "string"
},
"type": "array"
}
},
"required": [
"additionalDetails",
"asin",
"bestsellerRanks",
"bulletPoints",
"buyBoxInfo",
"categories",
"description",
"details",
"hasAPlusContent",
"images",
"link",
"listedSinceDate",
"mainImage",
"marketplaceId",
"reviews",
"title",
"variations",
"videos"
],
"type": "object"
}
},
"required": [
"productInfo"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
{
"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\u2019s 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\u0026node=20972781011"
},
{
"id": "20972796011",
"index": 2,
"name": "Consoles",
"url": "https://www.amazon.com/b/ref=dp_bc_3?ie=UTF8\u0026node=20972796011"
}
],
"rootCategory": {
"id": "468642",
"name": "Video Games",
"url": "https://www.amazon.com/computer-video-games-hardware-accessories/b/ref=dp_bc_1?ie=UTF8\u0026node=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\u2019s 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\u00ae5 console (slim)",
"variations": [
{
"asin": "B0F6968Y5G",
"attributes": {
"Pattern Name": "PS5 w/ Black Ops Bundle",
"Style": "PlayStation\u00ae5 Digital Edition (slim)"
}
},
{
"asin": "B0CL5KNB9M",
"attributes": {
"Pattern Name": "PS5 Only",
"Style": "PlayStation\u00ae5 Digital Edition (slim)"
}
},
{
"asin": "B0CL61F39H",
"attributes": {
"Pattern Name": "PS5 Only",
"Style": "PlayStation\u00ae5 console (slim)"
}
},
{
"asin": "B0F691TJTP",
"attributes": {
"Pattern Name": "PS5 w/ Black Ops Bundle",
"Style": "PlayStation\u00ae5 console (slim)"
}
},
{
"asin": "B0FD54CGQ8",
"attributes": {
"Pattern Name": "PS5 w/ $100 PlayStation Store GC",
"Style": "PlayStation\u00ae5 Digital Edition (slim)"
}
},
{
"asin": "B0FD4WGVH5",
"attributes": {
"Pattern Name": "PS5 w/ $100 PlayStation Store GC",
"Style": "PlayStation\u00ae5 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
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"asin": "Product ASIN 'B08N5WRWNW'",
"marketplaceId": "Marketplace ID 'A1PA6795UKMFR9'",
"api_key": "api_key",
}
response = requests.get("https://sellermagnet-api.com/amazon-product-lookup", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"asin" => "Product ASIN 'B08N5WRWNW'",
"marketplaceId" => "Marketplace ID 'A1PA6795UKMFR9'",
"api_key" => "api_key",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-product-lookup", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"asin": "Product ASIN 'B08N5WRWNW'",
"marketplaceId": "Marketplace ID 'A1PA6795UKMFR9'",
"api_key": "api_key",
});
fetch("https://sellermagnet-api.com/amazon-product-lookup?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("asin", "Product ASIN 'B08N5WRWNW'");
params.put("marketplaceId", "Marketplace ID 'A1PA6795UKMFR9'");
params.put("api_key", "api_key");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-product-lookup?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("asin", "Product ASIN 'B08N5WRWNW'")
params.Add("marketplaceId", "Marketplace ID 'A1PA6795UKMFR9'")
params.Add("api_key", "api_key")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-product-lookup?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Get Amazon Product Offers
Endpoint: /amazon-product-offers
Method: GET
Description: List offers for a product, including price, seller, condition, and inventory details.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| asin | text | Yes | Product ASIN (e.g., 'B08N5WRWNW') |
| marketplaceId | text | Yes | Marketplace ID (e.g., 'A1PA6795UKMFR9') |
| geo_location | text | No | Detailed Geo Location ZIP CODE |
| api_key | text | Yes | Your API key |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"buyBox": {
"additionalProperties": false,
"description": "Buy box information.",
"properties": {
"condition": {
"description": "Condition of the buy box product.",
"enum": [
"New",
"Used - Like New",
"Used - Very Good",
"Used - Good",
"Used - Acceptable"
],
"type": "string"
},
"deliveryDate": {
"description": "Expected delivery date in YYYY-MM-DD format.",
"format": "date",
"type": "string"
},
"fulfillmentType": {
"description": "Fulfillment method (FBA or FBM).",
"enum": [
"FBA",
"FBM"
],
"type": "string"
},
"inventory": {
"description": "Number of items available in seller\u0027s inventory.",
"minimum": 0,
"type": "integer"
},
"positivePercentage": {
"description": "Percentage of positive reviews for the seller.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"priceWithoutShipping": {
"description": "Price excluding shipping.",
"minimum": 0,
"type": "number"
},
"sellerId": {
"description": "Unique identifier of the buy box seller or \u0027Amazon\u0027.",
"pattern": "^[A-Z0-9]+$|^Amazon$",
"type": "string"
},
"sellerName": {
"description": "Name of the buy box seller.",
"minLength": 1,
"type": "string"
},
"shippingPrice": {
"description": "Shipping cost for the buy box offer.",
"minimum": 0,
"type": "number"
},
"totalPrice": {
"description": "Total price including shipping.",
"minimum": 0,
"type": "number"
},
"totalReviews": {
"description": "Total number of reviews for the seller.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"condition",
"deliveryDate",
"fulfillmentType",
"inventory",
"positivePercentage",
"priceWithoutShipping",
"sellerId",
"sellerName",
"shippingPrice",
"totalPrice",
"totalReviews"
],
"type": "object"
},
"currency": {
"additionalProperties": false,
"description": "Currency details.",
"properties": {
"code": {
"description": "Currency code (e.g., USD).",
"type": "string"
},
"name": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"symbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
}
},
"required": [
"code",
"name",
"symbol"
],
"type": "object"
},
"marketplaceId": {
"description": "Unique identifier for the marketplace.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
},
"offers": {
"description": "List of offers for the product.",
"items": {
"additionalProperties": false,
"description": "Details of an offer for the product.",
"properties": {
"condition": {
"description": "Condition of the product.",
"enum": [
"New",
"Used - Like New",
"Used - Very Good",
"Used - Good",
"Used - Acceptable"
],
"type": "string"
},
"deliveryDate": {
"description": "Expected delivery date in YYYY-MM-DD format.",
"format": "date",
"type": "string"
},
"fulfillmentType": {
"description": "Fulfillment method (FBA or FBM).",
"enum": [
"FBA",
"FBM"
],
"type": "string"
},
"inventory": {
"description": "Number of items available in seller\u0027s inventory.",
"minimum": 0,
"type": "integer"
},
"positivePercentage": {
"description": "Percentage of positive reviews for the seller.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"priceWithoutShipping": {
"description": "Price excluding shipping.",
"minimum": 0,
"type": "number"
},
"sellerId": {
"description": "Unique identifier of the seller or \u0027Amazon\u0027.",
"pattern": "^[A-Z0-9]+$|^Amazon$",
"type": "string"
},
"sellerName": {
"description": "Name of the seller.",
"minLength": 1,
"type": "string"
},
"shippingPrice": {
"description": "Shipping cost for the offer.",
"minimum": 0,
"type": "number"
},
"totalPrice": {
"description": "Total price including shipping.",
"minimum": 0,
"type": "number"
},
"totalReviews": {
"description": "Total number of reviews for the seller.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"condition",
"deliveryDate",
"fulfillmentType",
"inventory",
"positivePercentage",
"priceWithoutShipping",
"sellerId",
"sellerName",
"shippingPrice",
"totalPrice",
"totalReviews"
],
"type": "object"
},
"type": "array"
},
"productLink": {
"description": "URL to the product page on Amazon.",
"format": "uri",
"type": "string"
},
"productMainImage": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"productTitle": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
}
},
"required": [
"asin",
"buyBox",
"currency",
"marketplaceId",
"offers",
"productLink",
"productMainImage",
"productTitle"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
{
"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
},
{
"condition": "Used - Very Good",
"deliveryDate": "2025-07-07",
"fulfillmentType": "FBM",
"inventory": 10,
"positivePercentage": 78,
"priceWithoutShipping": 409.99,
"sellerId": "A17J18A7XABQI9",
"sellerName": "PRICE 2 SAVE",
"shippingPrice": 0,
"totalPrice": 409.99,
"totalReviews": 6892
},
{
"condition": "Used - Good",
"deliveryDate": "2025-06-26",
"fulfillmentType": "FBM",
"inventory": 1,
"positivePercentage": 87,
"priceWithoutShipping": 409.99,
"sellerId": "A1YU28SVL05CUG",
"sellerName": "premier liquidation",
"shippingPrice": 9.84,
"totalPrice": 419.83,
"totalReviews": 1177
},
{
"condition": "Used - Very Good",
"deliveryDate": "2025-06-30",
"fulfillmentType": "FBM",
"inventory": 1,
"positivePercentage": 40,
"priceWithoutShipping": 418.99,
"sellerId": "A2NBVGK6C0HCUA",
"sellerName": "Fix N Plug",
"shippingPrice": 3.99,
"totalPrice": 422.98,
"totalReviews": 30
},
{
"condition": "Used - Good",
"deliveryDate": "2025-06-30",
"fulfillmentType": "FBM",
"inventory": 1,
"positivePercentage": 94,
"priceWithoutShipping": 423.99,
"sellerId": "AZZMAGMBAQU46",
"sellerName": "VG1shop (Serial # Recorded)",
"shippingPrice": 3.99,
"totalPrice": 427.98,
"totalReviews": 163
},
{
"condition": "Used - Acceptable",
"deliveryDate": "2025-06-28",
"fulfillmentType": "FBM",
"inventory": 1,
"positivePercentage": 0,
"priceWithoutShipping": 433.85,
"sellerId": "Amazon",
"sellerName": "Amazon Resale",
"shippingPrice": 0,
"totalPrice": 433.85,
"totalReviews": 0
},
{
"condition": "Used - Very Good",
"deliveryDate": "2025-07-01",
"fulfillmentType": "FBM",
"inventory": 1,
"positivePercentage": 73,
"priceWithoutShipping": 419.99,
"sellerId": "AO9EU0V84CET9",
"sellerName": "StarEdge Electronics",
"shippingPrice": 15.75,
"totalPrice": 435.74,
"totalReviews": 154
},
{
"condition": "Used - Very Good",
"deliveryDate": "2025-06-27",
"fulfillmentType": "FBM",
"inventory": 2,
"positivePercentage": 74,
"priceWithoutShipping": 441.49,
"sellerId": "A2E7NH3SLWCOH4",
"sellerName": "Tech for Less",
"shippingPrice": 0,
"totalPrice": 441.49,
"totalReviews": 56746
},
{
"condition": "Used - Very Good",
"deliveryDate": "2025-06-27",
"fulfillmentType": "FBM",
"inventory": 1,
"positivePercentage": 84,
"priceWithoutShipping": 443.7,
"sellerId": "A3JEKQLX9Y2C9L",
"sellerName": "SaveCentral",
"shippingPrice": 0,
"totalPrice": 443.7,
"totalReviews": 7483
},
{
"condition": "Used - Like New",
"deliveryDate": "2025-06-27",
"fulfillmentType": "FBM",
"inventory": 2,
"positivePercentage": 80,
"priceWithoutShipping": 439.99,
"sellerId": "A1KOYPV53GXGUI",
"sellerName": "JRS GAMES",
"shippingPrice": 3.99,
"totalPrice": 443.98,
"totalReviews": 81
},
{
"condition": "Used - Very Good",
"deliveryDate": "2025-06-28",
"fulfillmentType": "FBA",
"inventory": 8,
"positivePercentage": 82,
"priceWithoutShipping": 444.99,
"sellerId": "A3853PJW50SJG8",
"sellerName": "Wardyga Management Services LLC",
"shippingPrice": 0,
"totalPrice": 444.99,
"totalReviews": 60
}
],
"productLink": "https://www.amazon.com/dp/B0CL61F39H",
"productMainImage": "https://m.media-amazon.com/images/I/31kTNmpm6vL.jpg",
"productTitle": "PlayStation\u00ae5 console (slim)"
},
"success": true
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"asin": "Product ASIN 'B08N5WRWNW'",
"marketplaceId": "Marketplace ID 'A1PA6795UKMFR9'",
"geo_location": "geo_location",
"api_key": "api_key",
}
response = requests.get("https://sellermagnet-api.com/amazon-product-offers", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"asin" => "Product ASIN 'B08N5WRWNW'",
"marketplaceId" => "Marketplace ID 'A1PA6795UKMFR9'",
"geo_location" => "geo_location",
"api_key" => "api_key",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-product-offers", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"asin": "Product ASIN 'B08N5WRWNW'",
"marketplaceId": "Marketplace ID 'A1PA6795UKMFR9'",
"geo_location": "geo_location",
"api_key": "api_key",
});
fetch("https://sellermagnet-api.com/amazon-product-offers?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("asin", "Product ASIN 'B08N5WRWNW'");
params.put("marketplaceId", "Marketplace ID 'A1PA6795UKMFR9'");
params.put("geo_location", "geo_location");
params.put("api_key", "api_key");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-product-offers?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("asin", "Product ASIN 'B08N5WRWNW'")
params.Add("marketplaceId", "Marketplace ID 'A1PA6795UKMFR9'")
params.Add("geo_location", "geo_location")
params.Add("api_key", "api_key")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-product-offers?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Get Amazon Marketplaces
Endpoint: /amazon-get-marketplaces
Method: GET
Description: Retrieve a list of supported Amazon marketplaces.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| api_key | text | Yes | Your API key |
JSON Schema
No JSON schema available for this endpoint.
Response Example
{
"marketplaces": [
{
"country": "Germany",
"id": "A1PA6795UKMFR9",
"name": "Amazon.de"
}
]
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"api_key": "api_key",
}
response = requests.get("https://sellermagnet-api.com/amazon-get-marketplaces", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"api_key" => "api_key",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-get-marketplaces", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"api_key": "api_key",
});
fetch("https://sellermagnet-api.com/amazon-get-marketplaces?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("api_key", "api_key");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-get-marketplaces?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("api_key", "api_key")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-get-marketplaces?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Search Amazon
Endpoint: /amazon-search
Method: GET
Description: Search Amazon products by keyword.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | text | Yes | Search query (e.g., "phone") |
| marketplaceId | text | Yes | Marketplace ID (e.g., "A1PA6795UKMFR9") |
| count | number | No | Number of results (max 50, default 30) |
| geo_location | text | No | Detailed Geo Location ZIP CODE |
| api_key | text | Yes | Your API key |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"description": "Search results data.",
"properties": {
"searchResults": {
"description": "List of search results for products.",
"items": {
"additionalProperties": false,
"description": "A single search result entry.",
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"discount_info": {
"description": "Information about stock availability or discounts (e.g., \u0027Nur noch 1 auf Lager\u0027).",
"type": "string"
},
"link": {
"description": "URL to the product page on Amazon.",
"format": "uri",
"type": "string"
},
"listingPrice": {
"additionalProperties": false,
"description": "Listing price information.",
"properties": {
"original_price": {
"additionalProperties": false,
"description": "Original price details for the listing, if available.",
"properties": {
"currency_code": {
"description": "Currency code (e.g., EUR).",
"type": "string"
},
"currency_name": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"currency_symbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
},
"total": {
"description": "Total price as a string, with up to two decimal places.",
"pattern": "^[0-9]+(\\.[0-9]{1,2})?$",
"type": "string"
}
},
"required": [
"currency_code",
"currency_name",
"currency_symbol",
"total"
],
"type": "object"
},
"price": {
"additionalProperties": false,
"description": "Price details for the listing.",
"properties": {
"currency_code": {
"description": "Currency code (e.g., EUR).",
"type": "string"
},
"currency_name": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"currency_symbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
},
"total": {
"description": "Total price as a string, with up to two decimal places.",
"pattern": "^[0-9]+(\\.[0-9]{1,2})?$",
"type": "string"
}
},
"required": [
"currency_code",
"currency_name",
"currency_symbol",
"total"
],
"type": "object"
}
},
"required": [
"price"
],
"type": "object"
},
"mainImage": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"on_sale": {
"description": "Indicates if the product is on sale.",
"type": "boolean"
},
"position": {
"description": "Position of the product in the search results.",
"minimum": 1,
"type": "integer"
},
"productTitle": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
},
"reviewAmount": {
"description": "Total number of customer reviews.",
"minimum": 0,
"type": "integer"
},
"reviewRating": {
"description": "Average review rating, with one decimal place, or null if not available.",
"maximum": 5,
"minimum": 0,
"type": [
"number",
"null"
]
},
"sponsored": {
"description": "Indicates if the product is a sponsored listing.",
"type": "boolean"
}
},
"required": [
"asin",
"discount_info",
"link",
"listingPrice",
"mainImage",
"on_sale",
"position",
"productTitle",
"reviewAmount",
"reviewRating",
"sponsored"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"searchResults"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
{
"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\u00ae5 Digital Edition (slim)",
"reviewAmount": 7209,
"reviewRating": 4.7,
"sponsored": false
},
{
"asin": "B0DGY63Z2H",
"discount_info": "",
"link": "https://www.amazon.com/dp/B0DGY63Z2H",
"listingPrice": {
"price": {
"currency_code": "USD",
"currency_name": "United States Dollar",
"currency_symbol": "$",
"total": "699.00"
}
},
"mainImage": "https://m.media-amazon.com/images/I/61vR3ovb2UL._AC_UY218_.jpg",
"on_sale": false,
"position": 2,
"productTitle": "PlayStation 5 Pro Console",
"reviewAmount": 1373,
"reviewRating": 4.4,
"sponsored": false
},
{
"asin": "B0CV4JW8XM",
"discount_info": "",
"link": "https://www.amazon.com/dp/B0CV4JW8XM",
"listingPrice": {
"price": {
"currency_code": "USD",
"currency_name": "United States Dollar",
"currency_symbol": "$",
"total": "77.16"
}
},
"mainImage": "https://m.media-amazon.com/images/I/81BjQjGll8L._AC_UY218_.jpg",
"on_sale": false,
"position": 3,
"productTitle": "PlayStation Stellar Blade",
"reviewAmount": 405,
"reviewRating": 4.7,
"sponsored": false
}
]
},
"success": true
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"q": "Search query "phone"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"count": "30",
"geo_location": "geo_location",
"api_key": "api_key",
}
response = requests.get("https://sellermagnet-api.com/amazon-search", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"q" => "Search query "phone"",
"marketplaceId" => "Marketplace ID "A1PA6795UKMFR9"",
"count" => "30",
"geo_location" => "geo_location",
"api_key" => "api_key",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-search", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"q": "Search query "phone"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"count": "30",
"geo_location": "geo_location",
"api_key": "api_key",
});
fetch("https://sellermagnet-api.com/amazon-search?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("q", "Search query "phone"");
params.put("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"");
params.put("count", "30");
params.put("geo_location", "geo_location");
params.put("api_key", "api_key");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-search?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("q", "Search query "phone"")
params.Add("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"")
params.Add("count", "30")
params.Add("geo_location", "geo_location")
params.Add("api_key", "api_key")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-search?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Get Amazon Bestsellers
Endpoint: /amazon-bestsellers
Method: GET
Description: Fetch top-selling products in a specific category.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| category_id | text | Yes | Category ID (e.g., 'electronics') |
| marketplaceId | text | Yes | Marketplace ID (e.g., 'A1PA6795UKMFR9') |
| count | number | No | Number of results (max 50, default 30) |
| api_key | text | Yes | Your API key |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"description": "Bestseller data for the specified category.",
"properties": {
"bestsellers": {
"description": "List of bestseller products.",
"items": {
"additionalProperties": false,
"description": "A single bestseller product entry.",
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"mainImage": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"price": {
"additionalProperties": false,
"description": "Price details for the product.",
"properties": {
"currency_code": {
"description": "Currency code (e.g., EUR).",
"type": "string"
},
"currency_name": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"currency_symbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
},
"price": {
"description": "Price of the product.",
"minimum": 0,
"type": "number"
}
},
"required": [
"currency_code",
"currency_name",
"currency_symbol",
"price"
],
"type": "object"
},
"productImages": {
"description": "List of product image URLs.",
"items": {
"description": "URL to a product image.",
"format": "uri",
"type": "string"
},
"type": "array"
},
"productLink": {
"description": "URL to the product page on Amazon.",
"format": "uri",
"type": "string"
},
"productTitle": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
},
"rank": {
"description": "Bestseller rank in the category.",
"minimum": 1,
"type": "integer"
},
"reviewAmount": {
"description": "Total number of customer reviews.",
"minimum": 0,
"type": "integer"
},
"reviewRating": {
"description": "Average review rating.",
"maximum": 5,
"minimum": 0,
"type": "number"
}
},
"required": [
"asin",
"mainImage",
"productImages",
"productLink",
"productTitle",
"rank",
"reviewAmount",
"reviewRating"
],
"type": "object"
},
"type": "array"
},
"categoryId": {
"description": "Category ID for the bestsellers.",
"type": "string"
},
"link": {
"description": "URL to the bestseller category page on Amazon.",
"format": "uri",
"type": "string"
}
},
"required": [
"bestsellers",
"categoryId",
"link"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
{
"data": {
"bestsellers": [
{
"asin": "B0B7SFSN99",
"mainImage": "https://images-eu.ssl-images-amazon.com/images/I/81AZ+P-42vL._AC_UL300_SR300,200_.jpg",
"price": {
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "\u20ac",
"price": 16.68
},
"productImages": [
"https://images-eu.ssl-images-amazon.com/images/I/81AZ+P-42vL._AC_UL300_SR300,200_.jpg",
"https://images-eu.ssl-images-amazon.com/images/I/81AZ+P-42vL._AC_UL600_SR600,400_.jpg",
"https://images-eu.ssl-images-amazon.com/images/I/81AZ+P-42vL._AC_UL900_SR900,600_.jpg"
],
"productLink": "https://www.amazon.de/Sterntaler-Unisex-Schirmm%C3%BCtze-Nackenschutz-Kinderm%C3%BCtze/dp/B0B7SFSN99/ref=zg_bs_g_12419321031_d_sccl_1/260-5378242-6478342?psc=1",
"productTitle": "Sterntaler Schirmm\u00fctze Nacken - Unisex Baby- und Kinder M\u00fctze mit Nackenschutz und einsteckbaren Ohrenklappen - UV-Schutz 50+ Sommerm\u00fctze zum Binden - Popeline (Bio) Kopfbedeckung",
"rank": 1,
"reviewAmount": 5152,
"reviewRating": 4.6
},
{
"asin": "B0154K62CK",
"mainImage": "https://images-eu.ssl-images-amazon.com/images/I/51r4mejhPuL._AC_UL300_SR300,200_.jpg",
"productImages": [
"https://images-eu.ssl-images-amazon.com/images/I/51r4mejhPuL._AC_UL300_SR300,200_.jpg",
"https://images-eu.ssl-images-amazon.com/images/I/51r4mejhPuL._AC_UL600_SR600,400_.jpg",
"https://images-eu.ssl-images-amazon.com/images/I/51r4mejhPuL._AC_UL900_SR900,600_.jpg"
],
"productLink": "https://www.amazon.de/Sterntaler-Unisex-Flapper-Bindeb%C3%A4ndern-Nackenschutz/dp/B0154K62CK/ref=zg_bs_g_12419321031_d_sccl_2/260-5378242-6478342?psc=1",
"productTitle": "Sterntaler Sonnenhut - Unisex Sommerhut - UV-Schutz 50+ M\u00fctze mit breiter Krempe und Gr\u00f6\u00dfenregulierung - Nackenschutz - Bindeb\u00e4nder - Baby und Kinder Kopfbedeckung aus Popeline (Bio)",
"rank": 2,
"reviewAmount": 4646,
"reviewRating": 4.7
},
{
"asin": "B08F1W2857",
"mainImage": "https://images-eu.ssl-images-amazon.com/images/I/719-LFYpdJL._AC_UL300_SR300,200_.jpg",
"productImages": [
"https://images-eu.ssl-images-amazon.com/images/I/719-LFYpdJL._AC_UL300_SR300,200_.jpg",
"https://images-eu.ssl-images-amazon.com/images/I/719-LFYpdJL._AC_UL600_SR600,400_.jpg",
"https://images-eu.ssl-images-amazon.com/images/I/719-LFYpdJL._AC_UL900_SR900,600_.jpg"
],
"productLink": "https://www.amazon.de/T%C3%B6pfchen-Trainingshose-T%C3%B6pfchentraining-Unterw%C3%A4sche-T%C3%B6pfchen-Trainingshosen/dp/B08F1W2857/ref=zg_bs_g_12419321031_d_sccl_3/260-5378242-6478342?psc=1",
"productTitle": "FLYISH DIRECT T\u00f6pfchen Trainingshose, Kinder T\u00f6pfchentraining Unterw\u00e4sche f\u00fcr Jungen und M\u00e4dchen, Kinder T\u00f6pfchen-Trainingshosen, 3T",
"rank": 3,
"reviewAmount": 4915,
"reviewRating": 4.1
}
],
"categoryId": "12419321031",
"link": "https://www.amazon.de/gp/bestsellers/fashion/12419321031?pg=1"
},
"success": true
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"category_id": "Category ID 'electronics'",
"marketplaceId": "Marketplace ID 'A1PA6795UKMFR9'",
"count": "30",
"api_key": "api_key",
}
response = requests.get("https://sellermagnet-api.com/amazon-bestsellers", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"category_id" => "Category ID 'electronics'",
"marketplaceId" => "Marketplace ID 'A1PA6795UKMFR9'",
"count" => "30",
"api_key" => "api_key",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-bestsellers", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"category_id": "Category ID 'electronics'",
"marketplaceId": "Marketplace ID 'A1PA6795UKMFR9'",
"count": "30",
"api_key": "api_key",
});
fetch("https://sellermagnet-api.com/amazon-bestsellers?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("category_id", "Category ID 'electronics'");
params.put("marketplaceId", "Marketplace ID 'A1PA6795UKMFR9'");
params.put("count", "30");
params.put("api_key", "api_key");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-bestsellers?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("category_id", "Category ID 'electronics'")
params.Add("marketplaceId", "Marketplace ID 'A1PA6795UKMFR9'")
params.Add("count", "30")
params.Add("api_key", "api_key")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-bestsellers?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Get Amazon Deals
Endpoint: /amazon-deals
Method: GET
Description: List categories with active Amazon deals.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| marketplaceId | text | Yes | Marketplace ID (e.g., 'A1PA6795UKMFR9') |
| api_key | text | Yes | Your API key |
| category_id | text | No | Category ID (e.g., 'electronics') |
| geo_location | text | No | Detailed Geo Location ZIP CODE |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"description": "Active deals data.",
"properties": {
"deals": {
"description": "List of active deals.",
"items": {
"additionalProperties": false,
"description": "A single deal entry.",
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"basisPrice": {
"description": "Original price of the product as a string.",
"pattern": "^[0-9]+(\\.[0-9]{1,2})?$",
"type": "string"
},
"coupon_savings": {
"description": "Coupon savings amount as a string, or null if not applicable.",
"pattern": "^[0-9]+(\\.[0-9]{1,2})?$",
"type": [
"string",
"null"
]
},
"dealEndTime": {
"description": "End time of the deal in ISO 8601 format, or \u0027N/A\u0027 if not applicable.",
"format": "date-time",
"type": "string"
},
"dealId": {
"description": "Unique identifier for the deal, or \u0027N/A\u0027 if not applicable.",
"type": "string"
},
"dealLink": {
"description": "URL to the deal page on Amazon.",
"format": "uri",
"type": "string"
},
"dealPrice": {
"additionalProperties": false,
"description": "Price details for the deal.",
"properties": {
"priceCurrency": {
"description": "Currency code (e.g., EUR).",
"type": "string"
},
"priceTotal": {
"description": "Total deal price.",
"minimum": 0,
"type": "number"
}
},
"required": [
"priceCurrency",
"priceTotal"
],
"type": "object"
},
"dealStartTime": {
"description": "Start time of the deal in ISO 8601 format, or \u0027N/A\u0027 if not applicable.",
"format": "date-time",
"type": "string"
},
"image_url": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"productTitle": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
},
"savings_percentage": {
"description": "Percentage of savings for the deal.",
"maximum": 100,
"minimum": 0,
"type": "integer"
}
},
"required": [
"asin",
"basisPrice",
"coupon_savings",
"dealEndTime",
"dealId",
"dealLink",
"dealPrice",
"dealStartTime",
"image_url",
"productTitle",
"savings_percentage"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"deals"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
{
"data": {
"deals": [
{
"asin": "B094YCTK6P",
"basisPrice": "18.69",
"coupon_savings": null,
"dealEndTime": "2025-07-08T16:15:00.000Z",
"dealId": "5675cf93",
"dealLink": "https://www.amazon.de/dp/B094YCTK6P",
"dealPrice": {
"priceCurrency": "EUR",
"priceTotal": 15.89
},
"dealStartTime": "2025-07-08T04:15:00.000Z",
"image_url": "https://images-eu.ssl-images-amazon.com/images/I/717dw8J-hbL.jpg",
"productTitle": "IceUnicorn Krabbelschuhe Baby Lauflernschuhe Jungen M\u00e4dchen Weicher Leder Babyhausschuhe Kleinkind Rutschfeste Lederschuhe Baby",
"savings_percentage": 15
},
{
"asin": "B07TT3DDCV",
"basisPrice": "25.99",
"coupon_savings": null,
"dealEndTime": "2025-07-11T21:59:59.000Z",
"dealId": "b6dfba81",
"dealLink": "https://www.amazon.de/dp/B07TT3DDCV",
"dealPrice": {
"priceCurrency": "EUR",
"priceTotal": 17.9
},
"dealStartTime": "2025-07-07T22:00:00.000Z",
"image_url": "https://images-eu.ssl-images-amazon.com/images/I/81sqngrRBRL.jpg",
"productTitle": "Playshoes Unisex Kinder Matschhose Regenlatzhose Ungef\u00fcttert Wind-und wasserdichte Regenhose Regenbekleidung",
"savings_percentage": 31
},
{
"asin": "B0B31KTXP6",
"basisPrice": "33.0",
"coupon_savings": null,
"dealEndTime": "2025-07-11T21:59:59.000Z",
"dealId": "783116c9",
"dealLink": "https://www.amazon.de/dp/B0B31KTXP6",
"dealPrice": {
"priceCurrency": "EUR",
"priceTotal": 21.8
},
"dealStartTime": "2025-07-07T22:00:00.000Z",
"image_url": "https://images-eu.ssl-images-amazon.com/images/I/412p-qTjLFL.jpg",
"productTitle": "adidas Unisex Kinder Tensaur Hook and Loop Shoes Laufschuhe",
"savings_percentage": 34
}
]
},
"success": true
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"marketplaceId": "Marketplace ID 'A1PA6795UKMFR9'",
"api_key": "api_key",
"category_id": "Category ID 'electronics'",
"geo_location": "geo_location",
}
response = requests.get("https://sellermagnet-api.com/amazon-deals", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"marketplaceId" => "Marketplace ID 'A1PA6795UKMFR9'",
"api_key" => "api_key",
"category_id" => "Category ID 'electronics'",
"geo_location" => "geo_location",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-deals", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"marketplaceId": "Marketplace ID 'A1PA6795UKMFR9'",
"api_key": "api_key",
"category_id": "Category ID 'electronics'",
"geo_location": "geo_location",
});
fetch("https://sellermagnet-api.com/amazon-deals?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("marketplaceId", "Marketplace ID 'A1PA6795UKMFR9'");
params.put("api_key", "api_key");
params.put("category_id", "Category ID 'electronics'");
params.put("geo_location", "geo_location");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-deals?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("marketplaceId", "Marketplace ID 'A1PA6795UKMFR9'")
params.Add("api_key", "api_key")
params.Add("category_id", "Category ID 'electronics'")
params.Add("geo_location", "geo_location")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-deals?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Amazon Product Search Estimated Sells
Endpoint: /amazon-product-search-estimated-sells
Method: GET
Description: Retrieve estimated sales data for an Amazon product by ASIN.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| asin | text | Yes | Product ASIN (e.g., "B08N5WRWNW") |
| marketplaceId | text | Yes | Marketplace ID (e.g., "A1PA6795UKMFR9") |
| api_key | text | Yes | Your API key |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"category": {
"description": "Product category.",
"type": "string"
},
"estimated_monthly_sales": {
"description": "Estimated number of units sold per month.",
"minimum": 0,
"type": "integer"
},
"marketplace_domain": {
"description": "Domain of the marketplace (e.g., \u0027amazon.com\u0027).",
"type": "string"
},
"sales_rank": {
"description": "Current sales rank in the category.",
"minimum": 1,
"type": "integer"
}
},
"required": [
"asin",
"estimated_monthly_sales",
"sales_rank",
"category",
"marketplace_domain"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
{
"data": {
"asin": "B08N5WRWNW",
"estimated_monthly_sales": 121
},
"success": true
}Code Examples
Python
Ruby
Javascript
Java
Go
import requests
# Structure parameters
params = {
"api_key": "YOUR_API_KEY",
"asin": "Product ASIN "B08N5WRWNW"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"api_key": "api_key",
}
response = requests.get("https://sellermagnet-api.com/amazon-product-search-estimated-sells", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"asin" => "Product ASIN "B08N5WRWNW"",
"marketplaceId" => "Marketplace ID "A1PA6795UKMFR9"",
"api_key" => "api_key",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-product-search-estimated-sells", query: params)
puts response.parsed_response
const fetch = require("node-fetch");
const params = new URLSearchParams({
"api_key": "YOUR_API_KEY",
"asin": "Product ASIN "B08N5WRWNW"",
"marketplaceId": "Marketplace ID "A1PA6795UKMFR9"",
"api_key": "api_key",
});
fetch("https://sellermagnet-api.com/amazon-product-search-estimated-sells?" + params)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
Map params = new HashMap<>();
params.put("api_key", "YOUR_API_KEY");
params.put("asin", "Product ASIN "B08N5WRWNW"");
params.put("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"");
params.put("api_key", "api_key");
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://sellermagnet-api.com/amazon-product-search-estimated-sells?" + query))
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import (
"fmt"
"net/http"
"net/url"
"io/ioutil"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("asin", "Product ASIN "B08N5WRWNW"")
params.Add("marketplaceId", "Marketplace ID "A1PA6795UKMFR9"")
params.Add("api_key", "api_key")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-product-search-estimated-sells?"+params.Encode(), nil)
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Getting Started
Follow these steps to integrate SellerMagnetAPI into your application.
1. Sign Up
Create a free account to get your API key. Sign Up Now.
2. Authenticate
Include your API key as a query parameter (api_key=YOUR_API_KEY) in all requests.
3. Test the API
Try the /amazon-product-lookup endpoint with a sample ASIN (e.g., B0CX23V2ZK).
4. Explore Endpoints
Review the endpoints above for use cases like product details, pricing, or reviews.