Skip to main content
GET
Amazon Best Sellers
Read one Amazon BEST_SELLERS or NEW_RELEASES page for a department or department/node path. Pages 1 and 2 are supported. Oxylabs Best Sellers checks returned 50 rows on each US source page; the alternative source returned 30 rows from each 50-rank window. Exact coverage and rank availability depend on the source; do not infer a global rank from page-relative position. NEW_RELEASES uses the alternative source. A cursor appears only when the source confirms another page; cursors stay with their original provider. Other list types return 422 with no net charge. A nonempty live page costs 1 credit; a successful empty page refunds the hold. Missing stock, original prices and totals remain null. Other marketplaces require production verification. Provider trials have finite allowances and fail closed when exhausted. The existing alternative provider remains available within its separate approved budget.

Authorizations

x-api-key
string
header
required

Headers

Cache-Control
string
Idempotency-Key
string
X-Max-Credits
integer

Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero.

Required range: x >= 0

Query Parameters

category
string
required
country
enum<string>
Available options:
US,
GB,
CA,
DE,
FR,
IT,
ES,
JP,
IN,
MX,
BR,
AU,
NL
type
enum<string>

Supported source list type. Other reference-product list types remain unavailable.

Available options:
BEST_SELLERS,
NEW_RELEASES
page
integer

Source page 1 or 2; use page=2 if the source provides no next_cursor.

Required range: 1 <= x <= 2
cursor
string

Opaque next_cursor emitted only when the source confirms another page. Cannot be combined with page.

Response

Read one Amazon BEST_SELLERS or NEW_RELEASES page for a department or department/node path. Pages 1 and 2 are supported. Oxylabs Best Sellers checks returned 50 rows on each US source page; the alternative source returned 30 rows from each 50-rank window. Exact coverage and rank availability depend on the source; do not infer a global rank from page-relative position. NEW_RELEASES uses the alternative source. A cursor appears only when the source confirms another page; cursors stay with their original provider. Other list types return 422 with no net charge. A nonempty live page costs 1 credit; a successful empty page refunds the hold. Missing stock, original prices and totals remain null. Other marketplaces require production verification.

success
boolean
required
platform
string
required
endpoint
string
required
credits_used
integer
required
Required range: x >= 0
credits_remaining
integer | null
required
request_id
string
required
cached
boolean
required
data
object
required

The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.