Amazon APIamazon.ae ↗
Search Amazon.ae products, get detailed specs by ASIN, browse category best sellers, and fetch today's deals — all via a single structured API.
What is the Amazon API?
The Amazon.ae API provides 4 endpoints to query products, retrieve technical specifications, and monitor deals on the UAE storefront. Use search_products to find items by keyword with price range and sort filters, returning up to 50–60 results per page with ASIN, title, price in AED, rating, and image URL. Other endpoints cover per-product detail, category best sellers, and today's live deals.
curl -X GET 'https://api.parse.bot/scraper/a2b1d25a-cafc-451c-bce2-c2e49c7767ac/search_products?page=1&sort=price-desc-rank&query=laptop&max_price=5000&min_price=100' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace amazon-ae-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Amazon.ae SDK — search, detail drill-down, best sellers, and deals."""
from parse_apis.amazon_ae_api import AmazonAE, Sort, ProductNotFound
client = AmazonAE()
# Search for budget laptops sorted by price, capped at 5 results.
for item in client.productsummaries.search(query="laptop", sort=Sort.PRICE_ASC, max_price="2000", limit=5):
print(item.title, item.price, item.rating)
# Drill into the first search result for full specs.
summary = client.productsummaries.search(query="wireless earbuds", limit=1).first()
if summary:
product = summary.details()
print(product.title, product.brand, product.model, product.weight)
# Browse electronics best sellers.
for seller in client.bestsellers.list(category="electronics", limit=3):
print(seller.rank, seller.title, seller.price)
# Check today's deals.
deal = client.deals.list(limit=1).first()
if deal:
full = deal.details()
print(full.title, full.price, full.specs)
# Typed error handling for a direct product lookup.
try:
product = client.products.get(asin="B0BTYCRJSS")
print(product.title, product.price)
except ProductNotFound as exc:
print(f"Product not found: {exc.asin}")
print("Exercised: productsummaries.search, summary.details, bestsellers.list, deals.list, deal.details, products.get")
Full-text search over Amazon.ae product listings. Returns paginated results (~48 products per page) with title, price, rating, and image. Supports price-range filtering and sort-order control. Pagination via integer page counter.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| sort | string | Sort order for results. |
| queryrequired | string | Search keyword (e.g. 'laptop', 'wireless earbuds'). |
| max_price | string | Maximum price filter in AED (e.g. '2000'). |
| min_price | string | Minimum price filter in AED (e.g. '200'). |
{
"type": "object",
"fields": {
"count": "integer total number of products returned on this page",
"products": "array of product objects with asin, title, price, rating, image_url, and url"
},
"sample": {
"data": {
"count": 48,
"products": [
{
"url": "https://www.amazon.ae/dp/B08LDY37P7",
"asin": "B08LDY37P7",
"price": "AED 555.00",
"title": "Dell Latest_ Latitude 7390 13.3 FHD Display Laptop",
"rating": "3.9 out of 5 stars",
"image_url": "https://m.media-amazon.com/images/I/61X-vd8mCmL._AC_UL320_.jpg"
}
]
},
"status": "success"
}
}About the Amazon API
Endpoints and Response Data
The search_products endpoint accepts a required query string plus optional min_price, max_price (both in AED), sort (e.g. price-asc-rank, review-rank, date-desc-rank), and page parameters. Each page returns up to 50–60 product objects containing asin, title, price, rating, image_url, and url. This makes it straightforward to build keyword-driven product searches or price-filtered catalogs targeting the UAE market.
Product Details
get_product_details accepts either a 10-character asin or a full Amazon.ae product URL (containing /dp/ or /gp/product/). The response includes title, brand, model, price (in AED), weight, and a specs object of key-value technical specification pairs — useful for structured comparison across products or populating a product database with manufacturer data.
Best Sellers and Deals
get_best_sellers takes an optional category slug (e.g. electronics, books, fashion) and returns a ranked list of up to 30 products with rank, asin, title, and price. get_todays_deals requires no inputs and returns a deals array with asin, title, and price for every active deal found on the Today's Deals page, along with a total count. Both endpoints are useful for tracking promotional pricing and category rankings over time.
The Amazon API is a managed, monitored endpoint for amazon.ae — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.ae changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official amazon.ae API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor daily price changes for specific ASINs on the Amazon.ae UAE storefront.
- Build a deal-alert tool using
get_todays_dealsto flag discounted products by category. - Populate a product comparison table with brand, model, weight, and technical specs via
get_product_details. - Track category-level best seller rankings over time using
get_best_sellerswith electronics or books slugs. - Filter keyword search results by AED price range to surface budget options in a niche segment.
- Aggregate product listings sorted by review rank to identify top-rated items in any category.
- Seed a product catalog database with structured ASIN, title, and pricing data from Amazon.ae.
| 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 | 100 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 the price?+
brand, model, weight, and a specs object containing key-value technical specification pairs as listed by the seller. The depth of specs varies by product category — electronics tend to have more fields than consumables.Does `search_products` return reviews or seller information?+
rating field but not individual review text, review count, or seller names. The API covers keyword search with price and sort filters. You can fork it on Parse and revise to add a reviews endpoint pulling per-product review data.Are product images included in the search results?+
search_products results includes an image_url field. get_product_details and get_best_sellers do not currently return image URLs. You can fork it on Parse and revise those endpoints to include image data.How does pagination work for `search_products`?+
page string parameter to retrieve subsequent result pages. Each page returns up to 50–60 products. The response includes a count field reflecting the number of products on the current page, not the total result set size across all pages.