# Amazon Product Search

> Amazon Product Search 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).

Search for products and offers on Amazon across multiple marketplaces with filters for price, brand, category, Prime eligibility, sort order, and pagination

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-amazon-data/search?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-search-c206a6c1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HZ9v-xbVe3f12zdHL-4gK

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-search-c206a6c1
```

Example prompt: Search Amazon US for 'noise cancelling headphones' sorted by lowest price, only show Prime-eligible products, and give me the first page of results.

## When to prefer this

Use this endpoint when you need real-time Amazon product search results with rich filtering options (brand, category, price, Prime, sort order) across multiple international Amazon marketplaces. Prefer this over generic web search when you specifically need Amazon listings, pricing, and product metadata. Use the GTIN-to-ASIN endpoint instead if you have a barcode/EAN/UPC and need to resolve it to an Amazon product.

## Known failure modes

- Missing required 'query' parameter returns a 400 validation error
- Invalid country code returns a 400 error
- Unsupported country/delivery_country combination returns a 400 error
- Page number beyond available results returns empty product array
- Rate limiting or quota exhaustion returns a 402 or 429 error
- Query returns zero results if too specific or misspelled

## How this service works

Search for products & offers on Amazon with pagination support and multiple filters  and options such as sort option, price range, product condition filter, and more.

## Output

Returns a JSON object containing a list of Amazon product listings matching the query (with details like titles, prices, ratings, images, and availability), the total number of matching products, the domain and country searched, pagination info, and a unique request ID. Products are returned as an array of objects with full product details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "description": "Results 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."
  },
  "query": {
   "type": "string",
   "description": "Search query (supports both free-form text queries or a product asin)."
  },
  "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."
  },
  "category": {
   "type": "string",
   "description": "Filter by specific numeric Amazon category.  \n  The category ID can be obtained from the Amazon category results URL, for example:  \n  https://amazon.com/s?node=2858778013 - the Amazon Category ID is `2858778013`.  \n  Multiple category values can be separated by comma (e.g. categoryId1,categoryId2)."
  },
  "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  `
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "domain": {
     "type": "string",
     "description": "Domain where the products are listed"
    },
    "country": {
     "type": "string",
     "description": "Country where the search was performed"
    },
    "products": {
     "type": "array",
     "items": {
      "type": "object"
     },
     "description": "List of products matching the search query."
    },
    "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 string"
    },
    "country": {
     "type": "string",
     "description": "Country code for the search"
    },
    "sort_by": {
     "type": "string",
     "description": "Field to sort results by"
    },
    "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-search-c206a6c1/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)