Amazon APIamazon.eg ↗
Search Amazon Egypt listings, get autocomplete suggestions, and retrieve full product details including price, images, variations, and offers via a simple REST API.
What is the Amazon API?
The Amazon Egypt API provides 3 endpoints to search product listings on amazon.eg, fetch typeahead suggestions, and pull full product details by ASIN. The search_products endpoint returns up to 48 results per page with fields including ASIN, title, price in EGP, star rating, review count, and image URLs. The get_product_details endpoint goes deeper, exposing feature bullets, seller offers, fulfillment info, and available size or color variations.
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'
Full-text search over Amazon Egypt product listings by keyword. Returns one row per product listing on the requested results page with ASIN, title, current price, original (pre-discount) list price, discount percentage, rating, review count, image, URL and a sponsored flag. Supports pagination via the page number (omitted means page 1; one upstream request per page) and server-side sorting. Each page returns up to ~60 results depending on availability. price is the current offer price as a number in EGP, or null when the listing shows no price. original_price is the strike-through 'Was'/'List' price shown before a discount, as a number in EGP; it is null for listings that are not discounted. discount_percent is an integer percentage computed as (original_price - price) / original_price, rounded to the nearest whole percent; the listing itself does not display a percentage figure, so this is a derived value, and it is null whenever original_price is null or not higher than price. rating is the average star rating as a string or null when the listing has no ratings. review_count is the listing's displayed rating count as an integer (abbreviated counts such as 2.5K are expanded; 0 when none is shown).
| 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: asin, title, price (current price number or null), original_price (pre-discount list price number, null when not discounted), discount_percent (integer percent computed from price and original_price, null when not discounted), currency, rating (string or null), review_count (integer), image_url, product_url, is_sponsored",
"total_on_page": "number of products returned on this page"
},
"sample": {
"data": {
"page": 1,
"query": "shoes",
"products": [
{
"asin": "B0FVYKJKM7",
"price": 379,
"title": "Testa Toro M1 Men’S Suede Sneaker With Memory Foam – Lightweight & Stylish Everyday Shoe",
"rating": "3.6",
"currency": "EGP",
"image_url": "https://m.media-amazon.com/images/I/61lK-n9aWbL._AC_UL320_.jpg",
"product_url": "https://www.amazon.eg/-/en/Testa-M1-Suede-Sneaker-Memory/dp/B0FVYKJKM7/ref=sr_1_1",
"is_sponsored": false,
"review_count": 16,
"original_price": 419,
"discount_percent": 10
},
{
"asin": "B0HBLT4S3B",
"price": 650,
"title": "Men's Chunky Lace-Up Oxford Shoes AK27",
"rating": null,
"currency": "EGP",
"image_url": "https://m.media-amazon.com/images/I/51bmEYO8S1L._AC_UL320_.jpg",
"product_url": "https://www.amazon.eg/-/en/Now-Shoes-Chunky-Lace-Up-Oxford/dp/B0HBLT4S3B/ref=sr_1_16",
"is_sponsored": false,
"review_count": 0,
"original_price": null,
"discount_percent": null
}
],
"total_on_page": 48
},
"status": "success"
}
}About the Amazon API
Search and Autocomplete
The search_products endpoint accepts a required query string and returns a paginated list of product objects. Each object includes asin, title, price, rating, review_count, image, and a direct product url. Use the page integer param to walk through result pages (up to ~48 items each) and the sort param to control server-side ordering — useful for price-descending or relevance-ranked feeds. The response also echoes back query and total_on_page so you can detect sparse pages.
The get_search_autocomplete endpoint accepts a prefix string and returns up to 10 suggested search terms drawn from Amazon Egypt's typeahead data. This is well-suited for building search-as-you-type UIs or for exploring what queries are popular in the Egyptian market before running a full search_products call.
Product Detail
The get_product_details endpoint accepts a single asin — typically sourced from search_products results — and returns the full product record. Fields cover title, brand, description, price, currency (EGP), rating, images (array of high-res URLs), availability, and an offers array. Each offer object includes price, currency, condition, seller_name, fulfilled_by, and shipping details, making it straightforward to compare third-party sellers against the main listing. The variations array maps dimension names (color, size, etc.) to their corresponding ASINs, enabling recursive detail lookups for variant products.
Coverage and Data Shape
All data is scoped to amazon.eg — pricing is in Egyptian Pounds (EGP) and inventory reflects what is listed in the Egyptian storefront. The ASIN is the stable identifier across all three endpoints: discover it via search_products, expand it via get_product_details, and follow variation ASINs from the variations array. Fields like brand, price, and description can return null when the source listing omits them.
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 for specific ASINs on Amazon Egypt using periodic
get_product_detailscalls - Build a search-as-you-type product finder using
get_search_autocompleteprefix suggestions - Aggregate seller offer data from the
offersarray to compare third-party prices and fulfillment options - Enumerate color and size variants by following ASINs from the
variationsarray - Seed a product catalog with titles, images, and feature bullets scraped via
search_products+get_product_details - Research popular search queries in the Egyptian market using
get_search_autocompleteon broad prefixes - Monitor product availability and review counts across Amazon Egypt categories using keyword pagination
| 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 Egypt have an official developer API?+
What does the `offers` array in `get_product_details` contain?+
offers array includes price, currency, condition (e.g. new or used), seller_name, fulfilled_by (e.g. Amazon or third-party), and shipping information. This lets you see all available purchase options for an ASIN, not just the Buy Box winner.Does `search_products` return all pages of results, or is there a practical limit?+
page integer param. Amazon Egypt typically surfaces several pages of results per query, but the actual depth varies by keyword. When total_on_page is less than expected, you have likely reached the last page of available results.Does the API return customer review text or Q&A content?+
rating and review_count values from get_product_details, but individual review bodies, review titles, and the Q&A section are not included. You can fork this API on Parse and revise it to add an endpoint that fetches per-review data for a given ASIN.Can I retrieve seller profile pages or storefront listings for a specific Amazon Egypt seller?+
seller_name and fulfilled_by within offer objects, but there is no endpoint for browsing a seller's full storefront or profile. You can fork this API on Parse and revise it to add a seller-listings endpoint that accepts a seller ID.