Amazon APIamazon.ae ↗
Search Amazon.ae products, fetch full product details by ASIN or barcode, browse best sellers by category, and retrieve today's active deals via a single API.
What is the Amazon API?
The Amazon.ae API exposes 5 endpoints covering product search, detail lookup, best sellers, deals, and barcode search across the UAE's Amazon storefront. The get_product_details endpoint returns up to 8 structured fields per listing — including brand, model, barcode (EAN/UPC), and a full technical specifications map — for any product identified by ASIN or URL. Price filters, sort order, and grocery department scoping are available on search endpoints.
curl -X GET 'https://api.parse.bot/scraper/a2b1d25a-cafc-451c-bce2-c2e49c7767ac/search_products?page=1&sort=price-desc-rank&query=laptop&grocery=false&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.
"""Walkthrough: Amazon.ae SDK — barcode search, product details, best sellers, deals."""
from parse_apis.Amazon_ae_API import AmazonAE, Sort, ProductNotFound
client = AmazonAE()
# Search for a product by its EAN/UPC barcode.
for result in client.barcode_results.search(barcode="8000500217078", limit=3):
print(result.title, result.price, result.brand, result.model)
# Search products by keyword, sorted by price.
for item in client.product_summaries.search(query="laptop", sort=Sort.PRICE_DESC, limit=3):
print(item.title, item.price, item.rating)
# Drill into a search result for full specs and barcode.
summary = client.product_summaries.search(query="wireless earbuds", limit=1).first()
if summary:
product = summary.details()
print(product.title, product.brand, product.barcode, product.weight)
# Browse electronics best sellers.
for seller in client.best_sellers.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: barcode_results.search, product_summaries.search, summary.details, best_sellers.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, sort-order control, and grocery department scoping. 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'). |
| grocery | boolean | When true, restricts search results to the Amazon.ae grocery department. |
| 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
Product Search and Filtering
The search_products endpoint accepts a required query string and returns up to ~48 products per page, each with asin, title, price, rating, image_url, and url. Results can be narrowed by min_price and max_price in AED, sorted via the sort parameter, and scoped to the grocery department with the grocery boolean flag. Pagination uses a 1-based integer page counter.
Product Detail and Barcode Lookup
get_product_details accepts either an asin (10-character alphanumeric) or a full Amazon.ae product URL containing a /dp/ or /gp/product/ path. The response includes brand, model, weight, price, barcode (EAN or UPC when listed on the product page, otherwise 'N/A'), and a specs object containing all key-value technical specifications from the listing. The search_by_barcode endpoint works in the reverse direction: it takes an EAN/UPC barcode (8–14 digits) and returns matching products with asin, title, price, brand, barcode, and url. Barcode searches typically surface 1–5 results and also support grocery scoping.
Best Sellers and Today's Deals
get_best_sellers returns the top 30 ranked products for a given category slug — for example 'electronics', 'books', or 'fashion' — with each item's rank, asin, title, and price. get_todays_deals requires no inputs and reflects whatever promotions are currently active on the Amazon.ae Today's Deals page, returning asin, title, and price for each deal. Deal content changes daily.
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?+
- Track price movements on specific ASINs over time using
get_product_detailsand itspricefield - Build a UAE grocery price comparison tool using
search_productswithgrocery: trueand AED price filters - Identify best-selling electronics or books in the UAE market via
get_best_sellerswith category slugs - Look up product metadata (brand, model, EAN barcode) from a physical product scan using
search_by_barcode - Monitor daily promotions and discount windows by polling
get_todays_dealseach morning - Enrich an existing product catalog with technical specs using the
specsmap fromget_product_details - Cross-reference product ASINs between Amazon.ae and other Amazon storefronts using shared ASIN identifiers
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Amazon.ae have an official developer API?+
What does `get_product_details` return for the `specs` field?+
specs field is a key-value object containing all technical specification entries from the product listing — things like screen resolution, battery capacity, material composition, connectivity standards, or dimensions, depending on the product category. The exact keys vary per listing. The barcode field is pulled from these specs and returned as a top-level string; it is 'N/A' when not listed on the page.Does the API return customer reviews or seller information?+
search_products endpoint returns a rating value per product, and get_product_details returns structured listing metadata, but individual customer reviews, review counts, and third-party seller details are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting review data.How does pagination work for `search_products` and how many results are available?+
page parameter (1-based). Each page returns approximately 48 products alongside a count field reflecting results on that page. The number of available pages depends on the query and Amazon.ae's own result set; not all queries will have multiple pages, and very specific queries may return fewer than 48 results on page 1.Can I retrieve product images or variation data beyond the main listing?+
search_products endpoint returns one image_url per product. Product variations (size, color, configuration options) and additional image galleries are not currently returned by any endpoint. The API covers the primary listing image and core metadata fields. You can fork it on Parse and revise to add a variation or image gallery endpoint.