Amazon APIamazon.eg ↗
Search Amazon Egypt (amazon.eg) products by keyword. Returns ASINs, prices, ratings, review counts, images, and autocomplete suggestions via 2 endpoints.
What is the Amazon API?
The Amazon Egypt API provides 2 endpoints to search product listings on amazon.eg and retrieve search autocomplete suggestions. The search_products endpoint returns up to a full page of results per request, with fields including ASIN, title, price, currency, rating, review count, image URL, product URL, and a sponsored flag. Pagination and four sort orders are supported out of the box.
curl -X GET 'https://api.parse.bot/scraper/6b1d4645-746f-42aa-a5ac-bf5f861d41f6/search_products?page=1&sort=price-asc-rank&query=laptop' \ -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-eg-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 Egypt API — search products and get autocomplete suggestions."""
from parse_apis.amazon_egypt_api import AmazonEg, Sort, ProductSearchFailed
client = AmazonEg()
# Get autocomplete suggestions for a partial keyword
suggestions = client.autocompletes.get(prefix="laptop")
print(f"Suggestions for '{suggestions.prefix}': {suggestions.suggestions[:5]}")
# Search products sorted by price ascending, capped at 5 results
for product in client.products.search(query="laptop", sort=Sort.PRICE_ASC, limit=5):
print(product.title, product.price, product.currency)
# Drill into one result with .first()
top = client.products.search(query="headphones", sort=Sort.REVIEW_RANK, limit=1).first()
if top:
print(top.asin, top.title, top.is_sponsored)
# Typed error handling around a search call
try:
for p in client.products.search(query="gaming mouse", limit=3):
print(p.asin, p.title, p.price)
except ProductSearchFailed as exc:
print(f"Search blocked: {exc}")
print("exercised: products.search / autocompletes.get / Sort enum / ProductSearchFailed error")
Full-text search over Amazon Egypt product listings by keyword. Returns products with ASIN, title, price, rating, review count, image, and URL. Supports pagination via page number and server-side sorting. Each page returns up to ~48 results depending on availability.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order for results |
| queryrequired | string | Search keyword |
{
"type": "object",
"fields": {
"page": "current page number",
"query": "search keyword used",
"products": "array of product objects",
"total_on_page": "number of products returned on this page"
},
"sample": {
"data": {
"page": 1,
"query": "laptop",
"products": [
{
"asin": "B0G42QP7MC",
"price": 41899,
"title": "ASUS TUF F16 [FX607VJB-RL165W] Intel Core 5-210H /16GB DDR5 /512GB SSD/RTX 3050 6GB DDR6 /FHD+ 144Hz 16-inch/Win 11/1 Year Perfect Warranty Pro",
"rating": "5.0",
"currency": "EGP",
"image_url": "https://m.media-amazon.com/images/I/71IlIIev6LL._AC_UL320_.jpg",
"product_url": "https://www.amazon.eg/-/en/ASUS-FX607VJB-RL165W-16-inch-Perfect-Warranty/dp/B0G42QP7MC/ref=sr_1_1",
"is_sponsored": false,
"review_count": 0
}
],
"total_on_page": 48
},
"status": "success"
}
}About the Amazon API
Endpoints
The API exposes two endpoints. search_products accepts a required query string and returns an array of product objects under the products field. Each object carries asin, title, price, currency, rating, review_count, image_url, product_url, and is_sponsored. The response also includes page, query, and total_on_page so you can track pagination state. get_search_autocomplete accepts a prefix string and returns up to 10 suggested search terms in a suggestions array alongside the original prefix.
Sorting and Pagination
search_products supports an optional sort parameter with four accepted values: price-asc-rank (lowest price first), price-desc-rank (highest price first), review-rank (top reviewed), and date-desc-rank (newest arrivals). Pagination is controlled via the page integer parameter. If omitted, the first page is returned by default.
Coverage and Scope
This API is scoped specifically to amazon.eg, the Egyptian Amazon storefront. Prices are returned with a currency field reflecting the local Egyptian Pound denomination. Sponsored product status is surfaced per listing via the is_sponsored boolean, which is useful for filtering organic results from paid placements in any analysis pipeline.
The Amazon API is a managed, monitored endpoint for amazon.eg — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.eg 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.eg 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 changes on amazon.eg product listings by polling
search_productswith a fixedqueryand comparing returnedpricevalues over time. - Build a product comparison tool that surfaces
ratingandreview_countfor competing items in the Egyptian market. - Power a search-as-you-type input in a shopping app using
get_search_autocompletewith a user's partialprefix. - Identify sponsored vs. organic product placement by filtering results on the
is_sponsoredfield fromsearch_products. - Aggregate bestseller data by sorting with
review-rankand extractingasin,title, andimage_urlfor category listings. - Seed a product catalog with Egyptian market ASINs, titles, and image URLs returned by
search_products. - Analyze pricing distribution across a keyword category by sorting with
price-asc-rankandprice-desc-rankon successive requests.
| 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 Egypt have an official developer API?+
What does `search_products` return for each product, and can I filter by category?+
asin, title, price, currency, rating, review_count, image_url, product_url, and is_sponsored. Category filtering is not a supported parameter — the endpoint accepts query, page, and sort. You can narrow results by including a category term directly in your query string as a workaround.Does the API return seller information, product descriptions, or variant details?+
How many autocomplete suggestions does `get_search_autocomplete` return, and are they ranked?+
suggestions array. The suggestions reflect the same ordering Amazon Egypt surfaces for the given prefix, but no explicit rank score field is included in the response.Is it possible to retrieve customer reviews or Q&A content through this API?+
rating (aggregate star score) and review_count from search listings, but individual review text, reviewer profiles, and Q&A threads are not exposed. You can fork this API on Parse and revise it to add a reviews endpoint targeting a specific ASIN.