# Amazon Product by Category

> Amazon Product by Category is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Returns paginated Amazon product listings and offers within a specific category, with filters for price, condition, brand, Prime eligibility, and sort order.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-amazon-data/products-by-category?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-amazon-product-by-category-da21ad12
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JZKqcyjBbzwG-f7yTXDpB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-amazon-product-by-category-da21ad12
```

Example prompt: Show me the top 20 best-selling, Prime-eligible products in Amazon category 2858778013 on the US marketplace, sorted by best sellers, priced between $20 and $200.

## When to prefer this

Use this endpoint when you need to browse or enumerate products within a known Amazon category node (by ID) rather than searching by keyword. Ideal for category-level product discovery, competitive analysis, price monitoring by category, and building product feeds. Prefer over keyword search when the category structure is known and you need paginated, filterable category results across multiple Amazon marketplaces.

## Known failure modes

- Invalid or non-existent category_id returns empty results or 400 error
- Unsupported country/delivery_country combination returns 400 error
- Missing required category_id parameter causes validation error
- Rate limiting or payment/credit exhaustion returns 402 or 429
- Invalid sort_by or country enum value causes 400 bad request
- Page number beyond available results returns empty product list

## How this service works

Get products & offers in a specific Amazon category with pagination support and multiple filters and options such as sort option, price range, product condition filter, and more.

## Output

Returns a list of Amazon product objects for the specified category, including product details and offers, along with total product count, domain and country metadata, pagination info, and a unique request ID. Each product object contains fields such as title, price, ASIN, ratings, Prime eligibility, and condition.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "category_id"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "description": "Page to return."
  },
  "brand": {
   "type": "string",
   "description": "Find products with a specific brand.  \n  Multiple brands can be specified as a comma (,) separated list.  \n  The brand values can be seen from Amazon's search left filters panel, as seen here."
  },
  "fields": {
   "type": "string",
   "description": "A comma separated list of product fields to include in the response (field projection).  \n  By default all fields are returned."
  },
  "country": {
   "enum": [
    "US",
    "AU",
    "BR",
    "CA",
    "CN",
    "FR",
    "DE",
    "IN",
    "IT",
    "MX",
    "NL",
    "SG",
    "ES",
    "TR",
    "AE",
    "GB",
    "JP",
    "SA",
    "PL",
    "SE",
    "BE",
    "EG",
    "ZA",
    "IE"
   ],
   "type": "string",
   "default": "US",
   "description": "Sets the Amazon domain, marketplace country, language and currency."
  },
  "sort_by": {
   "enum": [
    "RELEVANCE",
    "LOWEST_PRICE",
    "HIGHEST_PRICE",
    "REVIEWS",
    "NEWEST",
    "BEST_SELLERS"
   ],
   "type": "string",
   "default": "RELEVANCE",
   "description": "Return the results in a specific sort order."
  },
  "is_prime": {
   "type": "boolean",
   "default": false,
   "description": "Only return prime products."
  },
  "language": {
   "type": "string",
   "description": "The language of the results. In case not specified, results will be returned in the default domain language.  \n\n  **Supported languages per country:**  \n  `US`: en_US, es_US  \n  `AU`: en_AU  \n  `BR`: pt_BR  \n  `CA`: en_CA, fr_CA  \n  `FR`: fr_FR, en_GB  \n  `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK  \n  `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN  \n  `IT`: it_IT, en_GB  \n  `MX`: es_MX  \n  `NL`: nl_NL, en_GB  \n  `SG`: en_SG  \n  `ES`: es_ES, pt_PT, en_GB  \n  `TR`: tr_TR  \n  `AE`: en_AE, ar_AE  \n  `GB`: en_GB  \n  `JP`: ja_JP, en_US, zh_CN  \n  `SA`: ar_AE, en_AE  \n  `PL`: pl_PL  \n  `SE`: sv_SE, en_GB  \n  `BE`: fr_BE, nl_BE, en_GB  \n  `EG`: ar_AE, en_AE  \n  `ZA`: en_ZA  \n  `IE`: en_IE  "
  },
  "max_price": {
   "type": "integer",
   "description": "Only return product offers with price lower than a certain value.  \n  Specified in the currency of the selected country. \n  For example, in case `country=US`, a value of `105.34` means `$105.34`."
  },
  "min_price": {
   "type": "number",
   "descrip
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "domain": {
     "type": "string",
     "description": "Domain or marketplace identifier"
    },
    "country": {
     "type": "string",
     "description": "Country where the search was performed"
    },
    "products": {
     "type": "array",
     "items": {
      "type": "object"
     },
     "description": "List of products in the requested category."
    },
    "total_products": {
     "type": "integer",
     "description": "Total number of products matching the query"
    }
   }
  },
  "status": {
   "type": "string",
   "description": "The status of the API response"
  },
  "parameters": {
   "type": "object",
   "properties": {
    "page": {
     "type": "integer",
     "description": "Current page number in pagination"
    },
    "query": {
     "type": "string",
     "description": "The search query term"
    },
    "country": {
     "type": "string",
     "description": "Country code for the search"
    },
    "sort_by": {
     "type": "string",
     "description": "Sorting method for results"
    },
    "is_prime": {
     "type": "boolean",
     "description": "Filter for Prime-eligible products"
    }
   }
  },
  "request_id": {
   "type": "string",
   "description": "Unique identifier for the API request"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-amazon-product-by-category-da21ad12/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)