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": {
"aPlusContent": {
"description": "Indicates if the product has A+ Content.",
"type": "boolean"
},
"asin": {
"description": "Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"bestsellerCategory": {
"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"
},
"bestsellerRank": {
"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"
},
"buyBoxInfo": {
"additionalProperties": false,
"description": "Buy box information.",
"properties": {
"currency_code": {
"description": "Currency code (e.g., USD).",
"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": "Buy box price.",
"minimum": 0,
"type": "number"
},
"sellerId": {
"description": "Unique identifier of the buy box seller.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
}
},
"required": [
"currency_code",
"currency_name",
"currency_symbol",
"price",
"sellerId"
],
"type": "object"
},
"listedSince": {
"description": "Timestamp when the product was first listed, in ISO 8601 format, or null if unavailable.",
"format": "date-time",
"type": [
"string",
"null"
]
},
"listingsDetails": {
"additionalProperties": false,
"description": "Product listing details.",
"properties": {
"productDetails": {
"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 Reviews": {
"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"
},
"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"
},
"productDetailsTech": {
"additionalProperties": true,
"description": "Technical product details (may be empty).",
"type": "object"
}
},
"required": [
"productDetails",
"productDetailsTech"
],
"type": "object"
},
"marketplaceId": {
"description": "Unique identifier for the marketplace.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
},
"productBulletpoints": {
"description": "List of product bullet points.",
"items": {
"description": "A product feature or specification.",
"minLength": 1,
"type": "string"
},
"type": "array"
},
"productDescription": {
"description": "Product description (may be empty).",
"items": {
"description": "A description segment.",
"type": "string"
},
"type": "array"
},
"productDetails": {
"additionalProperties": true,
"description": "Additional product details (may be empty).",
"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"
},
"productMainImage": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"productReviews": {
"additionalProperties": false,
"description": "Product review summary.",
"properties": {
"averageStar": {
"description": "Average star rating.",
"pattern": "^[0-5](\\.\\d)?$",
"type": "string"
},
"reviewTitle": {
"description": "Title of the review summary.",
"type": "string"
},
"totalReviews": {
"description": "Total number of reviews with \u0027ratings\u0027 suffix.",
"pattern": "^[0-9]+(,[0-9]+)? ratings$",
"type": "string"
}
},
"required": [
"averageStar",
"reviewTitle",
"totalReviews"
],
"type": "object"
},
"productTitle": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
},
"productVariations": {
"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"
},
"title": {
"description": "Title of the variation.",
"minLength": 1,
"type": "string"
}
},
"required": [
"asin",
"title"
],
"type": "object"
},
"type": "array"
},
"productVideo": {
"description": "List of product video URLs.",
"items": {
"description": "URL to a product video.",
"format": "uri",
"type": "string"
},
"type": "array"
}
},
"required": [
"aPlusContent",
"asin",
"bestsellerCategory",
"bestsellerRank",
"buyBoxInfo",
"listedSince",
"listingsDetails",
"marketplaceId",
"productBulletpoints",
"productDescription",
"productDetails",
"productImages",
"productLink",
"productMainImage",
"productReviews",
"productTitle",
"productVariations",
"productVideo"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
{
"data": {
"aPlusContent": true,
"asin": "B0CL61F39H",
"bestsellerCategory": {
"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"
}
},
"bestsellerRank": {
"main_category": {
"name": "PlayStation 5 Consoles",
"rank": 1
},
"subcategory": {
"name": "",
"rank": 0
}
},
"buyBoxInfo": {
"currency_code": "USD",
"currency_name": "United States Dollar",
"currency_symbol": "$",
"price": 489.99,
"sellerId": "A280NRE8KX931R"
},
"listedSince": null,
"listingsDetails": {
"productDetails": {
"ASIN": "B0CL61F39H",
"Batteries": "1 Lithium Ion batteries required. (included)",
"Best Sellers Rank": "#30 in Video Games (See Top 100 in Video Games) #1 in PlayStation 5 Consoles",
"Customer Reviews": "4.7 4.7 out of 5 stars 6,998 ratings 4.7 out of 5 stars",
"Date First Available": "December 10, 2023",
"Item Weight": "10.6 pounds",
"Item model number": "CFI-2015",
"Manufacturer": "Sony",
"Product Dimensions": "14 x 17 x 7 inches; 10.6 Pounds",
"Release date": "December 10, 2023",
"Type of item": "Video Game"
},
"productDetailsTech": {}
},
"marketplaceId": "ATVPDKIKX0DER",
"productBulletpoints": [
"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"
],
"productDescription": [],
"productDetails": {},
"productImages": [
"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"
],
"productLink": "https://www.amazon.com/dp/B0CL61F39H",
"productMainImage": "https://m.media-amazon.com/images/I/31kTNmpm6vL.jpg",
"productReviews": {
"averageStar": "4.7",
"reviewTitle": "4.7 out of 5 stars",
"totalReviews": "6,998 ratings"
},
"productTitle": "PlayStation\u00ae5 console (slim)",
"productVariations": [
{
"asin": "B0F691TJTP",
"title": "PS5/ Slim/Pro Stand for Disc \u0026 Digital Console, PS5 Cooling Station with Dual Controller Charging Station for PlayStation 5 Console, 3-Level Fan PlayStation 5 Controller Charger Accessories Stand"
}
],
"productVideo": [
"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 and seller details.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| asin | text | Yes | Product ASIN (e.g., "B08N5WRWNW") |
| marketplaceId | text | Yes | Marketplace ID (e.g., "A1PA6795UKMFR9") |
| count | number | No | Number of offers (max 20, default 10) |
| 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"
},
"buyBoxInfo": {
"additionalProperties": false,
"description": "Buy box information.",
"properties": {
"currency_code": {
"description": "Currency code (e.g., USD).",
"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": "Buy box price.",
"minimum": 0,
"type": "number"
},
"sellerId": {
"description": "Unique identifier of the buy box seller.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
}
},
"required": [
"currency_code",
"currency_name",
"currency_symbol",
"price",
"sellerId"
],
"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": {
"inventory": {
"additionalProperties": false,
"description": "Inventory details for the offer.",
"properties": {
"amount": {
"description": "Number of items in stock.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount"
],
"type": "object"
},
"offerFulfillment": {
"description": "Fulfillment method (FBA or FBM).",
"enum": [
"FBA",
"FBM"
],
"type": "string"
},
"offerPrice": {
"additionalProperties": false,
"description": "Price details for the offer.",
"properties": {
"priceCurrency": {
"description": "Currency symbol for the offer price.",
"minLength": 1,
"type": "string"
},
"priceTotal": {
"description": "Total price of the offer.",
"minimum": 0,
"type": "number"
}
},
"required": [
"priceCurrency",
"priceTotal"
],
"type": "object"
},
"offerSellerId": {
"description": "Unique identifier of the seller for the offer.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
},
"reviewDetails": {
"additionalProperties": false,
"description": "Review details for the seller.",
"properties": {
"positivePercentage": {
"description": "Percentage of positive reviews for the seller.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"totalReviewAmount": {
"description": "Total number of reviews for the seller.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"positivePercentage",
"totalReviewAmount"
],
"type": "object"
},
"shippingOffers": {
"description": "List of shipping options for the offer.",
"items": {
"additionalProperties": false,
"description": "A shipping option for the offer.",
"properties": {
"delivery_date": {
"description": "Expected delivery date in ISO 8601 format.",
"format": "date-time",
"type": "string"
},
"shipping_price": {
"description": "Shipping cost for the offer.",
"minimum": 0,
"type": "number"
}
},
"required": [
"delivery_date",
"shipping_price"
],
"type": "object"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"inventory",
"offerFulfillment",
"offerPrice",
"offerSellerId",
"reviewDetails",
"shippingOffers"
],
"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",
"buyBoxInfo",
"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": "B0BNJPL4MW",
"buyBoxInfo": {
"currency_code": "USD",
"currency_name": "United States Dollar",
"currency_symbol": "$",
"price": 46.81,
"sellerId": "A02211013Q5HP3OMSZC7W"
},
"marketplaceId": "ATVPDKIKX0DER",
"offers": [
{
"inventory": {
"amount": 30
},
"offerFulfillment": "FBA",
"offerPrice": {
"priceCurrency": "$",
"priceTotal": 46.81
},
"offerSellerId": "A02211013Q5HP3OMSZC7W",
"reviewDetails": {
"positivePercentage": 100,
"totalReviewAmount": 51317
},
"shippingOffers": [
{
"delivery_date": "Fri, 27 Jun 2025 00:00:00 GMT",
"shipping_price": 7.34
}
]
},
{
"inventory": {
"amount": 30
},
"offerFulfillment": "FBA",
"offerPrice": {
"priceCurrency": "$",
"priceTotal": 46.81
},
"offerSellerId": "A2PT9RMMP5ZM4K",
"reviewDetails": {
"positivePercentage": 100,
"totalReviewAmount": 14
},
"shippingOffers": [
{
"delivery_date": "Fri, 27 Jun 2025 00:00:00 GMT",
"shipping_price": 7.34
}
]
},
{
"inventory": {
"amount": 8
},
"offerFulfillment": "FBA",
"offerPrice": {
"priceCurrency": "$",
"priceTotal": 46.81
},
"offerSellerId": "AZL02BCKN4YR6",
"reviewDetails": {
"positivePercentage": 100,
"totalReviewAmount": 1923
},
"shippingOffers": [
{
"delivery_date": "Fri, 27 Jun 2025 00:00:00 GMT",
"shipping_price": 7.34
}
]
},
{
"inventory": {
"amount": 4
},
"offerFulfillment": "FBA",
"offerPrice": {
"priceCurrency": "$",
"priceTotal": 46.81
},
"offerSellerId": "A3D2XS1XYSLCFW",
"reviewDetails": {
"positivePercentage": 93,
"totalReviewAmount": 15
},
"shippingOffers": [
{
"delivery_date": "Fri, 27 Jun 2025 00:00:00 GMT",
"shipping_price": 7.34
}
]
},
{
"inventory": {
"amount": 6
},
"offerFulfillment": "FBA",
"offerPrice": {
"priceCurrency": "$",
"priceTotal": 46.81
},
"offerSellerId": "A1834T3KJ5L4MI",
"reviewDetails": {
"positivePercentage": 100,
"totalReviewAmount": 1
},
"shippingOffers": [
{
"delivery_date": "Wed, 01 Jul 2026 00:00:00 GMT",
"shipping_price": 7.34
}
]
}
],
"productLink": "https://www.amazon.com/dp/B0BNJPL4MW",
"productMainImage": "https://m.media-amazon.com/images/I/51PRLuKqT4L.jpg",
"productTitle": "New Raspberry Pi 3 Model B+ Board (3B+) Raspberry PI 3B+ (1GB) (3B Plus)"
},
"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"",
"count": "30",
"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"",
"count" => "30",
"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"",
"count": "30",
"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("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-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("count", "30")
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) |
| 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"
},
"link": {
"description": "URL to the product page on Amazon.",
"format": "uri",
"type": "string"
},
"listingPrice": {
"additionalProperties": false,
"description": "Listing price information.",
"properties": {
"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.",
"maximum": 5,
"minimum": 0,
"type": "number"
},
"sponsored": {
"description": "Indicates if the product is a sponsored listing.",
"type": "boolean"
}
},
"required": [
"asin",
"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": "B0D1N3V2FF",
"link": "https://www.amazon.de/dp/B0D1N3V2FF",
"listingPrice": {
"price": {
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "\u20ac",
"total": "94.90"
}
},
"mainImage": "https://m.media-amazon.com/images/I/81OJp1OW7XL._AC_UL320_.jpg",
"on_sale": false,
"position": 1,
"productTitle": "Raspberry Pi 4 4GB Starter-Kit | 64GB Edition | Offizielles Netzteil 15W | Offizielles Geh\u00e4use | 4k Micro HDMI Kabel | K\u00fchlk\u00f6rper Set | USB-Kartenleser",
"reviewAmount": 190,
"reviewRating": 4.3,
"sponsored": false
},
{
"asin": "B0CRMQCYXH",
"link": "https://www.amazon.de/dp/B0CRMQCYXH",
"listingPrice": {
"price": {
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "\u20ac",
"total": "149.90"
}
},
"mainImage": "https://m.media-amazon.com/images/I/81HqfXer2RL._AC_UL320_.jpg",
"on_sale": false,
"position": 2,
"productTitle": "Raspberry Pi 5 8GB PCIe M.2 NVMe - Set | Metallgeh\u00e4use | Active Cooler | M.2 NVMe SSD PCIe Board | Offizielles USB-C 27W Netzteil | 64GB Edition | 4K Micro HDMI",
"reviewAmount": 114,
"reviewRating": 4.3,
"sponsored": false
},
{
"asin": "B0CRPF47RG",
"link": "https://www.amazon.de/dp/B0CRPF47RG",
"listingPrice": {
"price": {
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "\u20ac",
"total": "139.90"
}
},
"mainImage": "https://m.media-amazon.com/images/I/811z9f9YjSL._AC_UL320_.jpg",
"on_sale": false,
"position": 3,
"productTitle": "Raspberry Pi 5 8GB Starter-Kit | 128GB Edition | Offizielles 27W Netzteil | Offizielles Geh\u00e4use mit L\u00fcfter | 4K Micro HDMI Kabel 1m | Alu-K\u00fchlk\u00f6rper",
"reviewAmount": 373,
"reviewRating": 4.5,
"sponsored": false
},
{
"asin": "B0CYLBX3HQ",
"link": "https://www.amazon.de/dp/B0CYLBX3HQ",
"listingPrice": {
"price": {
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "\u20ac",
"total": "12.65"
}
},
"mainImage": "https://m.media-amazon.com/images/I/61gzz0N4trL._AC_UL320_.jpg",
"on_sale": false,
"position": 4,
"productTitle": "GeeekPi Metall Geh\u00e4use f\u00fcr Raspberry Pi 5,Support PCIe M.2 NVMe SSD Shield Top X1001 / X1003 / X1000 / N04 / N05 \u0026 Raspberry Pi 5 Active Cooler (Not Included)",
"reviewAmount": 125,
"reviewRating": 4.6,
"sponsored": false
},
{
"asin": "B0B9M5SCG4",
"link": "https://www.amazon.de/dp/B0B9M5SCG4",
"listingPrice": {
"price": {
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "\u20ac",
"total": "65.99"
}
},
"mainImage": "https://m.media-amazon.com/images/I/61uamJ4ixjL._AC_UL320_.jpg",
"on_sale": false,
"position": 5,
"productTitle": "HAMTYSAN Raspberry Pi Touch Screen, 10.1 Zoll Bildschirm 1024x600 Kleiner tragbarer HDMI IPS Monitor mit St\u00e4nder, f\u00fcr Raspberry Pi 400/4/3/2/Zero/B/B+ Jetson Nano Win11/10/8/7",
"reviewAmount": 328,
"reviewRating": 4.3,
"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",
"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",
"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",
"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("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("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
No JSON schema available for this endpoint.
Response Example
{
"bestsellers": [
{
"asin": "B08N5WRWNW",
"rank": 1,
"title": "Top Product"
}
],
"category": "electronics"
}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 Categories
Endpoint: /amazon-deals-categories
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 |
JSON Schema
No JSON schema available for this endpoint.
Response Example
{
"categories": [
{
"id": "deals-electronics",
"name": "Electronics Deals"
}
]
}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",
}
response = requests.get("https://sellermagnet-api.com/amazon-deals-categories", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"marketplaceId" => "Marketplace ID "A1PA6795UKMFR9"",
"api_key" => "api_key",
}
response = HTTParty.get("https://sellermagnet-api.com/amazon-deals-categories", 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",
});
fetch("https://sellermagnet-api.com/amazon-deals-categories?" + 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");
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-categories?" + 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")
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://sellermagnet-api.com/amazon-deals-categories?"+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.