SearchItems

Searches the product catalog of one marketplace, like the search box on Amazon. Use it when you do not know the ASINs yet, for example to build product lists for a topic or to find products by brand.

Every search needs at least one of keywords, actor, artist, author, brand or title. You get up to 10 results per page and up to 10 pages.

POST https://creatorsapi.amazon/catalog/v1/searchItems

Main parameters

Name	Notes
`keywords`	search phrase
`searchIndex`	category, default `All`; values differ per marketplace
`browseNodeId`	limit to a category node
`itemCount`	1 to 10, default 10
`itemPage`	1 to 10, default 1
`sortBy`	e.g. `Price:HighToLow`, `NewestArrivals`, `AvgCustomerReviews`, `Featured`, `Relevance`
`minPrice`, `maxPrice`, `minReviewsRating`, `minSavingPercent`	filters
`availability`, `condition`, `deliveryFlags`	filters
`partnerTag`, `marketplace`	required

Example request

{
  "keywords": "headphones",
  "searchIndex": "Electronics",
  "itemCount": 3,
  "marketplace": "www.amazon.com",
  "partnerTag": "xyz-20",
  "resources": ["images.primary.medium", "itemInfo.title", "offersV2.listings.price"]
}

Results are in searchResult.items, with totalResultCount and searchURL. A search without results returns ResourceNotFoundException.