Skip to main content
GET
/
v1
/
amazon
/
category
Browse Category
curl --request GET \
  --url https://scrapebadger.com/v1/amazon/category \
  --header 'x-api-key: <api-key>'
{
  "node": "172282",
  "domain": "com",
  "results": [
    {
      "position": 1,
      "asin": "B0CHWRXH8B",
      "title": "Bose QuietComfort Ultra Wireless Earbuds",
      "link": "https://www.amazon.com/dp/B0CHWRXH8B",
      "image": "https://m.media-amazon.com/images/I/61abc123.jpg",
      "price": {
        "value": 249,
        "currency": "USD",
        "symbol": "$",
        "raw": "$249.00"
      },
      "list_price": null,
      "unit_price": null,
      "rating": 4.4,
      "ratings_total": 12480,
      "is_prime": true,
      "is_sponsored": false,
      "is_amazons_choice": false,
      "is_best_seller": true,
      "bought_past_month": null,
      "coupon": null,
      "availability": "In Stock"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 20,
    "total_results": 660
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Query Parameters

​
node
string
required
Amazon browse-node id to list products from. You can find browse-node ids in product bestsellers_rank links or category URLs (node=...).
​
domain
string
default:"com"
Amazon marketplace TLD or code.Examples: com, co.uk, de
​
page
integer
default:1
Page number for paginated results. Range: 1 - 20.
​
sort_by
string
Sort order for results.
ValueDescription
relevanceBest match (default)
price_low_to_highCheapest first
price_high_to_lowMost expensive first
avg_reviewHighest customer rating first
newestMost recently added

​
Response

​
node
string
The browse-node id that was listed.
​
domain
string
Marketplace domain.
​
results
array
Array of products in the category.
​
pagination
object
Pagination metadata with current_page, total_pages, total_results.

​
Example Response

{
  "node": "172282",
  "domain": "com",
  "results": [
    {
      "position": 1,
      "asin": "B0CHWRXH8B",
      "title": "Bose QuietComfort Ultra Wireless Earbuds",
      "link": "https://www.amazon.com/dp/B0CHWRXH8B",
      "image": "https://m.media-amazon.com/images/I/61abc123.jpg",
      "price": { "value": 249.0, "currency": "USD", "symbol": "$", "raw": "$249.00" },
      "rating": 4.4,
      "ratings_total": 12480,
      "is_prime": true,
      "is_best_seller": true,
      "availability": "In Stock"
    }
  ],
  "pagination": { "current_page": 1, "total_pages": 20, "total_results": 660 }
}
Each category request costs 5 credits. Failed requests are not charged.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
node
string
required

Amazon browse-node id to list products from.

​
domain
string
default:com

Amazon marketplace TLD or code (com, co.uk, de, ...).

​
page
integer
default:1

Page number for paginated results.

Required range: 1 <= x <= 20
​
sort_by
enum<string>

Sort order for results.

Available options:
relevance,
price_low_to_high,
price_high_to_low,
avg_review,
newest

Response

200 - application/json

Category product listing

​
node
string
​
domain
string
​
results
object[]
​
pagination
object