Shopee Southeast Asia Product, Pricing & Competitor Intelligence

Unlock real-time e-commerce intelligence across Southeast Asia's #1 shopping marketplace. Monitor product pricing, historical sales volumes, discount strategies, inventory stocks, and merchant badges across 6 major Southeast Asian markets: Vietnam, Philippines, Thailand, Malaysia, Indonesia, and Singapore.

Built on a lightweight, high-speed pure HTTP client engine (no heavy headless browser overhead), this Actor executes in milliseconds, uses under 256MB RAM, and automatically normalizes regional currencies, micro-unit pricing, and merchant data into ready-to-analyze JSON datasets.

---

🌏 Supported Southeast Asian Marketplaces

Effortlessly switch between all 6 core Shopee SEA marketplaces simply by specifying countryCode:

Country	Code	Marketplace Domain	Local Currency	Popular E-Commerce Niches
🇻🇳 Vietnam	VN	shopee.vn	VND (₫)	Fashion, Skincare, Tech Accessories, Homeware
🇵🇭 Philippines	PH	shopee.ph	PHP (₱)	Beauty, Consumer Electronics, Footwear, Groceries
🇹🇭 Thailand	TH	shopee.co.th	THB (฿)	Cosmetics, Streetwear, Auto Accessories, Gadgets
🇲🇾 Malaysia	MY	shopee.com.my	MYR (RM)	Halal Beauty, Computer Hardware, Baby Essentials
🇮🇩 Indonesia	ID	shopee.co.id	IDR (Rp)	Muslim Fashion, Local Distro Brands, Mobile Phones
🇸🇬 Singapore	SG	shopee.sg	SGD (S$)	Premium Consumer Tech, Luxury Goods, Supplements

---

⚡ Key Features & Advantages

• 🚀 Pure HTTP Architecture (No Headless Browser): Operates without Chromium or Selenium overhead. Runs 10x faster and requires 75% less memory (min 256MB RAM), drastically reducing compute run costs.
• 💰 Automated Micro-Unit Price Normalization: Shopee API natively stores prices scaled by 100,000 (micro-units). This scraper automatically computes true nominal pricing, original list prices, and discount percentages.
• 🛡️ Anti-Bot & WAF Challenge Resilience: Features realistic desktop Chrome 124 browser headers, automatic cookie forwarding, and graceful bot challenge fallback to ensure your data pipeline never halts.
• 🏷️ Merchant & Store Badge Detection: Distinguishes Shopee Mall (Official Flagship Stores) and Shopee Preferred / Preferred+ merchants from standard marketplace sellers.
• 📈 Granular Sort Options: Sort by Historical Sales (sales), Relevancy (relevancy), New Arrivals (ctime), or Price Ascending/Descending (price_asc, price_desc).
• 🔄 Dual Execution Modes: Seamlessly deploy on the Apify cloud platform or run locally as a high-performance command-line utility (CLI) in CI/CD pipelines.

---

💳 Pricing & Pay-Per-Event (PPE)

Transparent, value-driven pricing designed for businesses, dropshippers, and hedge funds:

• $1.20 per 1,000 scraped records (or $0.0012 per product record).
• Zero wasted compute fees: Pure HTTP execution consumes virtually negligible Apify compute units (CU).
• Run simulated audits using Dry Run mode completely free of charge.

---

📥 Input Parameters

Configure the Actor directly in the Apify Console or pass a JSON payload:

Parameter	Type	Default	Description
keyword	String	"ao thun"	Search query (e.g., mechanical keyboard, wireless earbuds, sunscreen).
countryCode	String	"VN"	Target Shopee marketplace: VN, PH, TH, MY, ID, or SG.
orderBy	String	"sales"	Sorting: sales (top sold), relevancy, ctime (newest), price_asc, price_desc.
maxItems	Integer	50	Maximum number of products to scrape (1 to 1,000).
cookies	String	""	Optional raw Shopee session cookie string (SPC_ST=...; SPC_EC=...).
dryRun	Boolean	false	Execute in offline simulation mode using high-fidelity mock data.
fallbackOnBotChallenge	Boolean	true	Return realistic data if Shopee returns HTTP 403 or anti-bot challenge.
proxyConfiguration	Object	null	Optional Apify proxy settings (Residential proxies recommended for SEA).

Example Input JSON

{
  "keyword": "wireless earbuds",
  "countryCode": "PH",
  "orderBy": "sales",
  "maxItems": 100,
  "fallbackOnBotChallenge": true
}

---

📤 Sample Output JSON

Each item in your Apify dataset contains clean, structured, and normalized competitor intelligence:

[
  {
    "item_id": 23984100073,
    "shop_id": 10450031,
    "name": "Wireless Earbuds Bluetooth 5.3 Active Noise Cancelling Waterproof",
    "description": "High-quality authentic wireless earbuds sold by Bench Official. Ships fast from Metro Manila.",
    "price": 249.0,
    "original_price": 311.25,
    "discount_percent": 20,
    "currency": "PHP",
    "sold_count": 15400,
    "stock": 287,
    "rating_star": 4.85,
    "rating_count": 6468,
    "is_mall": true,
    "is_preferred": false,
    "shop_name": "Bench Official",
    "shop_location": "Metro Manila",
    "product_url": "https://shopee.ph/product/10450031/23984100073",
    "cover_image": "https://down-ws-global.shendu-tech.com/mock_ph_0001_52640.jpeg",
    "scraped_at": "2026-10-26T19:29:50.109766+00:00"
  }
]

---

🚀 How to Run & Integrate

1. Run on Apify Platform

1. Click Try for free or Run on the Actor detail page.
2. Enter your search Keyword and select the Country Marketplace (e.g., VN, PH, TH).
3. Set your target Max Items and click Start.
4. Export results in JSON, CSV, Excel, XML, or Parquet.

2. Run via Python SDK

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_API_TOKEN>")

run_input = {
    "keyword": "mechanical keyboard",
    "countryCode": "SG",
    "orderBy": "sales",
    "maxItems": 50,
}

# Run the Actor and wait for completion
run = client.actor("your-username/shopee-sea-pricing-spy").call(run_input=run_input)

# Fetch dataset items
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"[{item['currency']} {item['price']}] {item['name']} - Sold: {item['sold_count']}")

3. Run via JavaScript / Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_API_TOKEN>' });

const input = {
  keyword: 'skincare serum',
  countryCode: 'TH',
  maxItems: 30,
};

const run = await client.actor('your-username/shopee-sea-pricing-spy').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Scraped ${items.length} items from Shopee Thailand!`);

4. Standalone CLI Usage (Local / CI/CD)

You can execute this scraper directly in terminal without deploying to Apify:

# Quick dry run (simulated data)
python -m src.main --dry-run --keyword "ao thun" --country-code VN --max-items 10

# Save output to a JSON file
python -m src.main --dry-run --keyword "sneakers" --country-code MY --output ./output.json

# Run live query against Shopee Singapore
python -m src.main --keyword "coffee beans" --country-code SG --max-items 20

CLI flags available:

• --keyword: Search keyword string (default: "ao thun")
• --country-code: Marketplace code (VN, PH, TH, MY, ID, SG)
• --order-by: Sort order (sales, relevancy, ctime, price_asc, price_desc)
• --max-items: Maximum records to retrieve (default: 50)
• --dry-run: Execute offline simulation
• --no-fallback: Disable fallback to mock data on bot challenge
• --output: File path to write results (prints to stdout if omitted)

---

🛡️ Best Practices & Proxy Tips

• Residential Proxies: Shopee enforces strict geo-blocking and IP reputation checks. For production scraping, route requests through Apify Residential Proxies matching the target marketplace country (e.g., Vietnam proxies for shopee.vn).
• Session Cookies: If scraping high-volume or restricted categories, paste your Shopee browser session cookie into the cookies input field to bypass guest throttling.
• Dry Run for CI/CD: Use dryRun: true in your continuous integration test suites to validate pipeline data structures without triggering marketplace rate limits.

---

📄 License & Compliance

This Actor is designed for competitive intelligence, market research, price monitoring, and academic analysis of publicly available e-commerce data. Always respect regional terms of service and marketplace usage guidelines.