Browse the product catalog
Browse the products available to you in the Archer catalog, on the Amazon marketplace of your choice.
Picking a marketplace
Use marketplace to choose the Amazon marketplace — for example
amazon.com, amazon.co.uk, amazon.de or amazon.fr. North-American and
European marketplaces are supported.
Pass marketplace=all to retrieve products from every marketplace in a
single response; each product still carries its own marketplace field so
you can split client-side.
Default: marketplace defaults to amazon.com when omitted, for
backward compatibility with pre-v2 clients. If you’re a new integration and
want to see products from non-US marketplaces (e.g. UK), you must pass
either a specific marketplace (such as amazon.co.uk) or all. Omitting
the parameter will only return US products.
Filtering and sorting
search— finds products whose title, ASIN, brand or category matches.brand_id— restrict to a single brand. Brand ids come from/brands.asins— restrict to specific products. Separate multiple ASINs with commas.product_available—yes(default) returns only products that are in stock and good to promote.noreturns only unavailable products.eitherreturns both.sort_by—title,commission(highest first) orprice(cheapest first).
Paging through results
Use skip and limit to page through the catalog. total_count is the
size of the full filtered set; fetched_count is how many you got back.
What’s in each product
| Field | What it tells you |
|---|---|
ASIN | Amazon product identifier. |
product_name | Product title. |
marketplace | Amazon marketplace the product belongs to. |
pricing.price and pricing.currency | Numeric price and its currency. |
price | Price as a plain string (mirror of pricing.price). |
commission | Affiliate commission rate you’d earn on a sale. |
image_encoded_string and images | Primary image and ordered gallery. Without a stored gallery, images is [image_encoded_string]; it is empty only when no primary image exists. |
list_price | Amazon list (was) price, when available. |
avg_rating and total_reviews | Average star rating and number of reviews. |
best_seller, sales_rank, rank_category, monthly_sold | Product demand and ranking signals, when available. |
inStock | Whether the product is currently buyable. |
product_url | A ready-to-share Amazon URL on the right marketplace. |
company_name and company_logo | The brand’s name and logo. |
product_category and sub_category | Where the product sits in the catalog. |
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
Number of rows to skip for offset pagination.
x >= 0Rows per page (1–500, default 100).
1 <= x <= 500Which Amazon marketplace to browse — e.g. amazon.com, amazon.co.uk, amazon.de. Defaults to amazon.com when omitted, for backward compatibility with pre-v2 clients. Pass all to retrieve products from every marketplace.
Find products whose title, ASIN, brand name or category matches.
Limit results to a single brand. Brand ids come from /brands.
yes (default) only returns products that are in stock and good to promote. no returns only unavailable products. either returns both.
yes, no, either Limit results to one or more products. Separate multiple ASINs with commas.
Sort order. commission shows highest-paying first; title and price sort ascending.
title, commission, price Response
Successful Response
Paginated catalog response returned by GET /getproducts.
Total products matching the filters across all pages.
Number of products in this page.
Offset that produced this page.
Page size that produced this page.
The rows for this page.