gcc.luluhypermarket.com APIgcc.luluhypermarket.com ↗
Access LuLu Hypermarket product data for the GCC region: search, categories, brand filtering, lifestyle tags, and full product details via 7 endpoints.
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 gcc.luluhypermarket.com API
This API exposes 7 endpoints covering LuLu Hypermarket's GCC storefront, returning product listings, category trees, brand-filtered results, lifestyle-tagged items, and trending searches. The get_product_details endpoint returns fields including pk, sku, name, brand, price, images array, weight, and category for any product by its internal ID. Combined with search_products and get_products_by_category, it covers the core catalogue browsing and lookup surface of gcc.luluhypermarket.com.
Category and Product Browsing
get_categories returns an array of top-level category objects — each with a name, slug, url, and pk. Those slugs feed directly into get_products_by_category, which accepts a category_slug and an optional page integer. Top-level slugs like grocery or fresh-food return featured products without pagination (num_pages and total_count are null). Subcategory slugs such as grocery-food-cupboard or fresh-food-dairy-eggs-cheese support paginated results with up to 50 products per page, and the response includes num_pages and total_count.
Search, Brand, and Lifestyle Filtering
search_products takes a query string and an optional page, returning up to 20 products per page alongside num_pages and total_count. get_products_by_brand accepts a brand string (e.g. Almarai, Nestle) and pages through up to 20 results per page. get_products_by_lifestyle filters by lifestyle tags such as organic, vegan, or gluten_free, also paginating at 20 per page. All three endpoints return product objects with the same shape: pk, sku, name, brand, price, original_price, discount, currency, weight, category, subcategory, and url.
Product Detail and Trending Signals
get_product_details accepts a product pk and returns extended fields not available in list endpoints: a description, images array, bullet points, and variant information alongside the standard pricing and category fields. get_trending_searches requires no inputs and returns a trending array of strings reflecting current popular search terms on the site — useful for demand monitoring or search suggestion features.
- Track price and discount changes across LuLu GCC product categories for competitive price monitoring.
- Build a grocery search interface using
search_productswith keyword queries and pagination. - Filter and list all products tagged
veganorgluten_freeviaget_products_by_lifestylefor dietary apps. - Aggregate product SKUs and images by brand using
get_products_by_brandfor catalogue management. - Monitor
get_trending_searchesto identify rising product demand in the GCC market. - Extract full product descriptions and image arrays with
get_product_detailsfor content syndication. - Map the complete category tree using
get_categoriesslugs to build a structured grocery taxonomy.
| 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 | 250 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 LuLu Hypermarket offer an official public developer API?+
What does `get_products_by_category` return differently for top-level vs. subcategory slugs?+
grocery, fresh-food) return featured products but do not support pagination — num_pages and total_count are null in those responses. Subcategory slugs (e.g. fresh-food-dairy-eggs-cheese) return up to 50 products per page with valid num_pages and total_count values.