Amazon products by category id and country

justoneapi.x.amazon-get-category-products-v1

Retrieves paginated Amazon products for a numeric category node in a selected country marketplace, with configurable result sorting.

Price: $0.01476/successAt provider cost
Success rate: 100%Last 30 days · 5 calls
Latency p50: 4.2 sp95 7.1 s
Last verified: —Not verified yet

GEThttps://toolswitch.dev/v1/tools/justoneapi.x.amazon-get-category-products-v1Preview

Try onlineProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description	Example
Query parameters
`page`	integer	Optional	Page number for pagination.	`1`
`sortBy`	string	Optional	Sort by. Available Values: - `RELEVANCE`: Relevance - `LOWEST_PRICE`: Lowest Price - `HIGHEST_PRICE`: Highest Price - `REVIEWS`: Reviews - `NEWEST`: Newest - `BEST_SELLERS`: Best Sellers One of: RELEVANCE, LOWEST_PRICE, HIGHEST_PRICE, REVIEWS, NEWEST, BEST_SELLERS.	`RELEVANCE`
`country`	string	Optional	Country code for the Amazon product. Available Values: - `US`: United States - `AU`: Australia - `BR`: Brazil - `CA`: Canada - `CN`: China - `FR`: France - `DE`: Germany - `IN`: India - `IT`: Italy - `MX`: Mexico - `NL`: Netherlands - `SG`: Singapore - `ES`: Spain - `TR`: Turkey - `AE`: United Arab One of: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG.	`US`
`categoryId`	string	Required	Numeric Amazon category node ID taken from the node query parameter of a category URL.

Query parameters
pageintegerOptional
Page number for pagination.
Example: 1
sortBystringOptional
Sort by. Available Values: - `RELEVANCE`: Relevance - `LOWEST_PRICE`: Lowest Price - `HIGHEST_PRICE`: Highest Price - `REVIEWS`: Reviews - `NEWEST`: Newest - `BEST_SELLERS`: Best Sellers One of: RELEVANCE, LOWEST_PRICE, HIGHEST_PRICE, REVIEWS, NEWEST, BEST_SELLERS.
Example: RELEVANCE
countrystringOptional
Country code for the Amazon product. Available Values: - `US`: United States - `AU`: Australia - `BR`: Brazil - `CA`: Canada - `CN`: China - `FR`: France - `DE`: Germany - `IN`: India - `IT`: Italy - `MX`: Mexico - `NL`: Netherlands - `SG`: Singapore - `ES`: Spain - `TR`: Turkey - `AE`: United Arab One of: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG.
Example: US
categoryIdstringRequired
Numeric Amazon category node ID taken from the node query parameter of a category URL.

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/justoneapi.x.amazon-get-category-products-v1' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/justoneapi.x.amazon-get-category-products-v1",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/justoneapi.x.amazon-get-category-products-v1", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.01476/success, including the service fee.