# Shopee Flash Sale Scraper (`xtracto/shopee-flash-sale`) Actor Scrape the current active Shopee flash sale session. Extracts product IDs and optionally enriches with full name, price, discount percentage, and seller info. Supported countries: Indonesia (ID), Thailand (TH), Vietnam (VN). - **URL**: https://apify.com/xtracto/shopee-flash-sale.md - **Developed by:** [xtractoo](https://apify.com/xtracto) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Shopee Flash Sale Scraper Scrape the current active Shopee flash sale session — extracts product IDs and enriches each with name, price, discount percentage, brand, images, and seller info. ### Why use this actor - **Real-time flash sale data** — captures the current active session as it runs - **Full product detail** — name, price, discount %, brand, image gallery, seller metrics - **No account or login required** - **Stable JSON output** ready for price monitoring or deal-tracking pipelines > **Supported countries**: Indonesia (ID), Thailand (TH), Vietnam (VN). Other countries (SG, MY, PH, etc.) do not expose flash sale products via the SEO layer — this is a confirmed server-side limitation, not a geographic block. ### How it works 1. You provide a country code (`id`, `th`, or `vn`). 2. The actor fetches the Shopee flash sale page for the current active session. 3. Product IDs (11–16 per session) are extracted from the page. 4. With `fetchDetail: true` (recommended), each product is enriched with full name, price, discount, images, and seller info. 5. Results stream into your dataset. > Flash sale sessions rotate every few hours (00:00, 06:00, 12:00, 15:00, 18:00, 21:00 local time). Run the actor at session start for the freshest products. ### Input ```json { "country": "th", "maxProducts": 20, "fetchDetail": true, "delay": 1.0 } ```` | Field | Type | Description | |---|---|---| | `country` | string | `id` (default), `th`, or `vn`. Other countries are not supported. | | `maxProducts` | integer | Max products to process. Default: 20. The page typically has 11–16 products. | | `fetchDetail` | boolean | **Recommended.** Fetch full product data. Without this, only `shop_id` and `item_id` are returned. Default: `true`. | | `delay` | number | Seconds between detail requests. Default: 1.0. | ### Output ```json { "shop_id": 59860978, "item_id": 3885759790, "title": "[ขายยกลังx2]โฟร์โมสต์ โอเมก้า สมาร์ท โกลด์ 1 พลัส รสจืด 180มล (24กล่อง/ลัง)Foremost Omega Smart Gold 1 Plus Plain180ml", "currency": "THB", "description": "[ขายยกลังx2] โฟร์โมสต์ โอเมก้า 369 โกลด์ 1 พลัส รสจืด 180มล (24กล่อง/ลัง) Foremost Omega 369 Gold 1 Plus Plain 180ml (นมกล่องUHT)\n\nเหมาะสำหรับเด็กอายุ 1 ปีขึ้นไป\nข้อมูลโภชนาการ: \nหนึ่งหน่วยบริโภค : 1 กล่อง (180 มิลลิลิตร)\nจำนวนหน่วยบริโภคต่อกล่อง : 1\nพลังงานทั้งหมด 50 กิโลแคลอรี (พลังงานจากไขมัน 25 กิโลแคลอรี)\n・ไขมันทั้งหมด 2.5 ก. ไขมันอิ่มตัว 1.5 ก.โคเลสเตอรอล 5 มก. โปรตีน 3 ก. คาร์โบไฮเดรตทั้งหมด 7 ก.\n・ดีเอชเอ 17 มก. โอเมก้า 3 (กรดไลโนลีนิก) 40 มก. โอเมก้า 6 (กรดไลโนลีอิก) 169 มก. โอเมก้า 9 (กรดโอลีอิก) 766 มก. โคลีน 9 มก. ทอรีน 15 มก. สฟิงโกไมอีลิน 5 มก. ฟอสโฟลิปิด 18 มก. ต่อ 1 กล่อง\n\nร้อยละของปริมาณสารอาหารที่แนะนำให้บริโภคต่อวัน สำหรับคนไทยอายุตั้งแต่ 5 ปีขึ้นไป (Thai RDI) โดยคิดจากความต้องการพลังงานวันละ 2000 กิโลแคลอรี่\n\nส่วนประกอบ : น้ำนมโค 38% นมผงขาดมันเนย 3.7% แลคโตส 1.7% น้ำมันพืชผสม (มีโอเมก้า 3 6 9) 0.96% วิตามินและเกลือแร่ผสม 0.32% ดีเอชเอจากสาหร่าย 0.13% วัตถุเจือปนอาหาร (INS 339(iii), INS 407, INS 460(i), INS 466, INS 471, INS 1440) แต่งกลิ่นธรรมชาติและกลิ่นเลียนธรรมชาติ\n\nอายุการเก็บรักษา 6 เดือนนับจากวันที่ผลิต\n\nFDA : 11-1-22223-1-0320\n#นม #นมกล่อง #นม uht #นมuht #นม uht เด็ก #นมuhtเด็ก #นมกล่อง uht #นมกล่องuht #นมกล่องเด็ก #นมเด็ก #นมโฟร์โมสต์ #โฟร์โมสต์", "brand": "Foremost(โฟร์โมสต์)", "brand_id": 1146508, "condition": 0, "shop_location": "จังหวัดสมุทรปราการ", "cat_id": 100632, "ctime": 1618332269, "price": 905, "price_min": 905, "price_max": 905, "price_before_discount": null, "price_min_before_discount": null, "price_max_before_discount": null, "discount_pct": null, "availability": "InStock", "liked_count": 8156, "stock": null, "is_hide_stock": false, "sold": null, "historical_sold": null, "view_count": null, "is_pre_order": false, "has_model_with_available_shopee_stock": true, "rating_star": 4.8819953085355925, "rating_count": [ 41917, 284, 136, 557, 2464, 38476 ], "total_ratings": 41917, "images": [ "https://down-th.img.susercontent.com/file/th-11134207-81zti-mp1wh04q9lohc7", "https://down-th.img.susercontent.com/file/th-11134207-7rasa-m34j9evjcst7ab", "https://down-th.img.susercontent.com/file/th-11134207-81zth-mezi4ta56ihbbc", "https://down-th.img.susercontent.com/file/th-11134207-7rasd-m34ixfra8rhs9a", "https://down-th.img.susercontent.com/file/th-11134207-7rasc-m5tp4dcncp0d17", "https://down-th.img.susercontent.com/file/th-11134207-7rase-m34iyogktsyj81", "https://down-th.img.susercontent.com/file/th-11134207-7ra0r-mcbirvpticskad", "https://down-th.img.susercontent.com/file/th-11134207-7rasf-m34iys6ldot7d0", "https://down-th.img.susercontent.com/file/th-11134207-7rasa-m34iytzsq9qzc6" ], "categories": [ { "catid": 100632, "name": "แม่และเด็ก" }, { "catid": 100681, "name": "นมผงและอาหารเด็ก" }, { "catid": 102070, "name": "นมพร้อมดื่ม" } ], "attributes": [ { "name": "แนะนำอายุ", "value": "2-3 ปี" } ], "models": [ { "model_id": 91465565540, "name": "ขายยกลัง x 2", "price": null, "stock": null, "sold": null, "status": 1, "price_before_discount": null, "tier_index": [ 0 ], "is_pre_order": false, "has_stock": true } ], "tier_variations": [ { "name": "Variations", "options": [ "ขายยกลัง x 2" ], "images": [] } ], "breadcrumb": [ { "position": 1, "name": "Shopee", "url": "https://shopee.co.th/" }, { "position": 2, "name": "ของเล่น สินค้าแม่และเด็ก", "url": "https://shopee.co.th/ของเล่น-สินค้าแม่และเด็ก-cat.11044960" }, { "position": 3, "name": "นมและอาหารสำหรับเด็กอายุ 1 ปีขึ้นไป", "url": "https://shopee.co.th/นมและอาหารสำหรับเด็กอายุ-1-ปีขึ้นไป-cat.11044960.11045222" }, { "position": 4, "name": "นมยูเอชที (UHT)", "url": "https://shopee.co.th/นมยูเอชที-(UHT)-cat.11044960.11045222.11046142" }, { "position": 5, "name": "[ขายยกลังx2]โฟร์โมสต์ โอเมก้า สมาร์ท โกลด์ 1 พลัส รสจืด 180มล (24กล่อง/ลัง)Foremost Omega Smart Gold 1 Plus Plain180ml", "url": "https://shopee.co.th/-ขายยกลังx2-โฟร์โมสต์-โอเมก้า-สมาร์ท-โกลด์-1-พลัส-รสจืด-180มล-(24กล่อง-ลัง)Foremost-Omega-Smart-Gold-1-Plus-Plain180ml-i.59860978.3885759790" } ], "label_ids": [ 1014045, 1009116, 1073861, 1400095024, 1400085512, 1213598, 814381247166470, 825249635454464, 844931064601283, 844931086908638, 1908622, 298888364, 2058593, 298643324, 2103586, 298938367, 298933337, 2158743, 298983407, 2213645, 2243655, 2213586, 299103340, 299073362, 2098592, 2108635, 1000110, 1000028, 1001365, 998091087, 998286037, 822059879271430, 822120593886220, 822120593887756, 2283665, 1400840019, 1400845102, 700960097, 2218676, 998326163, 2283771, 1428713, 1718087960, 2063581, 2058581, 2288631, 2058612, 298898342, 2113586, 2063592, 2058592, 998286006, 2063583, 2063618, 2288632, 298893326, 2063604 ], "item_has_video": false, "shop": { "shopid": 59860978, "name": "Foremost Official Shop", "username": "foremost_official_shop", "location": "จังหวัดสมุทรปราการ", "rating_star": 4.874629, "item_count": 139, "follower_count": 773942, "response_rate": 100, "response_time": 1910, "is_official_shop": true, "is_shopee_verified": false }, "flash_sale_url": "https://shopee.co.th/flash_sale" } ``` | Field | Type | Description | |---|---|---| | `shop_id` | integer | Numeric seller shop ID | | `item_id` | integer | Numeric product item ID | | `title` | string | Product title | | `currency` | string | ISO currency code (e.g. `IDR`, `THB`, `VND`) | | `description` | string | Full product description | | `brand` | string | Brand name, or `null` | | `price` | float | Current price in local currency (best with Apify Cloud) | | `discount_pct` | integer | Discount percentage, or `null` | | `rating_star` | float | Average seller rating | | `total_ratings` | integer | Total number of product ratings | | `images` | array | Array of product image URLs | | `categories` | array | Product category hierarchy | | `attributes` | array | Product attributes (specs, materials, etc.) | | `models` | array | Price variants/models (if applicable) | | `shop` | object | Seller info: name, username, location, follower count, response rate | | `flash_sale_url` | string | The flash sale page URL used to find this product | ### Other Shopee Actors | Actor | What it does | |---|---| | [shopee-search](../shopee-search-act) | Keyword + category search across all sellers | | [shopee-mall-search](../shopee-mall-search) | Official brand store search (Shopee Mall) | | [shopee-product-detail](../shopee-detail-act) | Full product detail by shop/item ID or URL | | [shopee-shop](../shopee-shop-act) | All products from a specific Shopee shop | | [shopee-campaign](../shopee-campaign) | Products from Shopee campaign microsites | | [shopee-search-hint](../shopee-search-hint) | Keyword autocomplete suggestions | # Actor input Schema ## `country` (type: `string`): Shopee regional site. Flash sale product data is only available for Indonesia (ID), Thailand (TH), and Vietnam (VN). Other countries (SG, MY, PH, etc.) return empty pages — this is a confirmed server-side limitation, not a geographic block. ## `maxProducts` (type: `integer`): Maximum number of flash sale products to process. The flash sale page typically shows 11–16 products (current active session only). No pagination is available. ## `fetchDetail` (type: `boolean`): Recommended — fetch name, price, discount percentage, images, and seller info for each product. Without this, only shop\_id and item\_id are returned (no names or prices visible in the flash sale HTML). ## `delay` (type: `number`): Delay between product detail requests in seconds. ## Actor input object example ```json { "country": "id", "maxProducts": 20, "fetchDetail": true, "delay": 1 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "country": "id", "maxProducts": 20, "fetchDetail": true, "delay": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/shopee-flash-sale").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "country": "id", "maxProducts": 20, "fetchDetail": True, "delay": 1, } # Run the Actor and wait for it to finish run = client.actor("xtracto/shopee-flash-sale").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "country": "id", "maxProducts": 20, "fetchDetail": true, "delay": 1 }' | apify call xtracto/shopee-flash-sale --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/shopee-flash-sale", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Shopee Flash Sale Scraper", "description": "Scrape the current active Shopee flash sale session. Extracts product IDs and optionally enriches with full name, price, discount percentage, and seller info. Supported countries: Indonesia (ID), Thailand (TH), Vietnam (VN).", "version": "0.1", "x-build-id": "hecsnyuK5WKW3L5n9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~shopee-flash-sale/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-shopee-flash-sale", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/xtracto~shopee-flash-sale/runs": { "post": { "operationId": "runs-sync-xtracto-shopee-flash-sale", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/xtracto~shopee-flash-sale/run-sync": { "post": { "operationId": "run-sync-xtracto-shopee-flash-sale", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "country": { "title": "Country", "enum": [ "id", "th", "vn" ], "type": "string", "description": "Shopee regional site. Flash sale product data is only available for Indonesia (ID), Thailand (TH), and Vietnam (VN). Other countries (SG, MY, PH, etc.) return empty pages — this is a confirmed server-side limitation, not a geographic block.", "default": "id" }, "maxProducts": { "title": "Max products", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of flash sale products to process. The flash sale page typically shows 11–16 products (current active session only). No pagination is available.", "default": 20 }, "fetchDetail": { "title": "Fetch full product detail", "type": "boolean", "description": "Recommended — fetch name, price, discount percentage, images, and seller info for each product. Without this, only shop_id and item_id are returned (no names or prices visible in the flash sale HTML).", "default": true }, "delay": { "title": "Request delay (seconds)", "minimum": 0, "maximum": 10, "type": "number", "description": "Delay between product detail requests in seconds.", "default": 1 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```