# Shopee Multi-Region Scraper (SG MY PH ID TH VN) (`enrico_7/shopee-scraper`) Actor Scrape product listings, prices, sales volumes, ratings, and shop details from all 6 Shopee markets, Singapore, Malaysia, Philippines, Indonesia, Thailand, and Vietnam in one run. Keyword search, product URLs, and full shop scraping. Export to JSON, CSV, or Excel. - **URL**: https://apify.com/enrico\_7/shopee-scraper.md - **Developed by:** [Enrico Tjioe](https://apify.com/enrico_7) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $10.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. 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 Multi-Region Scraper — SG MY PH ID TH VN Extract product listings, prices, sales volumes, ratings, and shop details from **all 6 Shopee markets** in a single Actor run — no code needed. The only Shopee scraper on Apify with true multi-region support built in. **New to Apify? The free plan covers your first ~500 results at no cost.** ### What does the Shopee Multi-Region Scraper do? This Actor hits Shopee's internal product API (the same one that powers the Shopee website) and returns clean, structured data across Singapore, Malaysia, Philippines, Indonesia, Thailand, and Vietnam. It exposes fields not shown on the page, including **all-time historical sales counts** and monthly velocity. Three scraping modes: - **Keyword Search** — find products matching your search terms, sorted by sales or relevance - **Product Detail** — pull full data for specific product URLs - **Shop / Seller** — scrape all products from a specific Shopee shop Run from the Apify Console, schedule recurring runs, connect via API, or export directly to Google Sheets, JSON, CSV, or Excel. ### Why use this Shopee data extractor? **Dropshippers and sourcing agents:** Find high-sales, low-competition products across all 6 SEA markets in one run. Compare what sells in SG vs ID vs PH before committing to a supplier. Spot pricing gaps across regions before your competitors do. **Brand managers and competitor analysts:** Track competitor SKUs, pricing changes, discount patterns, and sales velocity on Shopee — automatically, on a schedule — without manual monitoring. **E-commerce market researchers:** Build price databases, trend datasets, or category benchmarks for Southeast Asia. Schedule daily runs to track how products move over time. **Agencies:** Deliver Shopee market analysis to clients across multiple countries without running separate tools per market. ### How to scrape Shopee product data — step by step #### Step 1: Get your Shopee session cookie (takes 60 seconds, once every 48 hours) This is the only setup step. Shopee blocks requests from cloud servers unless you provide a valid session — this is standard for all Shopee scrapers. Your cookie cannot be used to make purchases or change account settings. Here's how to get it: 1. Open **Chrome** and log in to the Shopee site for your region (e.g. shopee.sg or shopee.com.my) 2. Press **F12** to open DevTools, then click the **Network** tab 3. Reload the page. Click on any request in the list on the left. 4. In the Headers panel on the right, check the **Request URL** at the top. Make sure it shows your Shopee domain (e.g. `shopee.sg`). If it shows `shopeemobile.com`, that's the mobile version — click a different request. 5. Scroll down in the Headers panel to the **Cookie** section under Request Headers 6. Copy the entire cookie string. It starts with `_ga=` and is followed by many more values. Copy all of it. 7. Paste it into the **Shopee Session Cookie** field in the Actor input The cookie stays valid for 24–48 hours. If results stop coming back, refresh the cookie and re-run. #### Step 2: Configure and run 1. Open the **Input** tab in the Actor 2. Choose your **Scraping Mode** (Keyword Search is the most common) 3. Enter your **keywords** or URLs 4. Select a **region**: `sg` / `my` / `ph` / `id` / `th` / `vn` 5. Set **Max Items** — start with 50–100 to test, go up to 10,000 for bulk research 6. Click **Start** Results appear in the **Output** tab. Download as JSON, CSV, Excel, or XML. ### Input | Field | Type | Description | |---|---|---| | `mode` | string | `keyword_search`, `product_detail`, or `shop_detail` | | `keywords` | string[] | Search terms (keyword_search mode) | | `urls` | string[] | Shopee product or shop URLs (other modes) | | `region` | string | `sg`, `my`, `ph`, `id`, `th`, `vn` | | `maxItems` | integer | Max products to return (default: 100, max: 10,000) | | `cookie` | string | Your Shopee session cookie (see Step 1 above) | ### Output — what Shopee data does this scraper extract? Each result is one product. Download in JSON, CSV, HTML, or Excel format from the Output tab. Example output from shopee.sg: ```json { "type": "product", "itemId": "12345678", "shopId": "87654321", "name": "Wireless Earbuds Bluetooth 5.3 TWS", "priceMin": 12.90, "priceMax": 15.90, "currency": "SGD", "originalPrice": 29.90, "discountPct": 57, "totalSales": 4823, "monthlySales": 312, "ratingAverage": 4.8, "ratingCount": 934, "stock": 1250, "thumbnail": "https://cf.shopee.sg/file/...", "isOfficialShop": false, "shopName": "TechGadgets SG", "location": "Singapore", "url": "https://shopee.sg/wireless-earbuds-i.87654321.12345678", "region": "sg", "domain": "shopee.sg", "scrapedAt": "2026-06-13T10:00:00.000Z" } ```` ### Data fields | Field | Description | |---|---| | `itemId` and `shopId` | Shopee internal IDs | | `name` | Full product title | | `priceMin` and `priceMax` | Current price range in local currency | | `originalPrice` | Price before discount | | `discountPct` | Discount percentage | | `totalSales` | All-time units sold (not shown on the Shopee page) | | `monthlySales` | Units sold this month | | `ratingAverage` | Average star rating (0–5) | | `ratingCount` | Total number of reviews | | `stock` | Available stock count | | `thumbnail` | Product image URL | | `shopName` | Seller display name | | `isOfficialShop` | True if Shopee-verified official store | | `location` | Seller city or region | | `url` | Direct Shopee product link | | `region` and `domain` | Which SEA market | | `scrapedAt` | ISO timestamp of when the record was collected | ### How much does it cost to scrape Shopee data? Pay per result. No monthly subscription. | Volume | Estimated cost | |---|---| | 100 products | ~$1 | | 1,000 products | ~$10 | | 10,000 products | ~$100 | Additional Apify platform costs (compute and proxy) are charged separately and vary by region and run size. **New to Apify?** The free plan includes enough credits to test the scraper and get your first ~500 results at no cost. ### Tips for best results - **Cover all 6 regions in parallel** by running 6 Actor runs via the Apify API simultaneously — one run per region with the same keyword list. Faster and cheaper than sequential runs. - **Schedule daily runs** in Apify's Schedules tab to automatically build a price history database over time. - For runs over 10,000 items, increase the Actor timeout in Settings. - Start with **50–100 items** per run to verify your cookie is valid before scaling up. ### FAQ, disclaimers, and support **Why do I need a session cookie?** Shopee blocks requests from cloud IP ranges unless you provide a valid session. This is standard for all Shopee scrapers on the market — no Shopee scraper works without a cookie or a logged-in browser session. **The scraper returned 0 results.** Two likely causes: (1) no cookie provided, or (2) the cookie expired. Log in to Shopee again, copy a fresh cookie from DevTools, and re-run. The cookie is only needed in the Request Headers — not from the Application tab. **Can I scrape all 6 regions in one run?** Each Actor run handles one region at a time. To cover all 6 markets, run 6 parallel runs via the Apify API with the same keyword list. The Output tab shows the `region` field on every result so you can merge datasets easily. **Why are some fields null?** Shopee's API returns different fields depending on region and seller type. `brand`, `attributes`, and `stock` are most commonly null for generic marketplace sellers. **Is scraping Shopee legal?** This Actor collects publicly visible product data accessible to any Shopee visitor. Collecting public web data for research and analysis is widely accepted practice. You are responsible for ensuring your use complies with applicable laws and Shopee's Terms of Service. **Need a custom integration?** Open a GitHub issue or contact via Apify. Custom workflows — Google Sheets sync, Shopify product import, database pipelines, scheduled price alerts — are available on request. # Actor input Schema ## `mode` (type: `string`): Choose how you want to find products. Keyword Search works like typing into Shopee's search bar. Product Detail and Shop Pages require you to paste Shopee URLs below. ## `keywords` (type: `array`): What to search for on Shopee. Each keyword runs a separate search. Examples: wireless earbuds, phone case, running shoes. Only used in Keyword Search mode. ## `urls` (type: `array`): Paste Shopee product or shop links here, one per line. For product pages, copy the URL from any Shopee product listing. It looks like: https://shopee.sg/Product-Name-i.123456789.987654321 For shop pages, go to a seller's Shopee storefront and copy the URL. It looks like: https://shopee.sg/shopname Only used in Product Detail and Shop Pages modes. ## `region` (type: `string`): Which Shopee market to scrape. Each region is a separate Shopee site with its own prices, sellers, and currency. To scrape multiple regions, run the Actor once per region. ## `maxItems` (type: `integer`): How many products to return. Start with 50 to 100 to test. Each Shopee search page returns up to 60 products, so set higher values for deeper research. Maximum: 10,000. ## `cookie` (type: `string`): Required. A session cookie is a temporary token from your browser that lets the scraper access Shopee. It expires after 24 to 48 hours and cannot be used to make purchases or change your account. How to get it: 1. Open Chrome and log in to the Shopee site for your region (e.g. shopee.sg or shopee.com.my) 2. Press F12 to open DevTools, then click the Network tab 3. Click on any request shown in the list on the left 4. Check the Request URL at the top of the Headers panel on the right. Make sure it shows your Shopee domain (e.g. shopee.sg). If it shows shopeemobile.com, that is the mobile version and will not work. Click a different request. 5. Scroll down in the Headers panel until you reach the Cookie section under Request Headers 6. Copy the entire cookie value. It is a long string that typically starts with \_ga= followed by many more values separated by semicolons. Copy all of it. 7. Paste the full value into this field If your run returns 0 results, your cookie has likely expired. Repeat these steps to get a fresh one. ## Actor input object example ```json { "mode": "keyword_search", "keywords": [ "wireless earbuds" ], "urls": [], "region": "sg", "maxItems": 100, "cookie": "" } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("enrico_7/shopee-scraper").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 = {} # Run the Actor and wait for it to finish run = client.actor("enrico_7/shopee-scraper").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 '{}' | apify call enrico_7/shopee-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=enrico_7/shopee-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Shopee Multi-Region Scraper (SG MY PH ID TH VN)", "description": "Scrape product listings, prices, sales volumes, ratings, and shop details from all 6 Shopee markets, Singapore, Malaysia, Philippines, Indonesia, Thailand, and Vietnam in one run. Keyword search, product URLs, and full shop scraping. Export to JSON, CSV, or Excel.", "version": "1.0", "x-build-id": "A6rf244eTtrKkjb99" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/enrico_7~shopee-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-enrico_7-shopee-scraper", "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/enrico_7~shopee-scraper/runs": { "post": { "operationId": "runs-sync-enrico_7-shopee-scraper", "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/enrico_7~shopee-scraper/run-sync": { "post": { "operationId": "run-sync-enrico_7-shopee-scraper", "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": { "mode": { "title": "What do you want to scrape?", "enum": [ "keyword_search", "product_detail", "shop_detail" ], "type": "string", "description": "Choose how you want to find products. Keyword Search works like typing into Shopee's search bar. Product Detail and Shop Pages require you to paste Shopee URLs below.", "default": "keyword_search" }, "keywords": { "title": "Keywords", "type": "array", "description": "What to search for on Shopee. Each keyword runs a separate search. Examples: wireless earbuds, phone case, running shoes. Only used in Keyword Search mode.", "items": { "type": "string" }, "default": [ "wireless earbuds" ] }, "urls": { "title": "Shopee URLs", "type": "array", "description": "Paste Shopee product or shop links here, one per line.\n\nFor product pages, copy the URL from any Shopee product listing. It looks like: https://shopee.sg/Product-Name-i.123456789.987654321\n\nFor shop pages, go to a seller's Shopee storefront and copy the URL. It looks like: https://shopee.sg/shopname\n\nOnly used in Product Detail and Shop Pages modes.", "items": { "type": "string" }, "default": [] }, "region": { "title": "Shopee Region", "enum": [ "sg", "my", "ph", "id", "th", "vn" ], "type": "string", "description": "Which Shopee market to scrape. Each region is a separate Shopee site with its own prices, sellers, and currency. To scrape multiple regions, run the Actor once per region.", "default": "sg" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many products to return. Start with 50 to 100 to test. Each Shopee search page returns up to 60 products, so set higher values for deeper research. Maximum: 10,000.", "default": 100 }, "cookie": { "title": "Shopee Session Cookie", "type": "string", "description": "Required. A session cookie is a temporary token from your browser that lets the scraper access Shopee. It expires after 24 to 48 hours and cannot be used to make purchases or change your account.\n\nHow to get it:\n1. Open Chrome and log in to the Shopee site for your region (e.g. shopee.sg or shopee.com.my)\n2. Press F12 to open DevTools, then click the Network tab\n3. Click on any request shown in the list on the left\n4. Check the Request URL at the top of the Headers panel on the right. Make sure it shows your Shopee domain (e.g. shopee.sg). If it shows shopeemobile.com, that is the mobile version and will not work. Click a different request.\n5. Scroll down in the Headers panel until you reach the Cookie section under Request Headers\n6. Copy the entire cookie value. It is a long string that typically starts with _ga= followed by many more values separated by semicolons. Copy all of it.\n7. Paste the full value into this field\n\nIf your run returns 0 results, your cookie has likely expired. Repeat these steps to get a fresh one.", "default": "" } } }, "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 } } } } } } } } } } ```