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.
150 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 | Set to true to add data.graphs: a PNG chart URL per series (same single credit) |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"data": {
"properties": {
"amazonPrice": {
"description": "Amazon\u0027s own offer in minor units, null when Amazon is not selling.",
"type": [
"integer",
"null"
]
},
"asin": {
"type": "string"
},
"bestSellerRank": {
"description": "Current root-category sales rank, or \u0027-\u0027 when the product is unranked.",
"type": [
"integer",
"string"
]
},
"buyBoxFulfillment": {
"enum": [
"FBA",
"FBM",
null
],
"type": [
"string",
"null"
]
},
"buyBoxPrice": {
"description": "Landed Buy Box price in minor units (41800 = 418.00), or \u0027N/A\u0027 when nobody holds the Buy Box.",
"type": [
"integer",
"string"
]
},
"buyBoxSellerIdHistory": {
"description": "[[timestamp, sellerId], ...]; sellerId \u0027-1\u0027 = nobody held the Buy Box.",
"type": [
"array",
"null"
]
},
"categoryTree": {
"description": "Path from the root category to the leaf.",
"items": {
"properties": {
"catId": {
"type": "integer"
},
"name": {
"type": "string"
}
},
"type": "object"
},
"type": [
"array",
"null"
]
},
"graphs": {
"description": "Only with graphs=true: one PNG URL per series that has data, keyed by the series name (e.g. buyBoxPriceHistory, salesRankHistory).",
"type": "object"
},
"listedSince": {
"description": "UTC timestamp, null when unknown.",
"type": [
"string",
"null"
]
},
"lowestFBAPrice": {
"type": [
"integer",
"number",
"null"
]
},
"lowestFBMPrice": {
"type": [
"integer",
"number",
"null"
]
},
"marketplaceId": {
"type": "string"
},
"marketplaceNewPriceHistory": {
"description": "Lowest new offer, item price: [[YYYY-MM-DD, minor units], ...].",
"items": {
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"offers": {
"description": "Keyed by seller ID: {isFBA, lastUpdated, priceHistory [[timestamp, price, shipping]], stockHistory [[timestamp, units]]}.",
"type": "object"
},
"offersSequence": {
"items": {
"type": "string"
},
"type": "array"
},
"privateLabel": {
"description": "Only one seller has ever held the Buy Box.",
"type": [
"boolean",
"null"
]
},
"productReviewAverage": {
"type": "number"
},
"productTitle": {
"type": "string"
},
"productTotalReviews": {
"type": "integer"
},
"rootCategory": {
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"shareBuyBox": {
"description": "Amazon itself did not hold the Buy Box in the last 30 days.",
"type": [
"boolean",
"null"
]
},
"stats": {
"properties": {
"amazonAsSellerPriceHistory": {
"description": "Item price of Amazon\u0027s own offer.",
"items": {
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"buyBoxPriceHistory": {
"description": "Landed price (item + shipping).",
"items": {
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"lowestFBAPriceHistory": {
"description": "Item price.",
"items": {
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"lowestFBMPriceHistory": {
"description": "Landed price (item + shipping).",
"items": {
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"monthlySoldHistory": {
"description": "Amazon\u0027s \u0027bought in past month\u0027: [[YYYY-MM, units], ...].",
"items": {
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"productRatingCountHistory": {
"description": "[[timestamp, review count], ...].",
"items": {
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"productRatingHistory": {
"description": "[[timestamp, rating], ...].",
"items": {
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"salesRank": {
"description": "One [[YYYY-MM-DD, rank], ...] series per category, keyed by category name.",
"type": "object"
},
"salesRankHistory": {
"description": "Main sales rank: [[YYYY-MM-DD HH:MM:SS, rank], ...]; -1 = unranked at that moment.",
"items": {
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
}
},
"type": "object"
},
"trackingSince": {
"description": "Date recording started (YYYY-MM-DD), or \u0027N/A\u0027.",
"type": "string"
}
},
"required": [
"asin",
"productTitle",
"marketplaceId",
"stats"
],
"type": "object"
},
"success": {
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
200 OK
application/json
{
"data": {
"amazonPrice": 44999,
"asin": "B0CLTBHXWQ",
"bestSellerRank": 15,
"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"
}
],
"listedSince": "2023-12-30 00: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
]
]
}
},
"offersSequence": [
"A11IL2PNWYJU7H"
],
"privateLabel": false,
"productReviewAverage": 4.7,
"productTitle": "Playstation 5 Console Edizione Digital Slim",
"productTotalReviews": 3129,
"rootCategory": {
"id": 412603031,
"name": "Videogiochi"
},
"shareBuyBox": true,
"stats": {
"amazonAsSellerPriceHistory": [
[
"2025-06-14",
44999
]
],
"buyBoxPriceHistory": [
[
"2025-06-13",
41700
],
[
"2025-06-14",
41800
]
],
"lowestFBAPriceHistory": [
[
"2025-06-14",
44999
]
],
"lowestFBMPriceHistory": [
[
"2025-06-14",
41700
]
],
"monthlySoldHistory": [
[
"2025-05",
1000
],
[
"2025-06",
1000
]
],
"productRatingCountHistory": [
[
"2025-06-14 15:28:00",
3129
]
],
"productRatingHistory": [
[
"2025-02-02 01:30:00",
4.7
]
],
"salesRank": {
"Videogiochi": [
[
"2025-06-13",
18
],
[
"2025-06-14",
15
]
]
},
"salesRankHistory": [
[
"2025-06-13 01:58:00",
18
],
[
"2025-06-14 01:58:00",
15
]
]
},
"trackingSince": "2023-12-18"
},
"success": true
}Code Example
amazon_product_statistics.py
Python
Ruby
Javascript
Java
Go
import requests
params = {
"api_key": "YOUR_API_KEY",
"asin": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
"graphs": "true",
}
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" => "B08N5WRWNW",
"marketplaceId" => "A1PA6795UKMFR9",
"graphs" => "true",
}
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": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
"graphs": "true",
});
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", "B08N5WRWNW");
params.put("marketplaceId", "A1PA6795UKMFR9");
params.put("api_key", "VALUE");
params.put("graphs", "true");
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", "B08N5WRWNW")
params.Add("marketplaceId", "A1PA6795UKMFR9")
params.Add("api_key", "VALUE")
params.Add("graphs", "true")
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#",
"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
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": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
"conversion_direction": "asin-to-ean",
}
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" => "B08N5WRWNW",
"marketplaceId" => "A1PA6795UKMFR9",
"conversion_direction" => "asin-to-ean",
}
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": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
"conversion_direction": "asin-to-ean",
});
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", "B08N5WRWNW");
params.put("marketplaceId", "A1PA6795UKMFR9");
params.put("conversion_direction", "asin-to-ean");
params.put("api_key", "VALUE");
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", "B08N5WRWNW")
params.Add("marketplaceId", "A1PA6795UKMFR9")
params.Add("conversion_direction", "asin-to-ean")
params.Add("api_key", "VALUE")
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#",
"properties": {
"data": {
"properties": {
"feedback": {
"properties": {
"negativeRating": {
"description": "Number of 1-star ratings per period.",
"properties": {
"30d": {
"type": "integer"
},
"365d": {
"type": "integer"
},
"90d": {
"type": "integer"
},
"lifetime": {
"type": "integer"
}
},
"required": [
"30d",
"90d",
"365d",
"lifetime"
],
"type": "object"
},
"neutralRating": {
"description": "Number of 2- and 3-star ratings per period.",
"properties": {
"30d": {
"type": "integer"
},
"365d": {
"type": "integer"
},
"90d": {
"type": "integer"
},
"lifetime": {
"type": "integer"
}
},
"required": [
"30d",
"90d",
"365d",
"lifetime"
],
"type": "object"
},
"positiveRating": {
"description": "Number of 4- and 5-star ratings per period.",
"properties": {
"30d": {
"type": "integer"
},
"365d": {
"type": "integer"
},
"90d": {
"type": "integer"
},
"lifetime": {
"type": "integer"
}
},
"required": [
"30d",
"90d",
"365d",
"lifetime"
],
"type": "object"
},
"recentFeedback": {
"description": "Up to five most recent feedback entries.",
"items": {
"properties": {
"dateRated": {
"description": "Rater and date line as shown on the page.",
"type": "string"
},
"rating": {
"description": "Stars 1-5, or \u0027N/A\u0027.",
"type": [
"integer",
"string"
]
},
"starRatingText": {
"description": "Rating text as shown, e.g. \u00275 out of 5 stars\u0027.",
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"text",
"rating",
"starRatingText",
"dateRated"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"reviewsCount": {
"description": "Number of ratings per period.",
"properties": {
"30d": {
"type": "integer"
},
"365d": {
"type": "integer"
},
"90d": {
"type": "integer"
},
"lifetime": {
"type": "integer"
}
},
"required": [
"30d",
"90d",
"365d",
"lifetime"
],
"type": "object"
},
"starRating": {
"description": "Star rating per period as text; \u0027N/A\u0027 when the page shows none.",
"properties": {
"30d": {
"type": "string"
},
"365d": {
"type": "string"
},
"90d": {
"type": "string"
},
"lifetime": {
"type": "string"
}
},
"required": [
"30d",
"90d",
"365d",
"lifetime"
],
"type": "object"
}
},
"required": [
"recentFeedback",
"positiveRating",
"neutralRating",
"negativeRating",
"reviewsCount",
"starRating"
],
"type": "object"
},
"marketplaceId": {
"description": "Marketplace the feedback was read from.",
"type": "string"
},
"marketplace_name": {
"description": "Marketplace name, e.g. \u0027Amazon US\u0027.",
"type": "string"
},
"sellerAvgRating": {
"description": "Approximate 365-day average: negative counted as 1, neutral as 3, positive as 5 stars (2 decimals); 0.0 without feedback.",
"type": "number"
},
"sellerFullName": {
"description": "Seller name as shown on the storefront.",
"type": "string"
},
"sellerId": {
"description": "The seller ID that was requested.",
"type": "string"
},
"sellerTotalReviewAmount": {
"description": "Lifetime number of feedback ratings.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"sellerId",
"marketplaceId",
"sellerFullName",
"sellerTotalReviewAmount",
"sellerAvgRating",
"feedback"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
200 OK
application/json
{
"data": {
"feedback": {
"negativeRating": {
"30d": 2,
"365d": 15,
"90d": 7,
"lifetime": 100
},
"neutralRating": {
"30d": 1,
"365d": 9,
"90d": 3,
"lifetime": 55
},
"positiveRating": {
"30d": 4,
"365d": 90,
"90d": 20,
"lifetime": 1380
},
"recentFeedback": [
{
"dateRated": "By gary kraus on June 5, 2025.",
"rating": 5,
"starRatingText": "5 out of 5 stars",
"text": "great"
},
{
"dateRated": "By Amazon Customer on June 5, 2025.",
"rating": 5,
"starRatingText": "5 out of 5 stars",
"text": "Ok"
}
],
"reviewsCount": {
"30d": 7,
"365d": 114,
"90d": 30,
"lifetime": 1535
},
"starRating": {
"30d": "3.3",
"365d": "3.9",
"90d": "3.6",
"lifetime": "4.5"
}
},
"marketplaceId": "ATVPDKIKX0DER",
"marketplace_name": "Amazon US",
"sellerAvgRating": 4.32,
"sellerFullName": "Example Store",
"sellerId": "A1CWSGXIR635I6",
"sellerTotalReviewAmount": 1535
},
"success": true
}Code Example
get_amazon_seller_review.py
Python
Ruby
Javascript
Java
Go
import requests
params = {
"api_key": "YOUR_API_KEY",
"sellerId": "A1B2C3D4E5F6G7",
"marketplaceId": "A1PA6795UKMFR9",
}
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" => "A1B2C3D4E5F6G7",
"marketplaceId" => "A1PA6795UKMFR9",
}
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": "A1B2C3D4E5F6G7",
"marketplaceId": "A1PA6795UKMFR9",
});
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", "A1B2C3D4E5F6G7");
params.put("marketplaceId", "A1PA6795UKMFR9");
params.put("api_key", "VALUE");
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", "A1B2C3D4E5F6G7")
params.Add("marketplaceId", "A1PA6795UKMFR9")
params.Add("api_key", "VALUE")
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#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"productInfo": {
"additionalProperties": false,
"description": "Detailed product information.",
"properties": {
"additionalDetails": {
"additionalProperties": true,
"description": "Detailed product information.",
"properties": {
"ASIN": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"Batteries": {
"description": "Battery requirements.",
"type": "string"
},
"Best Sellers Rank": {
"description": "Bestseller rank information.",
"type": "string"
},
"Customer Rating": {
"description": "Customer review summary.",
"type": "string"
},
"Date First Available": {
"description": "Date the product was first available.",
"type": "string"
},
"Item Weight": {
"description": "Weight of the item.",
"type": "string"
},
"Item model number": {
"description": "Model number of the item.",
"type": "string"
},
"Manufacturer": {
"description": "Manufacturer of the product.",
"type": "string"
},
"Number of Reviews": {
"description": "Total number of reviews with \u0027ratings\u0027 suffix.",
"type": "string"
},
"Product Dimensions": {
"description": "Dimensions of the product.",
"type": "string"
},
"Release date": {
"description": "Release date of the product.",
"type": "string"
},
"Type of item": {
"description": "Type of the item.",
"type": "string"
}
},
"required": [
"ASIN"
],
"type": "object"
},
"asin": {
"description": "Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"bestsellerRanks": {
"additionalProperties": false,
"description": "Bestseller rank information.",
"properties": {
"main_category": {
"additionalProperties": false,
"properties": {
"name": {
"description": "Name of the main category.",
"minLength": 1,
"type": "string"
},
"rank": {
"description": "Bestseller rank in the main category.",
"minimum": 1,
"type": "integer"
}
},
"required": [
"name",
"rank"
],
"type": "object"
},
"subcategory": {
"additionalProperties": false,
"properties": {
"name": {
"description": "Name of the subcategory (may be empty).",
"type": "string"
},
"rank": {
"description": "Bestseller rank in the subcategory (0 if not applicable).",
"minimum": 0,
"type": "integer"
}
},
"required": [
"name",
"rank"
],
"type": "object"
}
},
"required": [
"main_category",
"subcategory"
],
"type": "object"
},
"bulletPoints": {
"description": "List of product bullet points.",
"items": {
"description": "A product feature or specification.",
"minLength": 1,
"type": "string"
},
"type": "array"
},
"buyBoxInfo": {
"additionalProperties": false,
"description": "Buy box information.",
"properties": {
"amazonSellerId": {
"description": "Amazon\u0027s own seller ID for this marketplace when sellerId is \u0027Amazon\u0027 (e.g. ATVPDKIKX0DER on amazon.com); null for third-party sellers and in marketplaces without a first-party Amazon seller.",
"type": [
"string",
"null"
]
},
"currencyCode": {
"description": "Currency code (e.g., USD).",
"type": "string"
},
"currencyName": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"currencySymbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
},
"price": {
"description": "Buy box price.",
"minimum": 0,
"type": "number"
},
"sellerId": {
"description": "Unique identifier of the buy box seller.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
}
},
"required": [
"currencyCode",
"currencyName",
"currencySymbol",
"price",
"sellerId"
],
"type": "object"
},
"categories": {
"additionalProperties": false,
"description": "Bestseller category information.",
"properties": {
"bestsellerCategory": {
"description": "List of bestseller categories.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Category identifier.",
"type": "string"
},
"index": {
"description": "Index of the category in the hierarchy.",
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name of the category.",
"minLength": 1,
"type": "string"
},
"url": {
"description": "URL to the category page on Amazon.",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"index",
"name",
"url"
],
"type": "object"
},
"type": "array"
},
"rootCategory": {
"additionalProperties": false,
"description": "Root category details.",
"properties": {
"id": {
"description": "Root category identifier.",
"type": "string"
},
"name": {
"description": "Name of the root category.",
"minLength": 1,
"type": "string"
},
"url": {
"description": "URL to the root category page on Amazon.",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"name",
"url"
],
"type": "object"
}
},
"required": [
"bestsellerCategory",
"rootCategory"
],
"type": "object"
},
"description": {
"description": "Product description (may be empty).",
"items": {
"description": "A description segment.",
"type": "string"
},
"type": "array"
},
"details": {
"additionalProperties": true,
"description": "Additional product details.",
"properties": {
"ASIN": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"Batteries": {
"description": "Battery requirements.",
"type": "string"
},
"Date First Available": {
"description": "Date the product was first available.",
"type": "string"
},
"Item Weight": {
"description": "Weight of the item.",
"type": "string"
},
"Item model number": {
"description": "Model number of the item.",
"type": "string"
},
"Manufacturer": {
"description": "Manufacturer of the product.",
"type": "string"
},
"Platform": {
"description": "Platform of the product.",
"type": "string"
},
"Product Dimensions": {
"description": "Dimensions of the product.",
"type": "string"
},
"Release date": {
"description": "Release date of the product.",
"type": "string"
},
"Type of item": {
"description": "Type of the item.",
"type": "string"
}
},
"required": [
"ASIN"
],
"type": "object"
},
"hasAPlusContent": {
"description": "Indicates if the product has A+ Content.",
"type": "boolean"
},
"images": {
"description": "List of product image URLs.",
"items": {
"description": "URL to a product image.",
"format": "uri",
"type": "string"
},
"type": "array"
},
"link": {
"description": "URL to the product page on Amazon.",
"format": "uri",
"type": "string"
},
"listedSinceDate": {
"description": "Date when the product was first listed, in YYYY-MM-DD format, or null if unavailable.",
"format": "date",
"type": [
"string",
"null"
]
},
"mainImage": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"marketplaceId": {
"description": "Unique identifier for the marketplace.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
},
"reviews": {
"additionalProperties": false,
"description": "Product review summary.",
"properties": {
"averageRating": {
"description": "Average star rating.",
"maximum": 5,
"minimum": 0,
"type": "number"
},
"reviewSummary": {
"description": "Title of the review summary.",
"type": "string"
},
"totalReviews": {
"description": "Total number of reviews.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"averageRating",
"reviewSummary",
"totalReviews"
],
"type": "object"
},
"title": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
},
"variations": {
"description": "List of product variations.",
"items": {
"additionalProperties": false,
"description": "A product variation.",
"properties": {
"asin": {
"description": "ASIN of the variation.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"attributes": {
"additionalProperties": true,
"description": "Attributes of the variation (e.g., Pattern Name, Style).",
"type": "object"
}
},
"required": [
"asin",
"attributes"
],
"type": "object"
},
"type": "array"
},
"videos": {
"description": "List of product video URLs.",
"items": {
"description": "URL to a product video.",
"format": "uri",
"type": "string"
},
"type": "array"
}
},
"required": [
"additionalDetails",
"asin",
"bestsellerRanks",
"bulletPoints",
"buyBoxInfo",
"categories",
"description",
"details",
"hasAPlusContent",
"images",
"link",
"listedSinceDate",
"mainImage",
"marketplaceId",
"reviews",
"title",
"variations",
"videos"
],
"type": "object"
}
},
"required": [
"productInfo"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
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": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
}
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" => "B08N5WRWNW",
"marketplaceId" => "A1PA6795UKMFR9",
}
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": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
});
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", "B08N5WRWNW");
params.put("marketplaceId", "A1PA6795UKMFR9");
params.put("api_key", "VALUE");
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", "B08N5WRWNW")
params.Add("marketplaceId", "A1PA6795UKMFR9")
params.Add("api_key", "VALUE")
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#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"buyBox": {
"additionalProperties": false,
"description": "The featured (Buy Box) offer. An EMPTY object when no offer holds the Buy Box - see buyBoxSuppressed.",
"properties": {
"amazonSellerId": {
"description": "Amazon\u0027s own seller ID for this marketplace when sellerId is \u0027Amazon\u0027 (e.g. ATVPDKIKX0DER on amazon.com); null for third-party sellers and in marketplaces without a first-party Amazon seller.",
"type": [
"string",
"null"
]
},
"condition": {
"description": "Condition of the buy box product.",
"enum": [
"New",
"Used - Like New",
"Used - Very Good",
"Used - Good",
"Used - Acceptable"
],
"type": "string"
},
"deliveryDate": {
"description": "Expected delivery date in YYYY-MM-DD format.",
"format": "date",
"type": "string"
},
"fulfillmentType": {
"description": "Fulfillment method (FBA or FBM).",
"enum": [
"FBA",
"FBM"
],
"type": "string"
},
"inventory": {
"description": "Number of items available in seller\u0027s inventory.",
"minimum": 0,
"type": "integer"
},
"positivePercentage": {
"description": "Percentage of positive reviews for the seller.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"priceWithoutShipping": {
"description": "Price excluding shipping.",
"minimum": 0,
"type": "number"
},
"sellerId": {
"description": "Seller ID of the Buy Box holder. \u0027Amazon\u0027 when Amazon itself holds the Buy Box; amazonSellerId then carries Amazon\u0027s own seller ID for that marketplace.",
"pattern": "^[A-Z0-9]+$|^Amazon$",
"type": "string"
},
"sellerName": {
"description": "Name of the buy box seller.",
"minLength": 1,
"type": "string"
},
"shippingPrice": {
"description": "Shipping cost for the buy box offer.",
"minimum": 0,
"type": "number"
},
"totalPrice": {
"description": "Total price including shipping.",
"minimum": 0,
"type": "number"
},
"totalReviews": {
"description": "Total number of reviews for the seller.",
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"buyBoxSuppressed": {
"description": "True when offers exist but Amazon shows no featured offer; buyBox is then an empty object.",
"type": "boolean"
},
"currency": {
"additionalProperties": false,
"description": "Currency details.",
"properties": {
"code": {
"description": "Currency code (e.g., USD).",
"type": "string"
},
"name": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"symbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
}
},
"required": [
"code",
"name",
"symbol"
],
"type": "object"
},
"marketplaceId": {
"description": "Unique identifier for the marketplace.",
"pattern": "^[A-Z0-9]+$",
"type": "string"
},
"offers": {
"description": "List of offers for the product.",
"items": {
"additionalProperties": false,
"description": "Details of an offer for the product.",
"properties": {
"amazonSellerId": {
"description": "Amazon\u0027s own seller ID for this marketplace when sellerId is \u0027Amazon\u0027 (e.g. ATVPDKIKX0DER on amazon.com); null for third-party sellers and in marketplaces without a first-party Amazon seller.",
"type": [
"string",
"null"
]
},
"condition": {
"description": "Condition of the product.",
"enum": [
"New",
"Used - Like New",
"Used - Very Good",
"Used - Good",
"Used - Acceptable"
],
"type": "string"
},
"deliveryDate": {
"description": "Expected delivery date in YYYY-MM-DD format.",
"format": "date",
"type": "string"
},
"fulfillmentType": {
"description": "Fulfillment method (FBA or FBM).",
"enum": [
"FBA",
"FBM"
],
"type": "string"
},
"inventory": {
"description": "Number of items available in seller\u0027s inventory.",
"minimum": 0,
"type": "integer"
},
"positivePercentage": {
"description": "Percentage of positive reviews for the seller.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"priceWithoutShipping": {
"description": "Price excluding shipping.",
"minimum": 0,
"type": "number"
},
"sellerId": {
"description": "Seller ID. \u0027Amazon\u0027 for Amazon\u0027s own offer; amazonSellerId then carries Amazon\u0027s seller ID for that marketplace.",
"pattern": "^[A-Z0-9]+$|^Amazon$",
"type": "string"
},
"sellerName": {
"description": "Name of the seller.",
"minLength": 1,
"type": "string"
},
"shippingPrice": {
"description": "Shipping cost for the offer.",
"minimum": 0,
"type": "number"
},
"totalPrice": {
"description": "Total price including shipping.",
"minimum": 0,
"type": "number"
},
"totalReviews": {
"description": "Total number of reviews for the seller.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"condition",
"deliveryDate",
"fulfillmentType",
"inventory",
"positivePercentage",
"priceWithoutShipping",
"sellerId",
"sellerName",
"shippingPrice",
"totalPrice",
"totalReviews"
],
"type": "object"
},
"type": "array"
},
"product": {
"additionalProperties": false,
"description": "Listing content read from the product page the offers call already fetches (added 2026-10-07): lets a daily poll detect title, brand, bullet, image and item-detail changes without a second request. Null when that page could not be parsed; the offer fields are unaffected.",
"properties": {
"attributes": {
"additionalProperties": {
"maxLength": 300,
"type": "string"
},
"description": "Item-details rows (product overview, technical details, detail bullets) as snake_case keys in the page\u0027s language (e.g. unit_count, item_weight, grosse). The brand row is reported as `brand` only; the ASIN, rating, rank, first-available and any price rows are left out.",
"maxProperties": 40,
"type": "object"
},
"brand": {
"description": "Brand name from the item details, else parsed from the byline.",
"maxLength": 200,
"type": [
"string",
"null"
]
},
"bullets": {
"description": "Feature bullets in page order.",
"items": {
"maxLength": 500,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"byline": {
"description": "Byline under the title, e.g. \u0027Visit the Triplast Store\u0027 or \u0027Brand: Triplast\u0027.",
"maxLength": 200,
"type": [
"string",
"null"
]
},
"description": {
"description": "Text of the product-description module only; A+ content is not included because its modules are lazy-loaded and would change between polls.",
"maxLength": 2000,
"type": [
"string",
"null"
]
},
"images": {
"description": "Gallery image IDs (the ID in https://m.media-amazon.com/images/I/\u003cID\u003e.\u003csize\u003e.jpg), main image first, de-duplicated.",
"items": {
"type": "string"
},
"maxItems": 12,
"type": "array"
},
"source_url": {
"description": "The product page URL the block was read from.",
"format": "uri",
"type": "string"
},
"title": {
"description": "Product title.",
"maxLength": 500,
"type": [
"string",
"null"
]
},
"variation_theme": {
"description": "Variation dimensions of the listing, e.g. \u0027size_name/color_name\u0027; null without variations.",
"type": [
"string",
"null"
]
}
},
"required": [
"title",
"byline",
"brand",
"bullets",
"description",
"images",
"attributes",
"variation_theme",
"source_url"
],
"type": [
"object",
"null"
]
},
"productLink": {
"description": "URL to the product page on Amazon.",
"format": "uri",
"type": "string"
},
"productMainImage": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"productTitle": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
}
},
"required": [
"asin",
"buyBox",
"buyBoxSuppressed",
"currency",
"marketplaceId",
"offers",
"product",
"productLink",
"productMainImage",
"productTitle"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
200 OK
application/json
{
"data": {
"asin": "B0CL61F39H",
"buyBox": {
"amazonSellerId": "ATVPDKIKX0DER",
"condition": "New",
"deliveryDate": "2025-06-28",
"fulfillmentType": "FBA",
"inventory": 30,
"positivePercentage": 0,
"priceWithoutShipping": 499,
"sellerId": "Amazon",
"sellerName": "Amazon",
"shippingPrice": 0,
"totalPrice": 499,
"totalReviews": 0
},
"buyBoxSuppressed": false,
"currency": {
"code": "USD",
"name": "United States Dollar",
"symbol": "$"
},
"marketplaceId": "ATVPDKIKX0DER",
"offers": [
{
"amazonSellerId": "ATVPDKIKX0DER",
"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
},
{
"amazonSellerId": "ATVPDKIKX0DER",
"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
}
],
"product": {
"attributes": {
"color": "White",
"hardware_platform": "PlayStation 5",
"item_weight": "7.1 pounds",
"product_dimensions": "14 x 3.8 x 8.5 inches"
},
"brand": "PlayStation",
"bullets": [
"Slim Design - With a new slimmer design, this PS5 console gives you more freedom in placement.",
"1TB of Storage - Keep your favorite games ready and waiting for you to jump in and play.",
"Ultra-High Speed SSD - Maximize your play sessions with near instant load times."
],
"byline": "Visit the PlayStation Store",
"description": "The PS5 console unleashes new gaming possibilities that you never anticipated. Experience lightning-fast loading with an ultra-high speed SSD and deeper immersion with haptic feedback and adaptive triggers.",
"images": [
"31kTNmpm6vL",
"41Wk7R6fmTL",
"51Bk-8oOyfL",
"61C4dNUl9mL"
],
"source_url": "https://www.amazon.com/dp/B0CL61F39H",
"title": "PlayStation\u00ae5 console (slim)",
"variation_theme": "pattern_name/style_name"
},
"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": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
"geo_location": "10115",
}
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" => "B08N5WRWNW",
"marketplaceId" => "A1PA6795UKMFR9",
"geo_location" => "10115",
}
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": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
"geo_location": "10115",
});
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", "B08N5WRWNW");
params.put("marketplaceId", "A1PA6795UKMFR9");
params.put("geo_location", "10115");
params.put("api_key", "VALUE");
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", "B08N5WRWNW")
params.Add("marketplaceId", "A1PA6795UKMFR9")
params.Add("geo_location", "10115")
params.Add("api_key", "VALUE")
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 every supported Amazon marketplace, keyed by marketplace ID, with its domain, name, currency and default geo_location postcode.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key |
text | Required | Your API key |
Response Example
200 OK
application/json
{
"data": {
"A1PA6795UKMFR9": {
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "\u20ac",
"geo_location": "10115",
"marketplace_domain": "amazon.de",
"marketplace_name": "Amazon DE"
},
"ATVPDKIKX0DER": {
"currency_code": "USD",
"currency_name": "United States Dollar",
"currency_symbol": "$",
"geo_location": "20001",
"marketplace_domain": "amazon.com",
"marketplace_name": "Amazon US"
}
},
"success": true
}Code Example
get_amazon_marketplaces.py
Python
Ruby
Javascript
Java
Go
import requests
params = {
"api_key": "YOUR_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",
}
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",
});
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", "VALUE");
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", "VALUE")
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#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"description": "Search results data.",
"properties": {
"searchResults": {
"description": "List of search results for products.",
"items": {
"additionalProperties": false,
"description": "A single search result entry.",
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN), a 10-character alphanumeric identifier.",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"discount_info": {
"description": "Information about stock availability or discounts (e.g., \u0027Nur noch 1 auf Lager\u0027).",
"type": "string"
},
"link": {
"description": "URL to the product page on Amazon.",
"format": "uri",
"type": "string"
},
"listingPrice": {
"additionalProperties": false,
"description": "Listing price information.",
"properties": {
"original_price": {
"additionalProperties": false,
"description": "Original price details for the listing, if available.",
"properties": {
"currency_code": {
"description": "Currency code (e.g., EUR).",
"type": "string"
},
"currency_name": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"currency_symbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
},
"total": {
"description": "Total price as a string, with up to two decimal places.",
"pattern": "^[0-9]+(\\.[0-9]{1,2})?$",
"type": "string"
}
},
"required": [
"currency_code",
"currency_name",
"currency_symbol",
"total"
],
"type": "object"
},
"price": {
"additionalProperties": false,
"description": "Price details for the listing.",
"properties": {
"currency_code": {
"description": "Currency code (e.g., EUR).",
"type": "string"
},
"currency_name": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"currency_symbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
},
"total": {
"description": "Total price as a string, with up to two decimal places.",
"pattern": "^[0-9]+(\\.[0-9]{1,2})?$",
"type": "string"
}
},
"required": [
"currency_code",
"currency_name",
"currency_symbol",
"total"
],
"type": "object"
}
},
"required": [
"price"
],
"type": "object"
},
"mainImage": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"on_sale": {
"description": "Indicates if the product is on sale.",
"type": "boolean"
},
"position": {
"description": "Position of the product in the search results.",
"minimum": 1,
"type": "integer"
},
"productTitle": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
},
"reviewAmount": {
"description": "Total number of customer reviews.",
"minimum": 0,
"type": "integer"
},
"reviewRating": {
"description": "Average review rating, with one decimal place, or null if not available.",
"maximum": 5,
"minimum": 0,
"type": [
"number",
"null"
]
},
"sponsored": {
"description": "Indicates if the product is a sponsored listing.",
"type": "boolean"
}
},
"required": [
"asin",
"discount_info",
"link",
"listingPrice",
"mainImage",
"on_sale",
"position",
"productTitle",
"reviewAmount",
"reviewRating",
"sponsored"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"searchResults"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
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": "phone",
"marketplaceId": "A1PA6795UKMFR9",
"count": "30",
"geo_location": "10115",
}
response = requests.get("https://sellermagnet-api.com/api/amazon-search", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"q" => "phone",
"marketplaceId" => "A1PA6795UKMFR9",
"count" => "30",
"geo_location" => "10115",
}
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": "phone",
"marketplaceId": "A1PA6795UKMFR9",
"count": "30",
"geo_location": "10115",
});
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", "phone");
params.put("marketplaceId", "A1PA6795UKMFR9");
params.put("count", "30");
params.put("geo_location", "10115");
params.put("api_key", "VALUE");
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", "phone")
params.Add("marketplaceId", "A1PA6795UKMFR9")
params.Add("count", "30")
params.Add("geo_location", "10115")
params.Add("api_key", "VALUE")
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) |
offset |
number | Optional | Skip the first N ranks (default 0; offset + count must be at most 50) |
api_key |
text | Required | Your API key |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"description": "Bestseller data for the specified category.",
"properties": {
"bestsellers": {
"description": "List of bestseller products.",
"items": {
"additionalProperties": false,
"description": "A single bestseller product entry.",
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"mainImage": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"price": {
"additionalProperties": false,
"description": "Price details for the product.",
"properties": {
"currency_code": {
"description": "Currency code (e.g., EUR).",
"type": "string"
},
"currency_name": {
"description": "Full name of the currency.",
"minLength": 1,
"type": "string"
},
"currency_symbol": {
"description": "Symbol of the currency.",
"minLength": 1,
"type": "string"
},
"price": {
"description": "Price of the product.",
"minimum": 0,
"type": "number"
}
},
"required": [
"currency_code",
"currency_name",
"currency_symbol",
"price"
],
"type": "object"
},
"productImages": {
"description": "List of product image URLs.",
"items": {
"description": "URL to a product image.",
"format": "uri",
"type": "string"
},
"type": "array"
},
"productLink": {
"description": "URL to the product page on Amazon.",
"format": "uri",
"type": "string"
},
"productTitle": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
},
"rank": {
"description": "Bestseller rank in the category.",
"minimum": 1,
"type": "integer"
},
"reviewAmount": {
"description": "Total number of customer reviews.",
"minimum": 0,
"type": "integer"
},
"reviewRating": {
"description": "Average review rating.",
"maximum": 5,
"minimum": 0,
"type": "number"
}
},
"required": [
"asin",
"mainImage",
"productImages",
"productLink",
"productTitle",
"rank",
"reviewAmount",
"reviewRating"
],
"type": "object"
},
"type": "array"
},
"categoryId": {
"description": "Category ID for the bestsellers.",
"type": "string"
},
"link": {
"description": "URL to the bestseller category page on Amazon.",
"format": "uri",
"type": "string"
}
},
"required": [
"bestsellers",
"categoryId",
"link"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
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": "electronics",
"marketplaceId": "A1PA6795UKMFR9",
"count": "30",
"offset": "0",
}
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" => "electronics",
"marketplaceId" => "A1PA6795UKMFR9",
"count" => "30",
"offset" => "0",
}
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": "electronics",
"marketplaceId": "A1PA6795UKMFR9",
"count": "30",
"offset": "0",
});
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", "electronics");
params.put("marketplaceId", "A1PA6795UKMFR9");
params.put("count", "30");
params.put("offset", "0");
params.put("api_key", "VALUE");
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", "electronics")
params.Add("marketplaceId", "A1PA6795UKMFR9")
params.Add("count", "30")
params.Add("offset", "0")
params.Add("api_key", "VALUE")
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
Current deals of a marketplace as JSON: deal price, list price, savings, start/end time and a lightning-deal flag.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
marketplaceId |
text | Required | Marketplace ID (e.g., 'A1PA6795UKMFR9') |
api_key |
text | Required | Your API key |
category_id |
text | Optional | Department slug to filter by (e.g., 'electronics'); omit for all deals |
count |
number | Optional | Number of deals to return (default 30, max 50) |
geo_location |
text | Optional | Detailed Geo Location ZIP CODE |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"description": "Active deals data.",
"properties": {
"deals": {
"description": "List of active deals.",
"items": {
"additionalProperties": false,
"description": "A single deal entry.",
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"basisPrice": {
"description": "List price the saving is measured against, or null when the page shows none.",
"type": [
"number",
"null"
]
},
"coupon_savings": {
"description": "Deal badge text as shown on the page (e.g. \u002720 % Rabatt\u0027), or null.",
"type": [
"string",
"null"
]
},
"dealEndTime": {
"description": "End time of the deal in ISO 8601 format, or \u0027N/A\u0027 if not applicable.",
"format": "date-time",
"type": "string"
},
"dealId": {
"description": "Unique identifier for the deal, or \u0027N/A\u0027 if not applicable.",
"type": "string"
},
"dealLink": {
"description": "URL to the deal page on Amazon.",
"format": "uri",
"type": "string"
},
"dealPrice": {
"additionalProperties": false,
"description": "Price details for the deal.",
"properties": {
"priceCurrency": {
"description": "Currency code (e.g., EUR).",
"type": "string"
},
"priceTotal": {
"description": "Total deal price.",
"minimum": 0,
"type": "number"
}
},
"required": [
"priceCurrency",
"priceTotal"
],
"type": "object"
},
"dealStartTime": {
"description": "Start time of the deal in ISO 8601 format, or \u0027N/A\u0027 if not applicable.",
"format": "date-time",
"type": "string"
},
"image_url": {
"description": "URL to the main product image.",
"format": "uri",
"type": "string"
},
"isLightningDeal": {
"description": "True for a time-limited lightning deal.",
"type": "boolean"
},
"productTitle": {
"description": "Title of the product.",
"minLength": 1,
"type": "string"
},
"savings_percentage": {
"description": "Percentage of savings for the deal.",
"maximum": 100,
"minimum": 0,
"type": "integer"
}
},
"required": [
"asin",
"basisPrice",
"coupon_savings",
"dealEndTime",
"dealId",
"dealLink",
"dealPrice",
"dealStartTime",
"image_url",
"productTitle",
"savings_percentage"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"deals"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
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": "A1PA6795UKMFR9",
"category_id": "electronics",
"count": "30",
"geo_location": "10115",
}
response = requests.get("https://sellermagnet-api.com/api/amazon-deals", params=params)
print(response.json())
require 'httparty'
params = {
"api_key" => "YOUR_API_KEY",
"marketplaceId" => "A1PA6795UKMFR9",
"category_id" => "electronics",
"count" => "30",
"geo_location" => "10115",
}
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": "A1PA6795UKMFR9",
"category_id": "electronics",
"count": "30",
"geo_location": "10115",
});
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", "A1PA6795UKMFR9");
params.put("api_key", "VALUE");
params.put("category_id", "electronics");
params.put("count", "30");
params.put("geo_location", "10115");
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", "A1PA6795UKMFR9")
params.Add("api_key", "VALUE")
params.Add("category_id", "electronics")
params.Add("count", "30")
params.Add("geo_location", "10115")
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#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"asin": {
"description": "Amazon Standard Identification Number (ASIN).",
"pattern": "^[A-Z0-9]{10}$",
"type": "string"
},
"category": {
"description": "Root category name, or null if unknown.",
"type": [
"string",
"null"
]
},
"estimatedSells": {
"description": "Same value as estimated_monthly_sales (kept for existing integrations).",
"minimum": 0,
"type": "integer"
},
"estimated_monthly_sales": {
"description": "Estimated number of units sold per month.",
"minimum": 0,
"type": "integer"
},
"marketplace_domain": {
"description": "Domain of the marketplace (e.g., \u0027amazon.com\u0027).",
"type": "string"
},
"sales_rank": {
"description": "Latest sales rank in the root category, or null if unranked.",
"minimum": 1,
"type": [
"integer",
"null"
]
}
},
"required": [
"asin",
"estimated_monthly_sales",
"sales_rank",
"category",
"marketplace_domain"
],
"type": "object"
},
"success": {
"description": "Indicates whether the API request was successful.",
"type": "boolean"
}
},
"required": [
"data",
"success"
],
"type": "object"
}Response Example
200 OK
application/json
{
"data": {
"asin": "B08N5WRWNW",
"category": "Electronics",
"estimatedSells": 121,
"estimated_monthly_sales": 121,
"marketplace_domain": "amazon.com",
"sales_rank": 1500
},
"success": true
}Code Example
amazon_product_search_estimated_sells.py
Python
Ruby
Javascript
Java
Go
import requests
params = {
"api_key": "YOUR_API_KEY",
"asin": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
}
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" => "B08N5WRWNW",
"marketplaceId" => "A1PA6795UKMFR9",
}
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": "B08N5WRWNW",
"marketplaceId": "A1PA6795UKMFR9",
});
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", "B08N5WRWNW");
params.put("marketplaceId", "A1PA6795UKMFR9");
params.put("api_key", "VALUE");
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", "B08N5WRWNW")
params.Add("marketplaceId", "A1PA6795UKMFR9")
params.Add("api_key", "VALUE")
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.
Each API key can run up to 40 requests at the same time; beyond that, requests queue briefly and then answer 429 with a Retry-After header. Each IP address may send 600 requests per minute and 15,000 per hour. There is no batch endpoint: send one request per ASIN and run them in parallel.
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.
150 free API credits • No credit card required • Cancel anytime