amzn.to APIamzn.to ↗
Access Amazon product search, ASIN detail lookups, and category best sellers via a single API. Returns titles, prices, ratings, images, and feature bullets.
curl -X GET 'https://api.parse.bot/scraper/8a2411e1-9d59-464f-bd01-d8b35e0e77f5/search_products?query=wireless+headphones' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Amazon by keyword. Returns paginated results with product title, price, rating, and image URL.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'wireless headphones'). |
{
"type": "object",
"fields": {
"page": "string indicating the current page number",
"items": "array of product objects each containing asin, title, price, rating, and image"
},
"sample": {
"data": {
"page": "1",
"items": [
{
"asin": "B0CTBCDD6D",
"image": "https://m.media-amazon.com/images/I/61EL2AKKcBL._AC_UY218_.jpg",
"price": "$59.95",
"title": "JBL Tune 720BT - Wireless Over-Ear Headphones",
"rating": "4.6 out of 5 stars"
}
]
},
"status": "success"
}
}About the amzn.to API
This API exposes 3 endpoints for retrieving Amazon product data: keyword search, individual product detail by ASIN, and category best sellers. The get_product_details endpoint accepts one or multiple comma-separated ASINs and returns up to six fields per product — including structured feature bullet points and full description — making it useful for programmatic comparison or catalog enrichment workflows.
Search and Discovery
The search_products endpoint accepts a query string (e.g., 'wireless headphones') and returns paginated results. Each item in the items array includes the product's asin, title, price, rating, and image URL. Pagination is controlled via the page parameter; the current page is reflected back as a string in the page field of the response.
Product Detail Lookups
The get_product_details endpoint is the most data-dense of the three. Pass a single ASIN or a comma-separated list (e.g., 'B08N5WRWNW,B07XJ8C8F5') to the asin parameter. The response returns a products array where each object includes asin, title, price, rating, description, and a features array of bullet points. This makes it straightforward to hydrate a product list returned from search with full editorial content in one call.
Best Sellers by Category
The get_best_sellers endpoint returns Amazon's current best-selling products. Supply a category slug such as 'electronics' or 'books' to scope the results; omitting the parameter returns the overall best sellers list. Each item in the items array carries asin, title, price, rating, and image. Because the list reflects current rankings, repeated polling can surface trending products over time.
Data Shape and Coverage
All three endpoints share a consistent product object structure built around the ASIN as the stable identifier. Price is returned as a string (matching Amazon's display format, which may include currency symbols and range notation). Ratings are included where available on the source listing. Seller-level data, inventory stock status, and customer review text are not part of the current response schema.
- Build a price-tracking tool that polls
search_productsfor specific keywords and logs price changes over time. - Enrich an affiliate product feed by batch-resolving ASINs through
get_product_detailsto pull titles, descriptions, and feature bullets. - Identify trending products in a category by periodically calling
get_best_sellerswith a category slug and diffing the ranked list. - Populate a comparison shopping page using the
featuresanddescriptionfields returned byget_product_detailsfor side-by-side display. - Validate product catalog metadata by cross-referencing stored titles and prices against live data from
get_product_details. - Build a category-level market research dashboard by aggregating
ratingandpricedata fromget_best_sellersacross multiple category slugs.
| 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?+
What does `get_product_details` return beyond what `search_products` gives?+
search_products returns a short set of fields — asin, title, price, rating, and image — suitable for listing views. get_product_details adds a description field (the full editorial product description) and a features array containing structured bullet points. It also accepts multiple ASINs in one call, so you can hydrate a batch of search results in a single request.Are customer reviews or review counts returned by any endpoint?+
rating values but do not expose individual review text, review counts, or review breakdowns by star level. You can fork this API on Parse and revise it to add a review-fetching endpoint targeting a specific ASIN.Does the API cover Amazon marketplaces outside the US?+
How does pagination work in `search_products`?+
page parameter to retrieve a specific results page. The response echoes back the current page number as a string in the page field. There is no total_pages or total_results field in the response, so iterating to find the last page requires checking whether the returned items array is empty.