marketplace.category.products

marketplace.category.products

Credits: 1/entry returned
Returns the top products based on bestseller ranking for the specified category. Optional parameters allow further filtering of the results by specific brands, seller, price ranges, and more.

Result

The result provides a list of top products in the given category. Each product includes its rank in the category (rank), the ASIN for identification (asin), the parent ASIN (parent_asin), and the title (title). Additionally, it shows the count of reviews (rev_count), the average review rating (rev_stars), the price (price), the number of sales (sales), and the sales rank (sales_rank). It also includes the total sales volume (sales_vol) and the corresponding rank for sales volume (sales_vol_rank). The result provides information about the Buy Box seller (bb_seller) and the Buy Box seller ID (bb_seller_id), as well as the brand of each product (brand).

GET-Parameters

Parameters (Mandatory)

api_key
STRING
Your personal API key. This key is used to authenticate your requests. You can obtain it here.
category
STRING
An identifier used by Amazon to uniquely represent a category. It can be found in the URL when viewing a category in SISTRIX for Amazon.

Parameters (Optional)

brand_name
STRING
The Brand parameter filters the results to a specific brand, identified by its full brand name.
bb_seller_id
STRING
An identifier used by Amazon to uniquely distinguish a seller. It filters the results for a single seller. The seller ID can be extracted from the Sistrix URL, such as: https://amz.sistrix.com/de/seller/A13P6277X44WWB.
min_bb_price
NUMERIC
Limits the products to those with a higher Buy Box price than the specified value. Decimal places are separated by a period. Together with the max_bb_price parameter, a price range can be defined.
max_bb_price
NUMERIC
Limits the products to those with a lower bestseller rank than the specified value. Together with the min_bsr parameter, a bestseller rank range can be defined.
min_bsr
INTEGER
Limits the products to those with a higher bestseller rank than the specified value. Together with the max_bsr parameter, a bestseller rank range can be defined.
max_bsr
INTEGER
Limits the products to those with a lower bestseller-rank than the specified value. Together with the min_bsr parameter, a ranking range can be defined.
limit
INTEGER
Specifies the maximum number of products to return. Adjust this parameter to control how many products are included in the response. The base value is 100, but it can be extended up to 10,000.
offset
INTEGER
The OFFSET parameter specifies the starting point in the list of results, enabling you to skip a certain number of items.
country
STRING / countrycode
Defines the country for which the method will be executed. You can find a list of available marketplace country codes here. If no country parameter is provided, the default country is 'de'.
format
STRING
Specifies whether the response will be returned in XML or JSON format. By default, the result will be in XML format.
To be able to use the API documentation with real data, you have to create an API key in your account.
EXAMPLE
$baseUrl = "https://api.sistrix.com/marketplace.category.products";

$post = [



];

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, $baseUrl);

curl_setopt($curl, CURLOPT_POSTFIELDS, $post);

curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);

$response = curl_exec($curl);

curl_close($curl);
import requests

baseUrl = 'https://api.sistrix.com/marketplace.category.products'

post = {



}

response = requests.post(baseUrl, post)

data = response.text
curl https://api.sistrix.com/marketplace.category.products \


let baseUrl = 'https://api.sistrix.com/marketplace.category.products';

let form = new FormData();



fetch(baseUrl, {

    method: 'POST',

    body: form

}).then(function(response){

    return response.text();

}).then(function(data){

    //data contains the results of the request

})