Skip to main content
GET
Search Products

Query Parameters

query
string
required
Search keywords. Matches against product titles, brands, and descriptions.
domain
string
default:"com"
Amazon marketplace TLD or code. See /v1/amazon/markets for all supported values.Examples: com, co.uk, de, fr, co.jp
page
integer
default:1
Page number for paginated results. Range: 1 - 20.
sort_by
string
Sort order for results.
category
string
Department/category alias to scope the search (the i= parameter). Use /v1/amazon/categories to look up aliases.Example: electronics, stripbooks
min_price
number
Minimum price filter in the marketplace’s local currency.
max_price
number
Maximum price filter in the marketplace’s local currency.
zip
string
Delivery postal/zip code for localized pricing and availability.
language
string
Locale for results, e.g. en_US, fr_FR.

Response

query
string
The search query that was executed.
domain
string
Marketplace domain that was searched.
results
array
Array of matching products.
pagination
object
Pagination metadata with current_page, total_pages, total_results.

Example Response

Each search request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Query Parameters

query
string
required

Search keywords.

domain
string
default:com

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

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
category
string

Department/category alias to scope the search (the i= parameter).

min_price
number

Minimum price filter in the marketplace's local currency.

Required range: x >= 0
max_price
number

Maximum price filter in the marketplace's local currency.

Required range: x >= 0
zip
string

Delivery postal/zip code for localized pricing.

language
string

Locale for results, e.g. en_US, fr_FR.

Response

200 - application/json

Successful search

query
string

The search query that was executed.

domain
string

Marketplace domain that was searched.

results
object[]
pagination
object