amazon.ca APIamazon.ca ↗
Search Amazon Canada products, retrieve product details by ASIN, fetch live deals, and get best sellers by category. 4 endpoints, no Amazon PA-API account required.
curl -X GET 'https://api.parse.bot/scraper/28c48b7b-73f9-48d8-a513-74cfdb14d8b9/search_products?page=1&query=headphones' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Amazon.ca by keyword and optional category. Returns deduplicated product listings with titles, prices, and discounts.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Search keyword |
| sort_by | string | Sort order: 'price-asc-rank' (price low to high), 'price-desc-rank' (price high to low), 'review-rank' (average customer review) |
| category | string | Amazon department/category filter slug passed as the 'i' parameter |
{
"type": "object",
"fields": {
"query": "search keyword echoed back",
"products": "array of product objects with asin, title, current_price, original_price, discount, rating, reviews_count, is_prime, url",
"total_found": "number of products returned on this page"
},
"sample": {
"data": {
"query": "headphones",
"products": [
{
"url": "https://www.amazon.ca/dp/B0C6KFZC9Z",
"asin": "B0C6KFZC9Z",
"title": "Soundcore by Anker,CS 30Q, Active Noise Cancelling Headphones",
"rating": null,
"discount": null,
"is_prime": true,
"current_price": 129.99,
"reviews_count": null,
"original_price": null
}
],
"total_found": 61
},
"status": "success"
}
}About the amazon.ca API
The Amazon.ca API provides 4 endpoints to query product listings, retrieve ASIN-level detail, pull current deals, and fetch category best-seller rankings from Amazon Canada. The search_products endpoint returns up to a full page of deduplicated results including title, current and original price, discount, rating, review count, and Prime eligibility — all in a single call.
Product Search and Detail
The search_products endpoint accepts a required query string plus optional category, sort_by, and page parameters. Sort options include price-asc-rank, price-desc-rank, and review-rank. Each product object in the products array carries asin, title, current_price, original_price, discount, rating, reviews_count, is_prime, and url. The total_found field reflects the count of items returned on that page, not the total catalog count.
The get_product_details endpoint takes a single asin and returns targeted pricing data: current_price, original_price, a discount object containing amount, percentage, and label (or null when no discount is active), and the canonical url for the listing on amazon.ca. This endpoint is useful when you already have an ASIN from another source and need current Canadian pricing without running a full search.
Deals and Best Sellers
The get_deals endpoint requires no inputs and returns the deals array from the Amazon.ca Deals Store. Each deal object includes asin, discount_pct (integer or null), and url. The total field gives the count of deals found. To get full product metadata for any deal, pass the returned ASIN to get_product_details.
The get_best_sellers endpoint accepts an optional category slug such as electronics, books, sports, kitchen, or beauty. Each result in the products array includes rank, asin, title, current_price, rating, image, and url. Omitting the category slug may return an empty result set, so a category value is strongly recommended. Combining this endpoint with get_product_details lets you build ranked lists with full pricing and discount detail.
- Track price changes on specific ASINs over time using
current_priceandoriginal_pricefromget_product_details - Build a Canadian deal aggregator by polling
get_dealsand enriching results viaget_product_details - Compare category best-seller rankings across
electronics,books, andkitchenusingget_best_sellerswith therankfield - Filter Amazon Canada search results by price using
sort_by: price-asc-rankand surface only Prime-eligible items viais_prime - Monitor discount percentage on trending products by combining
search_productsresults with thediscountfield - Generate affiliate content for Canadian shoppers by pulling top-ranked products and images from
get_best_sellers - Cross-reference deal ASINs from
get_dealswith search results to identify deal depth and original pricing
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Amazon have an official developer API for product data?+
What does `get_product_details` return when a product has no active discount?+
discount field is returned as null. The current_price and original_price fields are still populated when available, so you can compute any difference yourself. If price data is unavailable (e.g. for out-of-stock listings), those fields may also return null.Does `search_products` return all results across multiple pages?+
total_found field reflects the count on that page, not the total catalog size. To retrieve additional pages, increment the page parameter in successive calls. There is no built-in cursor or total-pages field in the response.