lotuss.com.my APIwww.lotuss.com.my ↗
Fetch product names, prices, discounts, categories, and images from Lotus's Malaysia promotional pages via one structured API endpoint.
curl -X GET 'https://api.parse.bot/scraper/7e4ff86c-8b57-45db-969f-17ca1b7035d4/get_promotional_products' \ -H 'X-API-Key: $PARSE_API_KEY'
Get products from a Lotus's Malaysia promotional or category page. Returns product names, promotional prices, regular prices, discount percentages, categories, brands, and product images. Results are paginated.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (starts at 1). |
| sort | string | Sort order for results. Accepts exactly one of: best_match, price_low, price_high, newest. Omitted = default server ordering. |
| limit | integer | Number of products per page, between 1 and 100. |
| category_id | string | Category ID for the promotional page. Default is 60725 (June Super Weekend Treats). Other category IDs can be found by browsing the site. |
{
"type": "object",
"fields": {
"products": "array of product objects with id, sku, name, regular_price, promotional_price, discount_percent, currency, category, image_url, stock_status, brand",
"pagination": "object with page, limit, total_products, total_pages"
},
"sample": {
"products": [
{
"id": 38855,
"sku": "72229187",
"name": "KARA COCONUT CREAM 500ML",
"brand": "KARA",
"category": "Sprinkles, Syrup & Other Ingredients",
"currency": "MYR",
"image_url": "https://publish-p35803-e190640.adobeaemcloud.com/content/dam/aem-cplotusonlinecommerce-project/my/images/magento/catalog/product/083/9555079300083/ShotType1_540x540.jpg",
"stock_status": "IN_STOCK",
"regular_price": 8.45,
"discount_percent": 11.83,
"promotional_price": 7.45
}
],
"pagination": {
"page": 1,
"limit": 5,
"total_pages": 33,
"total_products": 164
}
}
}About the lotuss.com.my API
The Lotus's Malaysia API exposes one endpoint — get_promotional_products — that returns up to 10 fields per product from Lotus's promotional and category pages, including regular price, promotional price, discount percentage, SKU, brand, category, and image URL. Results are paginated and sortable, making it straightforward to pull structured product data from any Lotus's Malaysia campaign or category page.
What the API Returns
The get_promotional_products endpoint returns an array of product objects from a Lotus's Malaysia promotional or category page. Each object includes id, sku, name, regular_price, promotional_price, discount_percent, currency, category, image_url, and a stock status field. Prices are returned in Malaysian Ringgit (MYR). A pagination object accompanies every response, reporting the current page, limit, total_products, and total_pages.
Filtering and Pagination
The endpoint accepts a category_id parameter to target specific promotional or category pages — the default is 60725 (June Super Weekend Treats), but other valid category IDs can be passed to retrieve different campaigns. Page navigation is handled via the page integer parameter starting at 1, and you can control response size with limit (1–100 products per page). The sort parameter accepts best_match, price_low, price_high, or newest to control result ordering.
Coverage and Freshness
Data reflects the current live state of Lotus's Malaysia promotional pages at the time of the request. The API covers promotional pricing events and standard category pages accessible without a login on lotuss.com.my. Product-level data such as nutritional info, stock quantity counts, and customer reviews are not part of the response — only the core pricing, identity, and categorisation fields listed above.
- Track promotional price changes over time for specific Lotus's Malaysia product SKUs
- Build a grocery price comparison tool using
promotional_priceandregular_pricefields - Monitor discount depth across categories by aggregating
discount_percentvalues - Populate a deal-alert service with new promotional products as campaigns launch
- Extract product images via
image_urlto build a visual catalogue of Lotus's Malaysia offers - Analyse which product categories appear most frequently in Lotus's Malaysia promotions
- Calculate average savings across a promotional page using
regular_priceandpromotional_price
| 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 Lotus's Malaysia have an official developer API?+
What does `get_promotional_products` return beyond price fields?+
id, sku, name, regular_price, promotional_price, discount_percent, currency (MYR), category, image_url, and a stock status field. The pagination object tells you the current page, limit, total products, and total pages across the result set.How do I retrieve products from a different Lotus's Malaysia category or campaign?+
category_id string parameter to the get_promotional_products endpoint. The default value targets the June Super Weekend Treats page (ID 60725), but any valid Lotus's Malaysia category or promotional page ID can be substituted.