noon APInoon.com ↗
Search noon.com's UAE catalog by keyword or barcode, retrieve full product details including GTIN, pricing in AED, specs, and ratings via 3 JSON endpoints.
What is the noon API?
The noon.com API exposes 3 endpoints covering product search, barcode lookup, and full product detail retrieval from noon's UAE catalog. The search_products endpoint accepts free-text queries or EAN/UPC barcodes and returns paginated results with SKUs, brand names, prices, sale prices, and bestseller flags. The get_product endpoint delivers per-SKU detail including GTIN, ratings, images, and full descriptions.
curl -X GET 'https://api.parse.bot/scraper/9f57a191-3afe-468c-8aec-d2fbc3d2e689/search_products?page=1&query=milk' \ -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 noon-com-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: noon.com SDK — bounded, re-runnable; every call capped."""
from parse_apis.Noon_com_Product_API import Noon, ProductNotFound
client = Noon()
# Search products by keyword — limit caps total items fetched.
for item in client.product_summaries.search(query="milk", limit=3):
print(item.name, item.brand, item.price)
# Barcode/EAN search — searches grocery store first, falls back to full catalog.
for item in client.product_summaries.barcode_search(barcode="6281007032810", limit=2):
print(item.name, item.sku, item.brand)
# Drill-down: take one search hit and navigate to full details via .details().
hit = client.product_summaries.search(query="samsung galaxy buds", limit=1).first()
if hit:
try:
full = hit.details()
print(full.name, full.brand, full.model_number, full.price)
except ProductNotFound as e:
print(f"not found: {e.sku}")
print("exercised: product_summaries.search / product_summaries.barcode_search / ProductSummary.details")
Full-text and barcode search across noon.com's product catalog. Accepts any search query including product names, keywords, or barcode/EAN numbers. Returns a paginated list of matching products with pricing, brand, and image data. Results are ordered by noon's relevance algorithm.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search query — free text (product name, keywords) or numeric barcode/EAN to search by barcode. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"products": "array of product summaries with sku, brand, name, price, sale_price, url_slug, image_url, offer_code, is_bestseller",
"total_results": "integer total number of matching products"
},
"sample": {
"data": {
"page": 1,
"products": [
{
"sku": "N12278276A",
"name": "Long Life Milk Full Fat Plain 1Liters Pack of 4",
"brand": "Almarai",
"price": 30.73,
"url_slug": "long-life-milk-full-fat-plain-1liters-pack-of-4",
"image_url": "https://f.nooncdn.com/p/pnsku/N12278276A/45/_/1699186637/57a419d1-6837-4cdd-917e-241aa8c1be7f.jpg",
"offer_code": "d1964f03cb697c3d",
"sale_price": 22.6,
"is_bestseller": false
}
],
"total_results": 1922
},
"status": "success"
}
}About the noon API
Search and Barcode Lookup
The search_products endpoint accepts a query string — either free text (product name, brand, keywords) or a numeric barcode/EAN — and returns a paginated list of matches. Each item in the products array includes the noon sku, brand, name, price, sale_price, url_slug, image_url, offer_code, and an is_bestseller flag. Pagination is handled via the page integer parameter, and total_results tells you how many records the query matched in total.
Grocery-Specific Barcode Search
The search_grocery_by_barcode endpoint is purpose-built for the noon grocery store. It accepts a barcode string in EAN-8, EAN-13, UPC-A, or GTIN-14 format and first searches within the grocery category. If no grocery-category match is found, it automatically falls back to the full noon catalog. The response shape is identical to search_products: a paginated array of product summaries with pricing and image data.
Full Product Detail
Once you have a SKU from either search endpoint, pass it to get_product to retrieve the complete record. The response includes the canonical url, gtin (barcode/EAN when noon holds it, null otherwise), name, brand, price and currency (AED), an images array, average rating on a 1–5 scale, and the full description text. SKUs follow noon's format such as N12278276A or the longer alphanumeric style Z3E4E64CF19A1C522FFE0Z.
Coverage and Region
All data reflects noon's UAE storefront (uae-en locale). Prices are denominated in AED. Product availability, pricing, and catalog depth correspond to what noon lists on that regional storefront at the time of the request.
The noon API is a managed, monitored endpoint for noon.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when noon.com 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 noon.com 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?+
- Match a retail barcode (EAN-13) to a noon listing to compare AED shelf price against a competitor price.
- Build a grocery price tracker by polling
search_grocery_by_barcodewith a list of product GTINs and recordingpriceandsale_priceover time. - Enrich an internal product database with noon's
gtin,brand, anddescriptionfields by feeding SKUs intoget_product. - Identify bestseller status in a product category by checking the
is_bestsellerflag across paginatedsearch_productsresults. - Automate catalog audits by searching brand names via
search_productsand aggregating all matching SKUs, prices, and ratings. - Feed a price-comparison widget with noon AED prices and product images pulled from the
imagesarray returned byget_product. - Cross-reference UPC-A barcodes from a physical inventory scan against noon's grocery catalog to find online equivalents and current sale prices.
| 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 noon.com offer an official developer API?+
What does `get_product` return for the barcode field, and when is it null?+
gtin field in the get_product response contains the product's barcode or EAN when noon's catalog record includes it. When noon does not store a GTIN for a given SKU, the field returns null. There is no fallback or secondary barcode field — gtin is the only barcode-related field in that response.Does the grocery barcode endpoint search outside the UAE storefront or cover noon's Saudi Arabia and Egypt catalogs?+
Are seller information, reviews, or stock availability returned by any endpoint?+
How does pagination work across the search endpoints?+
search_products and search_grocery_by_barcode accept an optional integer page parameter. The response always includes total_results so you can calculate how many pages exist. If page is omitted, the first page of results is returned. Page size is fixed by noon's catalog response and is not a configurable parameter.