Shopee Scraper — Product, Price, SKU & Review Data 🛒

Extract Shopee marketplace data at scale: products, live prices, SKU variants, seller profiles and buyer reviews. Export it as clean JSON, CSV or Excel. No browser, no proxies, no anti-bot fights.

🎉 Six Shopee scrapers in one actor: search a keyword, drill into any product, or profile any seller

---

📋 Overview

Shopee is Southeast Asia's largest marketplace, and its product pages are notoriously hard to extract at scale. This actor gives you structured Shopee data from one simple input. Pick an operation, paste a URL or keyword, and get flat rows ready for a spreadsheet or a database.

Supported marketplaces: 🇹🇼 Taiwan (shopee.tw) · 🇮🇩 Indonesia (shopee.co.id) · 🇹🇭 Thailand (shopee.co.th)

Paste a full Shopee URL and the marketplace is detected automatically.

---

✨ Features

Operation	What you get	Typical rows
🔍 Product Search	Every product Shopee returns for a keyword: title, price, currency, sold count, shop ID, image	~20 per keyword
📦 Product Detail	Full product record: current & original price, discount %, sales, stock, and the complete SKU variant matrix	1 per product
⭐ Product Reviews	Buyer reviews with star rating, review text, the exact variant bought, and quality/service/delivery sub-scores	up to 2,000
🏬 Shop Profile	Seller profile: follower count, rating, listing count, official-shop & preferred-seller badges, response rate	1 per shop
🛍️ Shop Products	The products shown on a seller's shop page	varies by shop
💬 Shop Reviews	Buyer reviews across a seller's whole storefront	up to 2,000

Also included

• 🧬 Full variant breakdown: every dimension, option combination and model, each with its own price, original price and promotion
• 📉 Real discount data: current price vs original list price with the discount percentage
• 🧭 Honest coverage flags: every product row carries a coverage block telling you exactly which sections hold real data
• 🌏 Auto marketplace detection from any pasted Shopee URL
• 📊 HTML run report saved on every run, even if the run fails
• 🔁 Automatic retries with backoff when the marketplace is briefly slow

---

🎬 Quick Start

Search Taiwan for wireless earphones:

{
  "operation": "search",
  "site": "TW",
  "keyword": "耳機"
}

Get the full record for one product:

{
  "operation": "productDetail",
  "productUrl": "https://shopee.tw/AirPro3-i.598490793.57509316914",
  "includeSkuMatrix": true
}

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose an operation

Pick one of the six operations from the dropdown. Each run does one job.

Step 2: Provide your input

• Product Search → a keyword (or a list of keywords)
• Product Detail / Product Reviews → a Shopee product URL
• Shop Profile / Shop Products / Shop Reviews → a Shopee shop URL or username

Step 3: Run and export

Open the Storage tab and export to CSV, JSON or Excel, or pull it straight from the API.

---

📥 Input Configuration

Field	Type	Used by	Description
operation	select	all	Which of the six scrapers to run
site	select	all	TW, ID or TH. Overridden by a pasted URL's own marketplace
keyword / keywords	string / array	Search	One keyword, or many for bulk runs
productUrl / productUrls	string / array	Product Detail, Product Reviews	Shopee product URL(s)
shopUrl / shopUrls	string / array	Shop operations	Shopee shop URL(s) or username(s)
maxReviews	integer	Review operations	Reviews to collect per target (default 50)
ratingFilter	select	Review operations	Only collect reviews with this star rating; 0 = all
reviewDetail	select	Shop Reviews	standard or rich (fuller review source)
detailVersion	select	Product Detail	Standard, or Alternate source if Standard returns nothing
includeSkuMatrix	boolean	Product Detail	Add the full variant option matrix
includeSkuModels	boolean	Product Detail	Add observed per-model variant data
includeSnapshot	boolean	Product Detail	Add the listing-page display snapshot
includeInstallments	boolean	Product Detail	Add installment plans (🇹🇼 Taiwan & 🇮🇩 Indonesia only)
includeReviewModels	boolean	Product Detail	Add review distribution across variants
includeReviewTags	boolean	Product Detail	Add the review tag summary
includeShopSeo	boolean	Shop Profile	Add the public shop rating summary
includeShopCategories	boolean	Shop Profile	Add the seller's own category structure
includeFacets	boolean	Search	Add brand & category facets for the keyword

A note on the include* options: each one fetches an extra piece of data and is billed as one additional enrichment. They are all off by default, so a plain run never costs more than you expect.

Accepted URL formats

https://shopee.tw/Any-Product-Name-i.598490793.57509316914   ← product (recommended)
598490793.57509316914                                        ← shopId.itemId
https://shopee.tw/xiaomi.tw                                  ← shop by username
https://shopee.tw/shop/15199365                              ← shop by ID

💡 Always paste the full product URL for reviews and variant data. It carries the shop ID those operations need.

---

📤 Output

One flat row per item. Example product row (trimmed):

{
  "_rowType": "product",
  "market": "Taiwan",
  "itemId": 57509316914,
  "shopId": 598490793,
  "productName": "AirPro3 無線藍芽耳機 降噪耳機",
  "productUrl": "https://shopee.tw/product-i.598490793.57509316914",
  "currency": "TWD",
  "price": 599,
  "originalPrice": 1290,
  "discountPercent": 52,
  "salesHistorical": 4000,
  "salesDisplay": "4000+",
  "stockQuantity": 1,
  "inStock": true,
  "skuCombinationCount": 1,
  "skuModels": [{ "model_id": 430824392138, "price": 599, "original_price": 1290 }],
  "coverage": { "basic": true, "price": true, "sales": true, "stock": true, "sku": true, "reviews": false },
  "updatedAt": "2026-08-13T00:54:25+08:00"
}

Example review row (trimmed):

{
  "_rowType": "productReview",
  "reviewId": 107080612947,
  "ratingStar": 5,
  "comment": "很好用，音質不錯",
  "modelName": "【Pro3頂配版】原版主動降噪",
  "ratingQuality": 5,
  "ratingSellerService": 5,
  "ratingDeliveryService": 5,
  "createdAt": "2026-08-12T22:38:58.000Z"
}

Every row also carries _operation, _rowType, status and _fetchedAt. Rows that failed carry status: "error" and a plain-English errorMessage, so a partial run is still easy to read.

Reading the coverage block

Product rows include upstream's own per-section validity flags. "reviews": false means the review section genuinely held no data for that product, not that the scraper missed it. Use it to filter confidently instead of guessing at empty fields.

---

💼 Use Cases & Examples

1. Competitor Price Monitoring

Schedule Product Detail across a list of competitor URLs and track price, originalPrice and discountPercent daily to catch flash sales and undercutting the moment they go live.

2. Product & Category Research

Run Product Search across a set of keywords to map an entire category: prices, sold counts and which sellers dominate, all before you commit to stocking anything.

3. Review Mining & Voice of Customer

Pull reviews with modelName attached, so you learn which specific variant disappoints buyers, and split the blame between product quality, seller service and delivery.

4. Seller & Supplier Vetting

Profile a seller before partnering: follower count, rating stars, official-shop status, verification badges and response rate in one row.

5. SKU & Assortment Analysis

Use the variant matrix to see how sellers structure bundles and which models carry the real inventory and the real discounts.

---

🔗 Integration Examples

JavaScript / Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('sian.agency/shopee-product-scraper').call({
    operation: 'search',
    site: 'TW',
    keyword: '耳機',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("sian.agency/shopee-product-scraper").call(run_input={
    "operation": "productDetail",
    "productUrl": "https://shopee.tw/AirPro3-i.598490793.57509316914",
    "includeSkuMatrix": True,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["productName"], item["price"], item["discountPercent"])

cURL

curl -X POST "https://api.apify.com/v2/acts/sian.agency~shopee-product-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"operation":"shopProfile","shopUrl":"https://shopee.tw/xiaomi.tw"}'

Automation Workflows

Trigger the actor on a schedule from Make, Zapier or any workflow tool, and push rows straight into Google Sheets, Airtable, Slack or your warehouse. No code required.

---

📊 Performance & Pricing

Charged per successful result. Errors are never billed, and invalid input is rejected before anything is charged.

FREE Tier (Try It Now)

• Up to 25 rows per run so you can evaluate the data shape
• All six operations available
• No credit card required

PAID Tier (Production Ready)

• Unlimited rows per run
• Bulk inputs: many keywords, products or shops in a single run
• Reviews paginated up to 2,000 per target

Typical speed is roughly 1.5–4 seconds per upstream lookup; a 20-result keyword search finishes in a few seconds.

---

❓ Frequently Asked Questions

Which Shopee marketplaces are supported? Taiwan, Indonesia and Thailand. Singapore, Malaysia, the Philippines, Vietnam and Brazil are not available in this actor. If you need them, open an issue and we'll track the demand.

Does "Shop Products" return the seller's entire catalogue? No, and the actor says so in the data. That operation returns the products shown on the shop's page, and each row carries completeShopCatalog: false to make that explicit. For broader coverage of a seller's range, use Product Search and filter by shopId.

Why did Product Reviews return an error asking for the full URL? Reviews are keyed by shop and item. A bare item ID isn't enough, so paste the full product URL, which contains both.

What if Product Detail returns nothing for a product? Switch detailVersion to Alternate source. It's a separately sourced feed and often covers products the standard one misses. It requires the full product URL.

Are prices in local currency? Yes. currency tells you which (TWD, IDR, THB), and no conversion is applied.

Can I filter reviews by star rating? Yes, use ratingFilter. Set it to 1 to mine complaints, or 5 for testimonials.

---

🐛 Troubleshooting

Problem	Fix
"Data source temporarily unavailable"	The marketplace was briefly slow. The actor already retried 5 times with backoff, so just re-run.
"Product not found"	The listing was removed, or it doesn't exist in the marketplace you selected. Check site.
"No valid product targets"	The URL wasn't recognised. Use a full Shopee product URL containing -i.<shopId>.<itemId>.
Reviews stop early	Shopee's review pagination isn't strictly ordered; the actor stops when a page returns nothing new, which is the correct end of the list.
Empty installments	Installment data covers Taiwan and Indonesia only.
Only 25 rows returned	You're on the FREE tier. Add billing in Apify Console to lift the cap.

---

⚠️ Trademark Disclaimer

This is an independent tool and is not affiliated with, endorsed by, or sponsored by Shopee or Sea Limited. Shopee® is a registered trademark of Sea Limited and appears here under nominative fair use purely to describe what this tool does.

---

⚖️ Is it legal to scrape data?

Scraping publicly available information is legal in most jurisdictions. This actor only ever touches what any visitor can see without logging in: public product listings, prices and published reviews. It collects no personal data beyond the usernames Shopee itself shows publicly on reviews, which Shopee already masks.

You remain responsible for how you use the data. If you plan to process personal data, make sure you have a lawful basis under GDPR or your local equivalent. When in doubt, talk to a lawyer.

---

🤝 Support

• 🐛 Found a bug? Report it via the Issues tab in Apify Console
• 💡 Need a marketplace or field we don't cover? Tell us. Feature requests shape the roadmap
• ⭐ Getting value out of it? A 5-star rating genuinely helps

More automation tools by SIÁN Agency: apify.com/sian.agency