API Reference
SellerMagnet API
SellerMagnet API
Documentation
Comprehensive endpoint documentation with parameter tables, JSON response examples, and code snippets in five languages. Everything you need to integrate real-time Amazon data into your application.
500 free credits • No credit card required • Cancel anytime
API Endpoint Reference
GET /amazon-product-lookup
Live
GET /amazon-search
Live
GET /amazon-product-offers
Live
GET /amazon-bestsellers
Live
POST /amazon-data-pipeline
Beta
12+
Endpoints
5
Languages
REST
API Style
API Reference
Endpoint Documentation
Browse every endpoint, parameter, response schema and code snippet in one place.
GET
/amazon-product-statistics
Amazon Product Statistics
Retrieve detailed statistics for an Amazon product, including sales rank and review counts.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
asin |
text | Required | Product ASIN (e.g., "B08N5WRWNW") |
marketplaceId |
text | Required | Marketplace ID (e.g., "A1PA6795UKMFR9") |
api_key |
text | Required | Your API key |
graphs |
text | Optional | Generate visually graphs for history data |
JSON Schema
{'$schema': 'http://json-schema.org/draft-07/schema#', 'title': 'Amazon Item Tracking Response Schema', 'description': 'The response schema for Amazon item tracking data, including core item details, historical data, and optional extensions for graphs or metadata.', 'type': 'object', 'properties': {'success': {'type': 'boolean', 'description': 'Indicates whether the request to retrieve the item tracking data was successful.'}, 'data': {'type': 'object', 'description': 'Core data object with item tracking details and optional extensions.', 'properties': {'asin': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'The Amazon Standard Identification Number (ASIN) for the item, a 10-character alphanumeric identifier.'}, 'amazonPrice': {'type': ['number', 'null'], 'description': 'The current price of the item on Amazon (in cents), or null if not available.'}, 'bestSellerRank': {'type': 'integer', 'minimum': 1, 'description': 'The current best seller rank of the item in its category.'}, 'buyBoxPrice': {'type': 'integer', 'minimum': 0, 'description': 'The current price of the item in the Buy Box (in cents).'}, 'buyBoxFulfillment': {'type': 'string', 'enum': ['FBM', 'FBA', 'AMZ'], 'description': "The fulfillment method for the Buy Box. Possible values: 'FBM' (Fulfilled by Merchant), 'FBA' (Fulfilled by Amazon), 'AMZ' (sold directly by Amazon)."}, 'buyBoxSellerIdHistory': {'type': 'array', 'description': 'A chronological list of Buy Box seller changes, including timestamps and seller IDs.', 'items': {'type': 'array', 'minItems': 2, 'maxItems': 2, 'items': [{'type': 'string', 'format': 'date-time', 'description': 'The timestamp when the Buy Box seller was recorded, in ISO 8601 format.'}, {'type': 'string', 'description': "The seller ID for the Buy Box at the given timestamp, or '-1' if no seller held the Buy Box."}], 'description': 'A tuple of [timestamp, sellerId] representing a Buy Box seller change.'}}, 'salesRankHistory': {'type': 'array', 'description': "A chronological list of the item's sales rank changes, including timestamps and rank values.", 'items': {'type': 'array', 'minItems': 2, 'maxItems': 2, 'items': [{'type': 'string', 'format': 'date-time', 'description': 'The timestamp when the sales rank was recorded, in ISO 8601 format.'}, {'type': 'integer', 'minimum': 1, 'description': 'The sales rank of the item at the given timestamp.'}], 'description': 'A tuple of [timestamp, salesRank] representing a sales rank record.'}}, 'trackingSince': {'type': 'string', 'format': 'date', 'description': 'The date when tracking of the item began, in YYYY-MM-DD format.'}, 'graphs': {'type': ['object', 'null'], 'description': 'Placeholder for graph-related data, allowing flexibility for additional visualization types.', 'properties': {'priceTrend': {'type': 'array', 'description': 'Data points for visualizing price trends over time.', 'items': {'type': 'object', 'properties': {'timestamp': {'type': 'string', 'format': 'date-time', 'description': 'The timestamp for the price data point.'}, 'price': {'type': 'integer', 'minimum': 0, 'description': 'The price at the given timestamp (in cents).'}}, 'required': ['timestamp', 'price']}}, 'rankTrend': {'type': 'array', 'description': 'Data points for visualizing sales rank trends over time.', 'items': {'type': 'object', 'properties': {'timestamp': {'type': 'string', 'format': 'date-time', 'description': 'The timestamp for the rank data point.'}, 'rank': {'type': 'integer', 'minimum': 1, 'description': 'The sales rank at the given timestamp.'}}, 'required': ['timestamp', 'rank']}}}, 'additionalProperties': True}, 'metadata': {'type': ['object', 'null'], 'description': 'Flexible metadata field for additional item or tracking information.', 'properties': {'category': {'type': 'string', 'description': "The Amazon category of the item (e.g., 'Electronics')."}, 'lastUpdated': {'type': 'string', 'format': 'date-time', 'description': 'The timestamp when the data was last updated.'}}, 'additionalProperties': True}}, 'required': ['asin', 'amazonPrice', 'bestSellerRank', 'buyBoxPrice', 'buyBoxFulfillment', 'buyBoxSellerIdHistory', 'salesRankHistory', 'trackingSince'], 'additionalProperties': True}, 'errors': {'type': ['array', 'null'], 'description': 'Optional list of error messages if the request was not fully successful. Not present in the provided document but included for robustness.', 'items': {'type': 'object', 'properties': {'code': {'type': 'string', 'description': 'A unique error code.'}, 'message': {'type': 'string', 'description': 'A human-readable error message.'}}, 'required': ['code', 'message']}}}, 'required': ['success', 'data'], 'additionalProperties': False}Response Example
200 OK
application/json
{
"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 Example
amazon_product_statistics.py
Python
Ruby
Javascript
Java
Go
import requests
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/api/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/api/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/api/amazon-product-statistics?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-product-statistics?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
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")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-product-statistics?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
GET
/amazon-asin-converter
Amazon ASIN Converter
Convert between ASIN and EAN identifiers for Amazon products.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
asin |
text | Required | ASIN or EAN to convert (e.g., "B08N5WRWNW" or "9781234567890") |
marketplaceId |
text | Required | Marketplace ID (e.g., "A1PA6795UKMFR9") |
conversion_direction |
text | Required | Conversion direction: "asin-to-ean" or "ean-to-asin" |
api_key |
text | Required | Your API key |
JSON Schema
{'$schema': 'http://json-schema.org/draft-07/schema#', 'type': 'object', 'properties': {'data': {'type': 'object', 'properties': {'asin': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.'}, 'eanList': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[0-9]{12,14}$', 'description': 'European Article Number (EAN), a 12- or 13-digit identifier.'}, 'minItems': 1, 'description': 'List of EAN codes associated with the product.'}, 'listedSince': {'type': 'string', 'format': 'date-time', 'description': 'Timestamp indicating when the product was first listed, in ISO 8601 format.'}, 'productTitle': {'type': 'string', 'minLength': 1, 'description': 'Title or name of the product.'}}, 'required': ['asin', 'eanList', 'listedSince', 'productTitle'], 'additionalProperties': False}, 'success': {'type': 'boolean', 'description': 'Indicates whether the API request was successful.'}}, 'required': ['data', 'success'], 'additionalProperties': False}Response Example
200 OK
application/json
{
"data": {
"asin": "B0CLTBHXWQ",
"eanList": [
"0711719577294"
],
"listedSince": "2023-12-30 01:00:00",
"productTitle": "Playstation 5 Console Edizione Digital Slim"
},
"success": true
}Code Example
amazon_asin_converter.py
Python
Ruby
Javascript
Java
Go
import requests
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/api/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/api/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/api/amazon-asin-converter?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-asin-converter?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
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")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-asin-converter?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
GET
/amazon-seller-review
Get Amazon Seller Review
Fetch review details for a specific Amazon seller.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
sellerId |
text | Required | Seller ID (e.g., "A1B2C3D4E5F6G7") |
marketplaceId |
text | Required | Marketplace ID (e.g., "A1PA6795UKMFR9") |
api_key |
text | Required | Your API key |
JSON Schema
{'$schema': 'http://json-schema.org/draft-07/schema#', 'type': 'object', 'properties': {'data': {'type': 'object', 'properties': {'marketplace': {'type': 'object', 'additionalProperties': {'type': 'object', 'properties': {'last5Reviews': {'type': 'array', 'items': {'type': 'object', 'properties': {'dateRated': {'type': 'string', 'description': 'Date and reviewer name of the review, in a human-readable format.'}, 'reviewText': {'type': 'string', 'minLength': 1, 'description': 'Text content of the review.'}, 'starRating': {'type': 'string', 'pattern': '^[1-5] out of 5 stars$', 'description': "Star rating of the review, formatted as 'X out of 5 stars'."}}, 'required': ['dateRated', 'reviewText', 'starRating'], 'additionalProperties': False}, 'maxItems': 5, 'description': 'List of up to 5 most recent customer reviews.'}, 'sellerFeedback': {'type': 'object', 'properties': {'30': {'type': 'object', 'properties': {'rating': {'type': 'string', 'pattern': '^[0-5](\\.\\d)?$', 'description': 'Average rating over the last 30 days.'}, 'reviewsCount': {'type': 'string', 'pattern': '^[0-9]+$', 'description': 'Number of reviews over the last 30 days.'}}, 'required': ['rating', 'reviewsCount'], 'additionalProperties': False}, '90': {'type': 'object', 'properties': {'rating': {'type': 'string', 'pattern': '^[0-5](\\.\\d)?$', 'description': 'Average rating over the last 90 days.'}, 'reviewsCount': {'type': 'string', 'pattern': '^[0-9]+$', 'description': 'Number of reviews over the last 90 days.'}}, 'required': ['rating', 'reviewsCount'], 'additionalProperties': False}, '365': {'type': 'object', 'properties': {'rating': {'type': 'string', 'pattern': '^[0-5](\\.\\d)?$', 'description': 'Average rating over the last 365 days.'}, 'reviewsCount': {'type': 'string', 'pattern': '^[0-9]+$', 'description': 'Number of reviews over the last 365 days.'}}, 'required': ['rating', 'reviewsCount'], 'additionalProperties': False}, 'lifetime': {'type': 'object', 'properties': {'rating': {'type': 'string', 'pattern': '^[0-5](\\.\\d)?$', 'description': "Average rating over the seller's lifetime."}, 'reviewsCount': {'type': 'string', 'pattern': '^[0-9]+(,[0-9]+)?$', 'description': "Total number of reviews over the seller's lifetime, with optional comma for thousands."}}, 'required': ['rating', 'reviewsCount'], 'additionalProperties': False}}, 'required': ['30', '90', '365', 'lifetime'], 'additionalProperties': False, 'description': 'Seller feedback ratings and review counts over different time periods.'}}, 'required': ['last5Reviews', 'sellerFeedback'], 'additionalProperties': False}, 'description': 'Marketplace-specific data, keyed by marketplace ID.'}, 'sellerId': {'type': 'string', 'pattern': '^[A-Z0-9]+$', 'description': 'Unique identifier for the seller.'}}, 'required': ['marketplace', 'sellerId'], 'additionalProperties': False}, 'success': {'type': 'boolean', 'description': 'Indicates whether the API request was successful.'}}, 'required': ['data', 'success'], 'additionalProperties': False}Response Example
200 OK
application/json
{
"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 Example
get_amazon_seller_review.py
Python
Ruby
Javascript
Java
Go
import requests
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/api/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/api/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/api/amazon-seller-review?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-seller-review?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
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")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-seller-review?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
GET
/amazon-product-lookup
Get Amazon Product
Retrieve detailed product information for a given ASIN.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
asin |
text | Required | Product ASIN (e.g., 'B08N5WRWNW') |
marketplaceId |
text | Required | Marketplace ID (e.g., 'A1PA6795UKMFR9') |
api_key |
text | Required | Your API key |
JSON Schema
{'$schema': 'http://json-schema.org/draft-07/schema#', 'type': 'object', 'properties': {'data': {'type': 'object', 'properties': {'productInfo': {'type': 'object', 'properties': {'additionalDetails': {'type': 'object', 'properties': {'ASIN': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'Amazon Standard Identification Number (ASIN).'}, 'Batteries': {'type': 'string', 'description': 'Battery requirements.'}, 'Best Sellers Rank': {'type': 'string', 'description': 'Bestseller rank information.'}, 'Customer Rating': {'type': 'string', 'description': 'Customer review summary.'}, 'Date First Available': {'type': 'string', 'description': 'Date the product was first available.'}, 'Item Weight': {'type': 'string', 'description': 'Weight of the item.'}, 'Item model number': {'type': 'string', 'description': 'Model number of the item.'}, 'Manufacturer': {'type': 'string', 'description': 'Manufacturer of the product.'}, 'Number of Reviews': {'type': 'string', 'description': "Total number of reviews with 'ratings' suffix."}, 'Product Dimensions': {'type': 'string', 'description': 'Dimensions of the product.'}, 'Release date': {'type': 'string', 'description': 'Release date of the product.'}, 'Type of item': {'type': 'string', 'description': 'Type of the item.'}}, 'required': ['ASIN'], 'additionalProperties': True, 'description': 'Detailed product information.'}, 'asin': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.'}, 'bestsellerRanks': {'type': 'object', 'properties': {'main_category': {'type': 'object', 'properties': {'name': {'type': 'string', 'minLength': 1, 'description': 'Name of the main category.'}, 'rank': {'type': 'integer', 'minimum': 1, 'description': 'Bestseller rank in the main category.'}}, 'required': ['name', 'rank'], 'additionalProperties': False}, 'subcategory': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Name of the subcategory (may be empty).'}, 'rank': {'type': 'integer', 'minimum': 0, 'description': 'Bestseller rank in the subcategory (0 if not applicable).'}}, 'required': ['name', 'rank'], 'additionalProperties': False}}, 'required': ['main_category', 'subcategory'], 'additionalProperties': False, 'description': 'Bestseller rank information.'}, 'bulletPoints': {'type': 'array', 'items': {'type': 'string', 'minLength': 1, 'description': 'A product feature or specification.'}, 'description': 'List of product bullet points.'}, 'buyBoxInfo': {'type': 'object', 'properties': {'currencyCode': {'type': 'string', 'description': 'Currency code (e.g., USD).'}, 'currencyName': {'type': 'string', 'minLength': 1, 'description': 'Full name of the currency.'}, 'currencySymbol': {'type': 'string', 'minLength': 1, 'description': 'Symbol of the currency.'}, 'price': {'type': 'number', 'minimum': 0, 'description': 'Buy box price.'}, 'sellerId': {'type': 'string', 'pattern': '^[A-Z0-9]+$', 'description': 'Unique identifier of the buy box seller.'}}, 'required': ['currencyCode', 'currencyName', 'currencySymbol', 'price', 'sellerId'], 'additionalProperties': False, 'description': 'Buy box information.'}, 'categories': {'type': 'object', 'properties': {'bestsellerCategory': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Category identifier.'}, 'index': {'type': 'integer', 'minimum': 1, 'description': 'Index of the category in the hierarchy.'}, 'name': {'type': 'string', 'minLength': 1, 'description': 'Name of the category.'}, 'url': {'type': 'string', 'format': 'uri', 'description': 'URL to the category page on Amazon.'}}, 'required': ['id', 'index', 'name', 'url'], 'additionalProperties': False}, 'description': 'List of bestseller categories.'}, 'rootCategory': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Root category identifier.'}, 'name': {'type': 'string', 'minLength': 1, 'description': 'Name of the root category.'}, 'url': {'type': 'string', 'format': 'uri', 'description': 'URL to the root category page on Amazon.'}}, 'required': ['id', 'name', 'url'], 'additionalProperties': False, 'description': 'Root category details.'}}, 'required': ['bestsellerCategory', 'rootCategory'], 'additionalProperties': False, 'description': 'Bestseller category information.'}, 'description': {'type': 'array', 'items': {'type': 'string', 'description': 'A description segment.'}, 'description': 'Product description (may be empty).'}, 'details': {'type': 'object', 'properties': {'ASIN': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'Amazon Standard Identification Number (ASIN).'}, 'Batteries': {'type': 'string', 'description': 'Battery requirements.'}, 'Date First Available': {'type': 'string', 'description': 'Date the product was first available.'}, 'Item Weight': {'type': 'string', 'description': 'Weight of the item.'}, 'Item model number': {'type': 'string', 'description': 'Model number of the item.'}, 'Manufacturer': {'type': 'string', 'description': 'Manufacturer of the product.'}, 'Platform': {'type': 'string', 'description': 'Platform of the product.'}, 'Product Dimensions': {'type': 'string', 'description': 'Dimensions of the product.'}, 'Release date': {'type': 'string', 'description': 'Release date of the product.'}, 'Type of item': {'type': 'string', 'description': 'Type of the item.'}}, 'required': ['ASIN'], 'additionalProperties': True, 'description': 'Additional product details.'}, 'hasAPlusContent': {'type': 'boolean', 'description': 'Indicates if the product has A+ Content.'}, 'images': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'description': 'URL to a product image.'}, 'description': 'List of product image URLs.'}, 'link': {'type': 'string', 'format': 'uri', 'description': 'URL to the product page on Amazon.'}, 'listedSinceDate': {'type': ['string', 'null'], 'format': 'date', 'description': 'Date when the product was first listed, in YYYY-MM-DD format, or null if unavailable.'}, 'mainImage': {'type': 'string', 'format': 'uri', 'description': 'URL to the main product image.'}, 'marketplaceId': {'type': 'string', 'pattern': '^[A-Z0-9]+$', 'description': 'Unique identifier for the marketplace.'}, 'reviews': {'type': 'object', 'properties': {'averageRating': {'type': 'number', 'minimum': 0, 'maximum': 5, 'description': 'Average star rating.'}, 'reviewSummary': {'type': 'string', 'description': 'Title of the review summary.'}, 'totalReviews': {'type': 'integer', 'minimum': 0, 'description': 'Total number of reviews.'}}, 'required': ['averageRating', 'reviewSummary', 'totalReviews'], 'additionalProperties': False, 'description': 'Product review summary.'}, 'title': {'type': 'string', 'minLength': 1, 'description': 'Title of the product.'}, 'variations': {'type': 'array', 'items': {'type': 'object', 'properties': {'asin': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'ASIN of the variation.'}, 'attributes': {'type': 'object', 'additionalProperties': True, 'description': 'Attributes of the variation (e.g., Pattern Name, Style).'}}, 'required': ['asin', 'attributes'], 'additionalProperties': False, 'description': 'A product variation.'}, 'description': 'List of product variations.'}, 'videos': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'description': 'URL to a product video.'}, 'description': 'List of product video URLs.'}}, 'required': ['additionalDetails', 'asin', 'bestsellerRanks', 'bulletPoints', 'buyBoxInfo', 'categories', 'description', 'details', 'hasAPlusContent', 'images', 'link', 'listedSinceDate', 'mainImage', 'marketplaceId', 'reviews', 'title', 'variations', 'videos'], 'additionalProperties': False, 'description': 'Detailed product information.'}}, 'required': ['productInfo'], 'additionalProperties': False}, 'success': {'type': 'boolean', 'description': 'Indicates whether the API request was successful.'}}, 'required': ['data', 'success'], 'additionalProperties': False}Response Example
200 OK
application/json
{
"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 Example
get_amazon_product.py
Python
Ruby
Javascript
Java
Go
import requests
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/api/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/api/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/api/amazon-product-lookup?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-product-lookup?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
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")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-product-lookup?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
GET
/amazon-product-offers
Get Amazon Product Offers
List offers for a product, including price, seller, condition, and inventory details.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
asin |
text | Required | Product ASIN (e.g., 'B08N5WRWNW') |
marketplaceId |
text | Required | Marketplace ID (e.g., 'A1PA6795UKMFR9') |
geo_location |
text | Optional | Detailed Geo Location ZIP CODE |
api_key |
text | Required | Your API key |
JSON Schema
{'$schema': 'http://json-schema.org/draft-07/schema#', 'type': 'object', 'properties': {'data': {'type': 'object', 'properties': {'asin': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.'}, 'buyBox': {'type': 'object', 'properties': {'condition': {'type': 'string', 'enum': ['New', 'Used - Like New', 'Used - Very Good', 'Used - Good', 'Used - Acceptable'], 'description': 'Condition of the buy box product.'}, 'deliveryDate': {'type': 'string', 'format': 'date', 'description': 'Expected delivery date in YYYY-MM-DD format.'}, 'fulfillmentType': {'type': 'string', 'enum': ['FBA', 'FBM'], 'description': 'Fulfillment method (FBA or FBM).'}, 'inventory': {'type': 'integer', 'minimum': 0, 'description': "Number of items available in seller's inventory."}, 'positivePercentage': {'type': 'integer', 'minimum': 0, 'maximum': 100, 'description': 'Percentage of positive reviews for the seller.'}, 'priceWithoutShipping': {'type': 'number', 'minimum': 0, 'description': 'Price excluding shipping.'}, 'sellerId': {'type': 'string', 'pattern': '^[A-Z0-9]+$|^Amazon$', 'description': "Unique identifier of the buy box seller or 'Amazon'."}, 'sellerName': {'type': 'string', 'minLength': 1, 'description': 'Name of the buy box seller.'}, 'shippingPrice': {'type': 'number', 'minimum': 0, 'description': 'Shipping cost for the buy box offer.'}, 'totalPrice': {'type': 'number', 'minimum': 0, 'description': 'Total price including shipping.'}, 'totalReviews': {'type': 'integer', 'minimum': 0, 'description': 'Total number of reviews for the seller.'}}, 'required': ['condition', 'deliveryDate', 'fulfillmentType', 'inventory', 'positivePercentage', 'priceWithoutShipping', 'sellerId', 'sellerName', 'shippingPrice', 'totalPrice', 'totalReviews'], 'additionalProperties': False, 'description': 'Buy box information.'}, 'currency': {'type': 'object', 'properties': {'code': {'type': 'string', 'description': 'Currency code (e.g., USD).'}, 'name': {'type': 'string', 'minLength': 1, 'description': 'Full name of the currency.'}, 'symbol': {'type': 'string', 'minLength': 1, 'description': 'Symbol of the currency.'}}, 'required': ['code', 'name', 'symbol'], 'additionalProperties': False, 'description': 'Currency details.'}, 'marketplaceId': {'type': 'string', 'pattern': '^[A-Z0-9]+$', 'description': 'Unique identifier for the marketplace.'}, 'offers': {'type': 'array', 'items': {'type': 'object', 'properties': {'condition': {'type': 'string', 'enum': ['New', 'Used - Like New', 'Used - Very Good', 'Used - Good', 'Used - Acceptable'], 'description': 'Condition of the product.'}, 'deliveryDate': {'type': 'string', 'format': 'date', 'description': 'Expected delivery date in YYYY-MM-DD format.'}, 'fulfillmentType': {'type': 'string', 'enum': ['FBA', 'FBM'], 'description': 'Fulfillment method (FBA or FBM).'}, 'inventory': {'type': 'integer', 'minimum': 0, 'description': "Number of items available in seller's inventory."}, 'positivePercentage': {'type': 'integer', 'minimum': 0, 'maximum': 100, 'description': 'Percentage of positive reviews for the seller.'}, 'priceWithoutShipping': {'type': 'number', 'minimum': 0, 'description': 'Price excluding shipping.'}, 'sellerId': {'type': 'string', 'pattern': '^[A-Z0-9]+$|^Amazon$', 'description': "Unique identifier of the seller or 'Amazon'."}, 'sellerName': {'type': 'string', 'minLength': 1, 'description': 'Name of the seller.'}, 'shippingPrice': {'type': 'number', 'minimum': 0, 'description': 'Shipping cost for the offer.'}, 'totalPrice': {'type': 'number', 'minimum': 0, 'description': 'Total price including shipping.'}, 'totalReviews': {'type': 'integer', 'minimum': 0, 'description': 'Total number of reviews for the seller.'}}, 'required': ['condition', 'deliveryDate', 'fulfillmentType', 'inventory', 'positivePercentage', 'priceWithoutShipping', 'sellerId', 'sellerName', 'shippingPrice', 'totalPrice', 'totalReviews'], 'additionalProperties': False, 'description': 'Details of an offer for the product.'}, 'description': 'List of offers for the product.'}, 'productLink': {'type': 'string', 'format': 'uri', 'description': 'URL to the product page on Amazon.'}, 'productMainImage': {'type': 'string', 'format': 'uri', 'description': 'URL to the main product image.'}, 'productTitle': {'type': 'string', 'minLength': 1, 'description': 'Title of the product.'}}, 'required': ['asin', 'buyBox', 'currency', 'marketplaceId', 'offers', 'productLink', 'productMainImage', 'productTitle'], 'additionalProperties': False}, 'success': {'type': 'boolean', 'description': 'Indicates whether the API request was successful.'}}, 'required': ['data', 'success'], 'additionalProperties': False}Response Example
200 OK
application/json
{
"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 Example
get_amazon_product_offers.py
Python
Ruby
Javascript
Java
Go
import requests
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/api/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/api/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/api/amazon-product-offers?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-product-offers?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
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")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-product-offers?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
GET
/amazon-get-marketplaces
Get Amazon Marketplaces
Retrieve a list of supported Amazon marketplaces.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key |
text | Required | Your API key |
Response Example
200 OK
application/json
{
"marketplaces": [
{
"country": "Germany",
"id": "A1PA6795UKMFR9",
"name": "Amazon.de"
}
]
}Code Example
get_amazon_marketplaces.py
Python
Ruby
Javascript
Java
Go
import requests
params = {
"api_key": "YOUR_API_KEY",
"api_key": "api_key",
}
response = requests.get("https://sellermagnet-api.com/api/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/api/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/api/amazon-get-marketplaces?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-get-marketplaces?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
func main() {
params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("api_key", "api_key")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-get-marketplaces?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
GET
/amazon-search
Search Amazon
Search Amazon products by keyword.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q |
text | Required | Search query (e.g., "phone") |
marketplaceId |
text | Required | Marketplace ID (e.g., "A1PA6795UKMFR9") |
count |
number | Optional | Number of results (max 50, default 30) |
geo_location |
text | Optional | Detailed Geo Location ZIP CODE |
api_key |
text | Required | Your API key |
JSON Schema
{'$schema': 'http://json-schema.org/draft-07/schema#', 'type': 'object', 'properties': {'data': {'type': 'object', 'properties': {'searchResults': {'type': 'array', 'items': {'type': 'object', 'properties': {'asin': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.'}, 'discount_info': {'type': 'string', 'description': "Information about stock availability or discounts (e.g., 'Nur noch 1 auf Lager')."}, 'link': {'type': 'string', 'format': 'uri', 'description': 'URL to the product page on Amazon.'}, 'listingPrice': {'type': 'object', 'properties': {'original_price': {'type': 'object', 'properties': {'currency_code': {'type': 'string', 'description': 'Currency code (e.g., EUR).'}, 'currency_name': {'type': 'string', 'minLength': 1, 'description': 'Full name of the currency.'}, 'currency_symbol': {'type': 'string', 'minLength': 1, 'description': 'Symbol of the currency.'}, 'total': {'type': 'string', 'pattern': '^[0-9]+(\\.[0-9]{1,2})?$', 'description': 'Total price as a string, with up to two decimal places.'}}, 'required': ['currency_code', 'currency_name', 'currency_symbol', 'total'], 'additionalProperties': False, 'description': 'Original price details for the listing, if available.'}, 'price': {'type': 'object', 'properties': {'currency_code': {'type': 'string', 'description': 'Currency code (e.g., EUR).'}, 'currency_name': {'type': 'string', 'minLength': 1, 'description': 'Full name of the currency.'}, 'currency_symbol': {'type': 'string', 'minLength': 1, 'description': 'Symbol of the currency.'}, 'total': {'type': 'string', 'pattern': '^[0-9]+(\\.[0-9]{1,2})?$', 'description': 'Total price as a string, with up to two decimal places.'}}, 'required': ['currency_code', 'currency_name', 'currency_symbol', 'total'], 'additionalProperties': False, 'description': 'Price details for the listing.'}}, 'required': ['price'], 'additionalProperties': False, 'description': 'Listing price information.'}, 'mainImage': {'type': 'string', 'format': 'uri', 'description': 'URL to the main product image.'}, 'on_sale': {'type': 'boolean', 'description': 'Indicates if the product is on sale.'}, 'position': {'type': 'integer', 'minimum': 1, 'description': 'Position of the product in the search results.'}, 'productTitle': {'type': 'string', 'minLength': 1, 'description': 'Title of the product.'}, 'reviewAmount': {'type': 'integer', 'minimum': 0, 'description': 'Total number of customer reviews.'}, 'reviewRating': {'type': ['number', 'null'], 'minimum': 0, 'maximum': 5, 'description': 'Average review rating, with one decimal place, or null if not available.'}, 'sponsored': {'type': 'boolean', 'description': 'Indicates if the product is a sponsored listing.'}}, 'required': ['asin', 'discount_info', 'link', 'listingPrice', 'mainImage', 'on_sale', 'position', 'productTitle', 'reviewAmount', 'reviewRating', 'sponsored'], 'additionalProperties': False, 'description': 'A single search result entry.'}, 'description': 'List of search results for products.'}}, 'required': ['searchResults'], 'additionalProperties': False, 'description': 'Search results data.'}, 'success': {'type': 'boolean', 'description': 'Indicates whether the API request was successful.'}}, 'required': ['data', 'success'], 'additionalProperties': False}Response Example
200 OK
application/json
{
"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 Example
search_amazon.py
Python
Ruby
Javascript
Java
Go
import requests
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/api/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/api/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/api/amazon-search?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-search?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
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")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-search?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
GET
/amazon-bestsellers
Get Amazon Bestsellers
Fetch top-selling products in a specific category.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
category_id |
text | Required | Category ID (e.g., 'electronics') |
marketplaceId |
text | Required | Marketplace ID (e.g., 'A1PA6795UKMFR9') |
count |
number | Optional | Number of results (max 50, default 30) |
api_key |
text | Required | Your API key |
JSON Schema
{'$schema': 'http://json-schema.org/draft-07/schema#', 'type': 'object', 'properties': {'data': {'type': 'object', 'properties': {'bestsellers': {'type': 'array', 'items': {'type': 'object', 'properties': {'asin': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'Amazon Standard Identification Number (ASIN).'}, 'mainImage': {'type': 'string', 'format': 'uri', 'description': 'URL to the main product image.'}, 'price': {'type': 'object', 'properties': {'currency_code': {'type': 'string', 'description': 'Currency code (e.g., EUR).'}, 'currency_name': {'type': 'string', 'minLength': 1, 'description': 'Full name of the currency.'}, 'currency_symbol': {'type': 'string', 'minLength': 1, 'description': 'Symbol of the currency.'}, 'price': {'type': 'number', 'minimum': 0, 'description': 'Price of the product.'}}, 'required': ['currency_code', 'currency_name', 'currency_symbol', 'price'], 'additionalProperties': False, 'description': 'Price details for the product.'}, 'productImages': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'description': 'URL to a product image.'}, 'description': 'List of product image URLs.'}, 'productLink': {'type': 'string', 'format': 'uri', 'description': 'URL to the product page on Amazon.'}, 'productTitle': {'type': 'string', 'minLength': 1, 'description': 'Title of the product.'}, 'rank': {'type': 'integer', 'minimum': 1, 'description': 'Bestseller rank in the category.'}, 'reviewAmount': {'type': 'integer', 'minimum': 0, 'description': 'Total number of customer reviews.'}, 'reviewRating': {'type': 'number', 'minimum': 0, 'maximum': 5, 'description': 'Average review rating.'}}, 'required': ['asin', 'mainImage', 'productImages', 'productLink', 'productTitle', 'rank', 'reviewAmount', 'reviewRating'], 'additionalProperties': False, 'description': 'A single bestseller product entry.'}, 'description': 'List of bestseller products.'}, 'categoryId': {'type': 'string', 'description': 'Category ID for the bestsellers.'}, 'link': {'type': 'string', 'format': 'uri', 'description': 'URL to the bestseller category page on Amazon.'}}, 'required': ['bestsellers', 'categoryId', 'link'], 'additionalProperties': False, 'description': 'Bestseller data for the specified category.'}, 'success': {'type': 'boolean', 'description': 'Indicates whether the API request was successful.'}}, 'required': ['data', 'success'], 'additionalProperties': False}Response Example
200 OK
application/json
{
"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 Example
get_amazon_bestsellers.py
Python
Ruby
Javascript
Java
Go
import requests
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/api/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/api/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/api/amazon-bestsellers?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-bestsellers?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
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")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-bestsellers?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
GET
/amazon-deals
Get Amazon Deals
List categories with active Amazon deals.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
marketplaceId |
text | Required | Marketplace ID (e.g., 'A1PA6795UKMFR9') |
api_key |
text | Required | Your API key |
category_id |
text | Optional | Category ID (e.g., 'electronics') |
geo_location |
text | Optional | Detailed Geo Location ZIP CODE |
JSON Schema
{'$schema': 'http://json-schema.org/draft-07/schema#', 'type': 'object', 'properties': {'data': {'type': 'object', 'properties': {'deals': {'type': 'array', 'items': {'type': 'object', 'properties': {'asin': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'Amazon Standard Identification Number (ASIN).'}, 'basisPrice': {'type': 'string', 'pattern': '^[0-9]+(\\.[0-9]{1,2})?$', 'description': 'Original price of the product as a string.'}, 'coupon_savings': {'type': ['string', 'null'], 'pattern': '^[0-9]+(\\.[0-9]{1,2})?$', 'description': 'Coupon savings amount as a string, or null if not applicable.'}, 'dealEndTime': {'type': 'string', 'format': 'date-time', 'description': "End time of the deal in ISO 8601 format, or 'N/A' if not applicable."}, 'dealId': {'type': 'string', 'description': "Unique identifier for the deal, or 'N/A' if not applicable."}, 'dealLink': {'type': 'string', 'format': 'uri', 'description': 'URL to the deal page on Amazon.'}, 'dealPrice': {'type': 'object', 'properties': {'priceCurrency': {'type': 'string', 'description': 'Currency code (e.g., EUR).'}, 'priceTotal': {'type': 'number', 'minimum': 0, 'description': 'Total deal price.'}}, 'required': ['priceCurrency', 'priceTotal'], 'additionalProperties': False, 'description': 'Price details for the deal.'}, 'dealStartTime': {'type': 'string', 'format': 'date-time', 'description': "Start time of the deal in ISO 8601 format, or 'N/A' if not applicable."}, 'image_url': {'type': 'string', 'format': 'uri', 'description': 'URL to the main product image.'}, 'productTitle': {'type': 'string', 'minLength': 1, 'description': 'Title of the product.'}, 'savings_percentage': {'type': 'integer', 'minimum': 0, 'maximum': 100, 'description': 'Percentage of savings for the deal.'}}, 'required': ['asin', 'basisPrice', 'coupon_savings', 'dealEndTime', 'dealId', 'dealLink', 'dealPrice', 'dealStartTime', 'image_url', 'productTitle', 'savings_percentage'], 'additionalProperties': False, 'description': 'A single deal entry.'}, 'description': 'List of active deals.'}}, 'required': ['deals'], 'additionalProperties': False, 'description': 'Active deals data.'}, 'success': {'type': 'boolean', 'description': 'Indicates whether the API request was successful.'}}, 'required': ['data', 'success'], 'additionalProperties': False}Response Example
200 OK
application/json
{
"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 Example
get_amazon_deals.py
Python
Ruby
Javascript
Java
Go
import requests
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/api/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/api/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/api/amazon-deals?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-deals?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
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")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-deals?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
GET
/amazon-product-search-estimated-sells
Amazon Product Search Estimated Sells
Retrieve estimated sales data for an Amazon product by ASIN.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
asin |
text | Required | Product ASIN (e.g., "B08N5WRWNW") |
marketplaceId |
text | Required | Marketplace ID (e.g., "A1PA6795UKMFR9") |
api_key |
text | Required | Your API key |
JSON Schema
{'$schema': 'http://json-schema.org/draft-07/schema#', 'type': 'object', 'properties': {'data': {'type': 'object', 'properties': {'asin': {'type': 'string', 'pattern': '^[A-Z0-9]{10}$', 'description': 'Amazon Standard Identification Number (ASIN).'}, 'estimated_monthly_sales': {'type': 'integer', 'minimum': 0, 'description': 'Estimated number of units sold per month.'}, 'sales_rank': {'type': 'integer', 'minimum': 1, 'description': 'Current sales rank in the category.'}, 'category': {'type': 'string', 'description': 'Product category.'}, 'marketplace_domain': {'type': 'string', 'description': "Domain of the marketplace (e.g., 'amazon.com')."}}, 'required': ['asin', 'estimated_monthly_sales', 'sales_rank', 'category', 'marketplace_domain'], 'additionalProperties': False}, 'success': {'type': 'boolean', 'description': 'Indicates whether the API request was successful.'}}, 'required': ['data', 'success'], 'additionalProperties': False}Response Example
200 OK
application/json
{
"data": {
"asin": "B08N5WRWNW",
"estimated_monthly_sales": 121
},
"success": true
}Code Example
amazon_product_search_estimated_sells.py
Python
Ruby
Javascript
Java
Go
import requests
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/api/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/api/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/api/amazon-product-search-estimated-sells?" + params)
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
import java.net.http.*;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.*;
import java.util.stream.Collectors;
public class Example {
public static void main(String[] args) throws Exception {
Map<String, String> 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/api/amazon-product-search-estimated-sells?" + query))
.GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
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")
resp, _ := http.Get("https://sellermagnet-api.com/api/amazon-product-search-estimated-sells?" + params.Encode())
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
Quick Start
Getting Started with SellerMagnet API
Follow these four steps to start extracting real-time Amazon data in minutes.
2
Authenticate
Include your API key as a query parameter (api_key=YOUR_API_KEY) in every request.
3
Test the API
Try the /amazon-product-lookup endpoint with a sample ASIN (e.g., B0CX23V2ZK).
4
Explore Endpoints
Browse the full documentation above and build powerful integrations for your business.
FAQ
Frequently Asked Questions
Common questions about the SellerMagnet API documentation and integration.
Include your API key in the x-api-key header with every request. You can generate and manage your API keys from the dashboard after registration.
All endpoints return JSON responses with consistent schemas. Error responses include descriptive error codes and messages to help you debug issues quickly.
Yes. Free plans allow 10 requests per second. Paid plans support up to 50 requests per second. Enterprise plans offer custom rate limits. See our pricing page for details.
Search endpoints accept a page parameter. Each response includes the total number of pages available. Iterate through pages by incrementing the page value until you've retrieved all results.
The API returns standard HTTP codes: 200 for success, 400 for invalid parameters, 401 for missing or invalid API key, 429 for rate-limit exceeded, and 5xx for server errors. Every non-200 response includes a JSON body with an error code and descriptive message to help you troubleshoot.
Start Building with SellerMagnet API
Get started in minutes with our free tier. Full access to every endpoint documented above.
500 free API credits • No credit card required • Cancel anytime