GET /api/amazon/search — Amazon Product Search

The search endpoint lets you query Amazon’s product catalog by keyword and refine results using category, price range, condition, sort order, and pagination. Results include product titles, prices, ratings, Prime eligibility, and available filter facets — giving you everything you need to build a full-featured product search experience.

Request

string

required

The keyword or phrase to search for (e.g., "noise cancelling headphones").

string

default:"US"

The Amazon marketplace to query. Supported values: US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP, PL. Defaults to US.

string

Restrict results to a specific Amazon category. Use the autocomplete or bestseller-categories endpoints to discover valid category IDs.

string

Sort order for results. Common values:

featured — Amazon’s default relevance sort
price-asc-rank — lowest price first
price-desc-rank — highest price first
review-rank — top-rated first
date-desc-rank — newest arrivals first

string

Filter by item condition. Accepted values include new, used, renewed, and collectible.

string

Minimum price filter (in the marketplace’s local currency). Pass as a plain numeric string, e.g., "25".

string

Maximum price filter (in the marketplace’s local currency). Pass as a plain numeric string, e.g., "200".

integer

Page number to retrieve. Use alongside pageInfo.totalPages in the response to paginate through results.

integer

Number of results to return per page.

Example request

curl "https://api.glade.dev/api/amazon/search?searchTerm=noise%20cancelling%20headphones&domain=US&maxPrice=200" \
  -H "API-KEY: YOUR_API_KEY"

Response

A successful response returns a data.amazonProductSearchResults object containing filter refinements and a paginated list of products.

object

Hide properties

Filter facets available for the current search. Use these to build dynamic filter UIs.

Show availableRefinements[]

string

Display name of the filter group (e.g., "Brand", "Customer Reviews").

array

Show options[]

string

Display label for this filter option (e.g., "Sony", "4 Stars & Up").

object

Show properties

array

Array of matched product objects.

Show results[]

string

Full product title as shown on Amazon.

string

Canonical Amazon product page URL.

string

Amazon Standard Identification Number uniquely identifying the product. Matches the pattern ^[A-Z0-9]{10}$.

object

Show properties

string

Currency symbol (e.g., "$").

number

Numeric price value.

string

ISO 4217 currency code (e.g., "USD").

string

Human-readable price string (e.g., "$149.99").

string

URL of the product’s primary image.

number

Average customer rating out of 5.

integer

Total number of customer ratings.

boolean

true if the product is eligible for Amazon Prime shipping.

boolean

true if this result is a sponsored/advertising placement.

object | null

Coupon object if a coupon is available, otherwise null.

Show properties

string

Coupon label displayed on Amazon (e.g., "Save 10%").

object

Show properties

integer

The current page number returned.

integer

Total number of pages available for this query.

integer

Estimated total number of matching products.

boolean

true if there is a subsequent page of results.

boolean

true if there is a previous page of results.

Example response

{
  "data": {
    "amazonProductSearchResults": {
      "availableRefinements": [
        {
          "name": "Brand",
          "options": [
            { "name": "Sony" },
            { "name": "Bose" },
            { "name": "JBL" }
          ]
        },
        {
          "name": "Customer Reviews",
          "options": [
            { "name": "4 Stars & Up" },
            { "name": "3 Stars & Up" }
          ]
        }
      ],
      "productResults": {
        "results": [
          {
            "title": "Sony WH-1000XM5 Wireless Industry Leading Noise Canceling Headphones",
            "url": "https://www.amazon.com/dp/B09XS7JWHH",
            "asin": "B09XS7JWHH",
            "price": {
              "symbol": "$",
              "value": 199.99,
              "currency": "USD",
              "display": "$199.99"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/61vCs5JMGgL._AC_SL1500_.jpg",
            "rating": 4.4,
            "ratingsTotal": 18423,
            "isPrime": true,
            "sponsored": false,
            "coupon": null
          },
          {
            "title": "Anker Soundcore Life Q30 Hybrid Active Noise Cancelling Headphones",
            "url": "https://www.amazon.com/dp/B08HVTLT42",
            "asin": "B08HVTLT42",
            "price": {
              "symbol": "$",
              "value": 55.99,
              "currency": "USD",
              "display": "$55.99"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/61TBi3vgHbL._AC_SL1500_.jpg",
            "rating": 4.5,
            "ratingsTotal": 64891,
            "isPrime": true,
            "sponsored": false,
            "coupon": { "label": "Save 10%" }
          },
          {
            "title": "Jabra Evolve2 55 Wireless PC Headset — Noise Cancelling",
            "url": "https://www.amazon.com/dp/B09B4JZQKL",
            "asin": "B09B4JZQKL",
            "price": {
              "symbol": "$",
              "value": 189.00,
              "currency": "USD",
              "display": "$189.00"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/51XaL4WBTZL._AC_SL1500_.jpg",
            "rating": 4.2,
            "ratingsTotal": 3107,
            "isPrime": true,
            "sponsored": true,
            "coupon": null
          }
        ],
        "pageInfo": {
          "currentPage": 1,
          "totalPages": 20,
          "totalResults": 4000,
          "hasNextPage": true,
          "hasPrevPage": false
        }
      }
    }
  }
}

Error handling

If your request is malformed or unauthorized, the API returns a standard error envelope. The searchTerm parameter is required — omitting it returns a 400 error.

{
  "success": false,
  "errors": [
    {
      "code": "BAD_REQUEST",
      "message": "Query parameter 'searchTerm' is required.",
      "path": "searchTerm"
    }
  ]
}

Status	Meaning
`400`	Missing or invalid query parameters
`401`	Missing or invalid `API-KEY` / Bearer token
`402`	Plan limit reached or payment required
`429`	Rate limit exceeded
`502`	Upstream Amazon error or bad gateway

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/search — Amazon Product Search

Request

Example request

Response

Example response

Error handling

​Request

​Example request

​Response

​Example response

​Error handling

Request

Example request

Response

Example response

Error handling