LuLu Hypermarket APIgcc.luluhypermarket.com ↗
Access LuLu Hypermarket's GCC product catalog via API. Search products, browse categories, filter by brand, and retrieve barcodes, pricing, and images.
What is the LuLu Hypermarket API?
This API gives programmatic access to LuLu Hypermarket's GCC online store across 6 endpoints covering product search, category browsing, brand filtering, and barcode lookup. The get_product_details endpoint returns full product data including EAN/UPC barcodes, image arrays, variants, and bullet-point descriptions, while search_products supports paginated keyword queries returning up to 20 results per page with total count and page metadata.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/cb33e3a2-a3b4-4a22-b7aa-a70c531bc148/get_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all top-level categories available on the site. Category slugs can be used with get_products_by_category to browse products.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects with name, slug, url, and pk"
},
"sample": {
"data": {
"categories": [
{
"pk": "b6ca8df6-eadb-4142-9169-8112f06264c0",
"url": "/grocery/",
"name": "Grocery",
"slug": "grocery"
},
{
"pk": "09a53440-e63e-4ecd-acd2-8203fb57cb51",
"url": "/fresh-food/",
"name": "Fresh Food",
"slug": "fresh-food"
},
{
"pk": "64918a05-0edb-46de-bcb0-4c91a26fc4c9",
"url": "/electronics/",
"name": "Electronics",
"slug": "electronics"
}
]
},
"status": "success"
}
}About the LuLu Hypermarket API
Browsing Categories and Products
get_categories returns all top-level categories as an array of objects, each with a name, slug, url, and pk. Those slugs feed directly into get_products_by_category, which accepts a category_slug parameter. Top-level slugs like grocery or fresh-food return featured products without pagination. Subcategory slugs — for example grocery-food-cupboard or fresh-food-dairy-eggs-cheese — support paginated results via the page parameter, with the response including num_pages and total_count fields. Each product object in the list carries pk, sku, name, brand, price, original_price, discount, currency, weight, category, subcategory, and a direct url.
Product Details and Barcode Lookup
get_product_details takes a product pk and returns the full record: description, images array, bullet_points, variants, and a barcode field containing the primary EAN/UPC as listed by the site. That barcode value can then be passed to get_product_by_barcode, which resolves the barcode to a single product and returns the same full detail payload plus matched_barcode and other_matches fields — useful for cross-referencing products by their physical barcode. Unknown PKs return a structured not-found error.
Search and Brand Filtering
search_products accepts a query string (e.g. milk, rice, chocolate) and an optional page integer, returning up to 20 matching products per page along with num_pages and total_count. get_products_by_brand works similarly but filters by a brand string such as Almarai or Nestle, also paging at 20 products per page. Both endpoints return the same product array shape as the category endpoint, making it straightforward to unify results across access patterns.
Coverage Notes
All endpoints reflect LuLu's GCC storefront at gcc.luluhypermarket.com. Pricing, discounts, and availability reflect the UAE-facing catalog. The original_price and discount fields let you compute promotional savings directly from the response without additional processing.
The LuLu Hypermarket API is a managed, monitored endpoint for gcc.luluhypermarket.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when gcc.luluhypermarket.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 gcc.luluhypermarket.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?+
- Building a grocery price tracker that monitors
priceandoriginal_pricechanges across LuLu SKUs over time - Cross-referencing physical product barcodes against LuLu's catalog using
get_product_by_barcodefor inventory matching - Aggregating GCC supermarket product data by brand using
get_products_by_brandwith brand names like Almarai or Nestlé - Populating a category-navigation UI by pulling slugs from
get_categoriesand fetching products withget_products_by_category - Comparing discount depth using the
discountandoriginal_pricefields returned on product list and detail endpoints - Feeding a product image gallery by collecting the
imagesarray fromget_product_detailsfor a given PK - Building a search autocomplete or results page backed by
search_productswith keyword queries and paginated responses
| 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 LuLu Hypermarket offer an official developer API?+
What does `get_product_by_barcode` return, and how does it differ from `get_product_details`?+
get_product_by_barcode accepts an EAN/UPC string of 8–14 digits and returns the same full product payload as get_product_details — including name, brand, price, images, variants, and barcode — but also adds matched_barcode (the barcode that resolved) and other_matches (any additional products associated with that barcode). It is the right endpoint when you have a physical barcode and need to identify the corresponding LuLu listing.How does pagination work for `get_products_by_category`?+
page parameter is only effective for subcategory slugs (e.g. grocery-food-cupboard). Top-level category slugs like grocery return a featured product set without pagination, and num_pages and total_count will be null in those responses. Subcategory pages return up to 50 products per page.