Shopee Products Scraper: Prices, Reviews, No Login (Apify Actor)
Track rival prices on Shopee: products by keyword, category or shop link with prices, sellers, reviews, flash sales and keyword suggestions in 9 countries. Optional change tracking. No login. Price: $0.36 per 1,000 products, $2.70 per 1,000 reviews, $1.40 per 1,000 listing pages, plus $0.0008 per run start. Runs as an Apify Actor, callable from MCP clients via the Apify MCP server (https://mcp.apify.com/?tools=cliqtomedia/shopee-scraper).
託管 MCP 伺服器
npx add-mcp 'https://mcp.apify.com/?tools=cliqtomedia/shopee-scraper'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Shopee Products Scraper: Prices, Reviews, No Login (cliqtomedia/shopee-scraper) Actor
Track rival prices on Shopee with no login. Get products, prices, sellers, shop reviews and flash sales from public pages, see what changed since your last run, and export JSON or CSV. Keyword search covers 9 countries.
- URL: https://apify.com/cliqtomedia/shopee-scraper.md
- Developed by: Cliqto Media (community)
- Categories: E-commerce
- Features: Limited permissions
- Stats: 12 total users, 3 monthly users, 85.4% runs succeeded, 0 bookmarks
- User rating: No ratings yet
Pricing
from $0.25 / 1,000 products
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
What's an Apify Actor?
An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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.
Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.
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.
Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.
For examples already wired to this Actor's own input schema, see the API section below.
Each client library has reference documentation the quickstart does not restate: JavaScript/TypeScript (npm install apify-client) and Python (pip install apify-client).
README
Type keywords or paste Shopee links, and get Shopee products as rows with price, original price, discount, rating, seller name and seller rating. No login and no Shopee account are needed. The prefilled search for 10 phone cases in Thailand takes 30 to 50 seconds and costs about $0.006 on the Free plan.
Use it to track rival prices on Shopee, see what changed since your last run, read shop reviews and watch flash sales. Export the rows as JSON or CSV, or read them by API.

The rows in this picture are samples. Your results depend on the search and the day.
Table of contents
- What it does
- How it works
- Quick start
- Use cases
- Input
- Output
- Pricing
- Limits
- API, export and integrations
- Troubleshooting
- FAQ
- Related Actors
- Support
What it does
The Actor reads public Shopee pages as a guest and returns one row for each result. It can collect:
- Products from keywords, search links, shop links and category links.
- Product details such as description, gallery, categories, attributes and variants.
- Seller data: name and rating, and on request followers, response rate and other shop metrics.
- Shop reviews with stars, text, seller reply and a summary row.
- Flash sales with promotion time, sale price and remaining promotional stock.
- Keyword hints and the category tree of a market.
- Changes since your last run: new products and new prices.
Good fit
- You sell on Shopee and want to check rival prices and discounts each day.
- You research a product niche in Southeast Asia, Taiwan, Brazil or Mexico.
- You want to read what buyers say about a shop.
Not a good fit
- You need order data, your own seller account data or buyer contacts. The Actor reads only public guest pages.
- You need exact stock and exact sold counts for every product. Shopee often hides these from guests, so these fields can be empty.
How it works
- You choose what to collect. Enter keywords, paste Shopee links or enter IDs, then set a result limit.
- The Actor reads public pages. It waits about one second between normal requests, so large runs take time. Links run first, then keywords.
- You get the rows. Open the Output tab, export the data or read it by API. The run also saves a
RUN_SUMMARYrecord with counts and the reason it stopped.
Quick start
- Open the Input tab and keep Country set to
Thailand. - Keep
phone casein Search keywords. - Open Result limits and keep Maximum results at
10. - Run the Actor.
- When the run ends, open Output and choose the Products view.
- Check
price,originalPriceanddiscountPercent. - Check
shopNameandshopRating.
Expected result: 10 product rows in Thai baht (THB) in 30 to 50 seconds. The cost is about $0.006 on the Free plan. Search results change from run to run, so your products will differ from the picture.
Use cases
| Buyer job | Input path | Output entity | Key fields | Next integration |
|---|---|---|---|---|
| Watch rival prices each day | keywords or shopUrls with onlyChanges: true | Product | price, previousPrice, changeStatus, discountPercent, shopName | Schedule the run, then send a summary to Slack |
| Research a product niche | keywords, country, minRating, sortBy | Product | price, rating, location, shopRating | Export CSV to a spreadsheet |
| Read what buyers say about a shop | mode: reviews with shopUrls | Review and summary | rating, comment, sellerReply, ratingCountsByStar | Send the rows to a text analysis tool |
| Check a shop before you work with it | mode: profile with shopUrls | Shop | shopRating, shopFollowers, shopResponseRate, shopProductCount | Add the rows to a supplier sheet |
| Watch the current flash sale | mode: flash_sale, country | Flash-sale product | price, stockRemainingPercent, promotionEnd | Run on a schedule and export JSON |
Input
Only one thing is needed: something to search for. No field is strictly required.
- Empty input: if you send
{}or empty lists, such as{"keywords":[]}, through the API, the Actor has no work to do. The run ends with 0 rows and only the start fee. The Console form starts withphone casealready filled in. - Practical maximum: 5,000 products per run (measured on version 0.1; version 0.2 was tested up to 1,000). See Limits for time and cost.
- Duplicates: repeated keywords and links are removed. A product that appears twice in results is delivered once.
- Bad links: a bad link is skipped and reported. The run fails only if no valid target is left.
Input fields
| Field | Plain name | Type | Required | Default / prefill | Allowed values | Effect | Example | Recommendation |
|---|---|---|---|---|---|---|---|---|
country | Country | string | No | th | th, id, sg, my, ph, vn, tw, br, mx | Market for keywords, categories and flash sales. Each pasted link keeps its own market. | th | Reviews, details and flash sales were tested only in Thailand. |
mode | Mode | string | No | auto | auto, search, product, shop, reviews, hints, profile, categories, flash_sale | What to collect. auto reads the link type. | reviews | Keep auto for keywords and normal links. |
keywords | Search keywords | string list | No | default empty; prefill phone case | Any text | Search terms. They share one result limit. | ["desk lamp"] | Use more keywords for large runs. |
startUrls | Shopee URLs | link list | No | empty | HTTPS Shopee search, category, shop or product links | Any Shopee link. | https://shopee.co.th/search?keyword=phone%20case | Use this if you have mixed links. |
productUrls | Product URLs | link list | No | empty | HTTPS product links with shop and product IDs | Opens each product page. | https://shopee.co.th/product/333239573/56366098260 | Costs more than a search row. |
shopUrls | Shop URLs | link list | No | empty | HTTPS shop links | Products of each shop. | https://shopee.co.th/shop/333239573 | Good for watching one rival. |
categoryUrls | Category URLs | link list | No | empty | HTTPS category links | Products of each category. | https://shopee.co.th/Women-Clothes-cat.11044951 | Add filters to keep rows useful. |
shopId | Shop ID | string | No | none | Digits only | One shop, or one product with itemId. | 333239573 | Use with country. |
itemId | Product ID | string | With shopId | none | Digits only | One product. | 56366098260 | Needs shopId. |
categoryId | Category ID | string | No | none | Digits only | One category of the chosen market. | 11044951 | Find IDs with mode: categories. |
maxItems | Maximum results | integer | No | 10 / 10 | 1 to 5,000 | Stops after this many products, categories or hints. | 100 | Start small, then raise it. |
includeSellerDetails | Add seller name and rating | boolean | No | true | true, false | One shop lookup per seller. | false | Turn off for large runs: much faster. |
includeShopMetrics | Add detailed shop metrics | boolean | No | false | true, false | Followers, response rate and more. One profile lookup per shop, and page data may apply. | true | Use for small runs. |
ongoingOnly | Current flash sale only | boolean | No | true | true, false | Off also visits the other listed sessions. | true | Keep on for today's prices. |
promotionId | Flash sale promotion ID | string | No | none | Public promotion ID | Reads one flash-sale session. | promotionId from a flash row | Leave empty for the current session. |
includeShopProfile | Add shop profile row | boolean | No | true | true, false | For shop links, adds one shop row. | true | It does not count toward maxItems. |
includeListingPrice | Look up hidden prices | boolean | No | true | true, false | If a product page hides the price, looks for the same product ID on listing pages. Listing pages are charged. | true | Turn off if you only need the text. |
includeDetails | Add product details | boolean | No | false | true, false | Opens each product page for the description, gallery, attributes and variants. | true | Costs more. Try with a few products first. |
sortBy | Sort by | string | No | relevancy | relevancy, sales, latest, price_asc, price_desc | Asks Shopee to sort the results. | price_asc | Sponsored cards can change the order. |
minPrice | Minimum price | number | No | none | 0 or more, local currency | Removes lower prices and products with no price. | 100 | Use local money, not USD. |
maxPrice | Maximum price | number | No | none | 0 or more, local currency | Removes higher prices and products with no price. | 500 | Must not be below minPrice. |
minRating | Minimum rating | number | No | none | 0 to 5 | Removes lower ratings and products with no rating. | 4.5 | Good for finding strong sellers. |
minSold | Minimum units sold | number | No | none | 0 or more | Adds a detail lookup. Removes products with a hidden sold count. | 100 | Use only if needed: it costs more and removes many rows. |
condition | Condition | string | No | any | any, new, used | Asks Shopee for this condition. | new | Keep any by default. |
discountedOnly | Discounted only | boolean | No | false | true, false | Keeps products with a discount. | true | Good for promotion checks. |
freeShippingOnly | Free shipping only | boolean | No | false | true, false | Asks Shopee for free-shipping listings. | true | Shipping depends on destination. |
officialShopOnly | Shopee Mall only | boolean | No | false | true, false | Asks Shopee for Shopee Mall listings. | true | Use for brand checks. |
preferredSellerOnly | Preferred sellers only | boolean | No | false | true, false | Asks Shopee for preferred sellers. | true | Optional. |
codAvailableOnly | Cash on delivery only | boolean | No | false | true, false | Asks Shopee for cash-on-delivery listings. | true | Optional. |
wholesaleOnly | Wholesale only | boolean | No | false | true, false | Asks Shopee for wholesale listings. | true | Optional. |
genuineOnly | Authentic products only | boolean | No | false | true, false | Asks Shopee for listings it marks as authentic. | true | Optional. |
withVideoOnly | With video only | boolean | No | false | true, false | Asks Shopee for listings with video. | true | Optional. |
shippedFrom | Shipped from | string list | No | empty | Location labels of the market | Asks Shopee for these locations. | ["Bangkok"] | Copy the label from Shopee. |
brand | Brand | string list | No | empty | Brand names or IDs | Adds detail lookups. Removes products with no reported brand. | ["Samsung"] | Costs more. Use a few products first. |
includeText | Name contains | string | No | none | Any text | Keeps names with this text. Letter case is ignored. | magnetic | Use the language of the market. |
excludeText | Name does not contain | string | No | none | Any text | Removes names with this text. | used | Use the language of the market. |
includeReviews | Add reviews | boolean | No | false | true, false | Adds reviews from the public shop feed. | true | Set maxReviewsPerShop first. |
includeShopSummary | Add review summary row | boolean | No | true | true, false | Adds one free summary row per target. | true | Keep on. |
maxReviewsPerShop | Maximum reviews per shop | integer | No | 100 | 0 to 100,000; 0 means until the feed ends | Limit of delivered reviews per shop or product link. | 50 | Do not use 0 without a spending limit. |
starRatings | Star ratings | string list | No | 1 to 5 | 1, 2, 3, 4, 5 | Reads these stars in the order you give. | ["1","2"] | Use low stars to find problems. |
onlyWithText | Reviews with text only | boolean | No | false | true, false | Keeps reviews with a comment. | true | Scans more of the feed. |
onlyWithMedia | Reviews with media only | boolean | No | false | true, false | Keeps reviews with photos or videos. | true | Scans more of the feed. |
reviewsSince | Reviews since | string | No | none | ISO date and time | Keeps newer reviews. | 2026-01-01T00:00:00Z | Use with scheduled runs. |
hintExpansion | Hint expansion | string | No | none | none, alphabet, alphanumeric | Also tries each letter, or letter and digit, after the keyword. | alphabet | More prefixes cost more. |
onlyNew | New products only | boolean | No | false | true, false | Returns only products this history has not seen. | true | Use with a schedule. |
onlyChanges | New products and price changes | boolean | No | false | true, false | Returns new products and new prices. | true | The first run creates the history. |
stateName | History name | string | No | default | 1 to 40 letters, digits, _ or - | The name of your watchlist history. | rival-cases | Use one name per watchlist. |
stateRetentionDays | History retention days | integer | No | 30 | 1 to 3,650 | Older history expires. | 90 | Set longer than your schedule gap. |
proxyConfiguration | Proxy | object | No | direct connection | Datacenter or your own proxy | Connection for normal requests. Residential and Unblocker selections are not accepted. | {"useApifyProxy":false} | Leave as it is. |
deliveryConnector | Send results to | string | No | none | Your Slack, Notion or other MCP connector | Posts a short summary after the run. | Pick it in the form | See below. |
deliveryTarget | Notion page or channel | string | No | none | A Notion page link or a Slack channel ID | Where the summary goes. | C0123456789 | See below. |
Interacting settings
| When | Input A | Input B | Effective behavior | Example | Cost/result effect |
|---|---|---|---|---|---|
| Many keywords | keywords | maxItems | The limit is shared. Each keyword gets a share before the rest is collected. | 3 keywords and 300 results | About 100 products per keyword if Shopee has them. |
| Links and keywords together | links | keywords | Links run first, and keywords use what is left of the limit. | 1 shop link and 1 keyword | Keywords may get few rows or none. |
| Pasted link in another market | country | link | The link keeps its own market. | th and a .vn link | Rows from that link use vn and its currency. |
| Reviews with no target | mode: reviews | keywords only | The run fails at the start with REVIEWS_NEED_SHOP_OR_PRODUCT_URLS. | mode: reviews, no link | Start fee only. |
| Reviews with a target | mode: reviews | links and keywords | Keywords are ignored. | A shop link and a keyword | Only reviews of the shop. |
| Product link with reviews | productUrls | includeReviews | The shop feed is filtered to that product. Old reviews can be outside the feed. | One product link | Review pages are charged even if few match. |
| Filters that need the product page | minSold or brand | maxItems | Each product read gets a detail lookup. Numeric brand IDs go to Shopee directly; names are checked after the lookup. | minSold: 100 | Costs more, and hidden sold counts remove rows. |
| Strict filters | filters | maxItems | maxItems counts delivered rows, not pages read. The Actor keeps reading pages to find matches. | A filter with no matches over 20 pages | $0.0288 with 0 rows. Set a spending limit. |
| Large run | maxItems | includeSellerDetails | Seller lookups slow the run to about 20 products a minute. Without them, about 230 a minute. | 5,000 products (tested up to 1,000 on version 0.2) | Turn the option off and raise the timeout. |
| Short timeout | Run timeout | maxItems | The run stops before the timeout and keeps the rows it has. | Default 300 seconds | Partial result with DEADLINE. You pay only for delivered rows and pages read. |
| Monitoring with no changes | onlyChanges | stateName | Only new or changed rows are returned, and history fees apply. | A repeat run, no price changes | $0.0018 with 0 rows. |
Input examples
Search in one market
{"country":"th","keywords":["phone case"],"maxItems":10}
- Expected behavior: reads one search page, then looks up sellers.
- Expected output: 10
productrows. - Limit or cost note: about $0.006 and 30 to 50 seconds.
Daily check of rival prices
{"country":"th","keywords":["phone case"],"maxItems":50,"onlyChanges":true,"stateName":"rival-cases"}
- Expected behavior: the first run saves all rows to the history. Later runs return only new products and new prices.
- Expected output:
productrows withchangeStatusandpreviousPrice. - Limit or cost note: a repeat run with no changes costs $0.0018 in our test.
Reviews of one shop
{"mode":"reviews","shopUrls":["https://shopee.co.th/shop/333239573"],"maxReviewsPerShop":10}
- Expected behavior: reads the public review feed of the shop.
- Expected output: 10
reviewrows and 1 freereview_summaryrow. - Limit or cost note: about $0.03 for 10 reviews.
Current flash sale
{"mode":"flash_sale","country":"th","maxItems":50}
- Expected behavior: reads the current session.
- Expected output:
productrows with promotion fields. - Limit or cost note: a run with 53 flash-sale rows cost $0.09875 in our test.
Output
Each row has a recordType: product, shop, review, review_summary, keyword or category. The Output tab has views for each: Products, Product details, Reviews, Shops, Categories and Keyword hints.
About empty values: a field is null when Shopee does not show it to a guest or when you did not ask for it. null never means zero. For example, sold: null with soldStatus: "not_reported" means the count is hidden, not that nothing was sold. In our Thai search test, originalPrice and discountPercent were filled in about half of the rows and location in about 80%. description, brand, categories, attributes and variants need includeDetails. shopFollowers needs includeShopMetrics.
Output fields
| Field | Meaning | Type | Can be empty? | Example / enum | Source / notes |
|---|---|---|---|---|---|
recordType | Row type | string | No | product, shop, review, review_summary, keyword, category | Added by the Actor |
status | Product state | string | Yes | complete, not_found | not_found means the product is no longer listed |
country | Market code | string | No | th | From input or link |
currency | Currency of the prices. Prices are not converted. | string | Yes | THB | Shopee |
itemId, shopId | Product ID and shop ID | string | Yes | 45217194564 | Shopee |
name | Product name | string | Yes | Magnetic case | Shopee |
price | Shown price in local money | number | Yes | 314 | null if hidden |
priceStatus | Was a price shown? | string | Yes | reported, not_reported | Added by the Actor |
priceLookupStatus, priceLookupRoute | Result and place of the hidden-price lookup | string | Yes | matched, not_found_in_listings, unavailable, charge_limit | Matches only the same product and shop ID |
originalPrice | Price before discount | number | Yes | 710 | Shopee |
discountPercent | Discount in percent | number | Yes | 55.77 | Shopee, or worked out from the two prices |
rating, ratingCount | Product stars and number of ratings | number | Yes | 4.9 | Shopee |
sold, soldStatus | Units sold, and whether Shopee reported them | number, string | Yes | reported, not_reported | Never estimated |
stock, stockStatus | Stock, and stock state or why the number is missing | number, string | Yes | in_stock, out_of_stock, not_reported, masked_by_source, flash_sale_remaining | The exact number is often hidden from guests |
location | Shipping location on the card | string | Yes | Bangkok | Local language |
images, videos | Image links and video data | array | Yes | Image link | Details give the full gallery |
url, shopUrl | Product link and shop link | string | Yes | https://shopee.co.th/shop/133448475 | Shopee |
searchTerm | Keyword that found this product | string | Yes | phone case | null for a pasted link |
description, brand, brandId | Text and brand | string | Yes | Samsung | With details |
categoryId, categories | Category ID and path | string, array | Yes | 11044951 | With details |
attributes | Product specifications | array | Yes | {"name":"Material","value":"TPU"} | With details |
variants, tierVariations | Variants and their options | array | Yes | modelId, name, price | With details. Variant prices can be hidden. |
likedCount, createdAt, condition, isPreOrder, estimatedDeliveryDays | More product data | number, string, boolean | Yes | true | With details, when Shopee reports them |
isFreeShipping, isCashOnDelivery, isWholesale, isGenuine, hasVideo | Shopee flags for the product | boolean | Yes | true | null if not reported |
isOfficialShop, isPreferredSeller | Shopee flags for the shop | boolean | Yes | true | null if not reported |
detailsStatus | Were details added? | string | Yes | reported | Added by the Actor |
source, sourceRoute, fetchedAt | Source, page type and time of the read | string | Yes | shopee, crawler_html | Added by the Actor. Time in UTC. |
changeStatus, previousPrice | Monitoring result and last known price | string | Yes | new, price_changed, unchanged | With onlyNew or onlyChanges |
shopName, shopRating, shopRatingCount, shopLookupStatus | Seller name, rating and lookup result | string, number | Yes | reported, unavailable, charge_limit | One failed lookup leaves these empty and keeps the product |
shopFollowers, shopFollowing, shopProductCount, shopResponseRate, shopResponseTimeSeconds, shopCancellationRate, shopCreatedAt, shopLastActiveAt, isOnVacation, sellerId, shopUsername | Shop metrics | number, string, boolean | Yes | 1200 | With includeShopMetrics or shop rows |
flashSaleStock, stockRemainingPercent, flashDetailsStatus | Flash-sale stock data | number, string | Yes | 40 | Flash sales only |
promotionId, promotionName, promotionIsOngoing, promotionStart, promotionEnd, promotionTimeZone | Flash-sale session | string, boolean | Yes | UTC | Flash sales only |
reviewId, productName, productUrl, reviewedProducts, variation | Review and its product | string, array | Yes | 115923903493 | Reviews only |
comment, hasText, hasMedia, updatedAt, sellerReply | Review text, media flag, time and seller reply | string, boolean, object | Yes | true | Contact details are removed |
productQualityRating, sellerServiceRating, deliveryServiceRating | Star ratings of the review | number | Yes | 5 | Reviews only |
reviewerAnonymous, buyerRegion | Anonymous flag and region of the buyer | boolean, string | Yes | TH | No buyer account IDs are saved |
reviewScope, targetItemId | Whole shop feed or one product in the feed | string | Yes | shop_feed, product_in_shop_feed | Reviews only |
reviewsCollected, reviewsScanned, sourceReviewTotal, ratingCountsByStar, coverage | Review summary | number, object, string | Yes | reviewsCollected: 10, coverage: limited | Free summary row |
prefix, keyword, categoryName, rankPosition | Keyword hint data | string, number | Yes | phone | Hints only |
parentCategoryId, categoryLevel, categoryPath, childCount, isLeaf | Category tree data | string, number, array, boolean | Yes | 2 | Categories only |
Output entities and surfaces
| Situation | Dataset/API/KVS/live view | Result shape | User action |
|---|---|---|---|
| Normal item | Dataset, API and the Output tab | One row per result. RUN_SUMMARY in the key-value store has status: complete. | Use the rows. |
| Domain-empty result | Empty dataset and RUN_SUMMARY | 0 rows, run SUCCEEDED, stopReason: SOURCE_EXHAUSTED. | Change the keyword or filters. |
| Partial result | Dataset and RUN_SUMMARY | Rows are saved. status: partial with a stopReason such as DEADLINE, CHARGE_LIMIT, CANCELLED (you aborted the run) or INVALID_URL_SKIPPED. | Read the reason, then raise the limit or fix the link. |
| Technical failure or retry | Run status FAILED, RUN_SUMMARY and log | An error code such as SOURCE_BLOCKED. Up to 2 retries are made per request. | See Troubleshooting. |
Output example
The example uses the input {"country":"th","keywords":["phone case"],"maxItems":10}. It is a real row from a test run. Search results change from run to run.
{
"recordType": "product",
"status": "complete",
"country": "th",
"currency": "THB",
"shopId": "1488213545",
"itemId": "54818692790",
"name": "Matte Frostedเคสโทรศัพท์แม่เหล็กสําหรับIPhone 18 17 16 15 14 13 12 11 Pro Max Plusกล้องพร้อมเลนส์ป้องกันนุ่มกันกระแทกไร้สายชาร์จโทรศัพท์ฝาหลังกรณี",
"price": 64,
"originalPrice": 266,
"discountPercent": 75.94,
"rating": 4.7,
"ratingCount": null,
"sold": null,
"soldStatus": "not_reported",
"stock": null,
"stockStatus": "not_reported",
"location": "ต่างประเทศ",
"images": [
"https://down-th.img.susercontent.com/file/sg-11134253-825ay-mujn5txiai2p94"
],
"url": "https://shopee.co.th/Matte-Frosted%E0%B9%80%E0%B8%84%E0%B8%AA%E0%B9%82%E0%B8%97%E0%B8%A3%E0%B8%A8%E0%B8%B1%E0%B8%9E%E0%B8%97%E0%B9%8C%E0%B9%81%E0%B8%A1%E0%B9%88%E0%B9%80%E0%B8%AB%E0%B8%A5%E0%B9%87%E0%B8%81%E0%B8%AA%E0%B9%8D%E0%B8%B2%E0%B8%AB%E0%B8%A3%E0%B8%B1%E0%B8%9AIPhone-18-17-16-15-14-13-12-11-Pro-Max-Plus%E0%B8%81%E0%B8%A5%E0%B9%89%E0%B8%AD%E0%B8%87%E0%B8%9E%E0%B8%A3%E0%B9%89%E0%B8%AD%E0%B8%A1%E0%B9%80%E0%B8%A5%E0%B8%99%E0%B8%AA%E0%B9%8C%E0%B8%9B%E0%B9%89%E0%B8%AD%E0%B8%87%E0%B8%81%E0%B8%B1%E0%B8%99%E0%B8%99%E0%B8%B8%E0%B9%88%E0%B8%A1%E0%B8%81%E0%B8%B1%E0%B8%99%E0%B8%81%E0%B8%A3%E0%B8%B0%E0%B9%81%E0%B8%97%E0%B8%81%E0%B9%84%E0%B8%A3%E0%B9%89%E0%B8%AA%E0%B8%B2%E0%B8%A2%E0%B8%8A%E0%B8%B2%E0%B8%A3%E0%B9%8C%E0%B8%88%E0%B9%82%E0%B8%97%E0%B8%A3%E0%B8%A8%E0%B8%B1%E0%B8%9E%E0%B8%97%E0%B9%8C%E0%B8%9D%E0%B8%B2%E0%B8%AB%E0%B8%A5%E0%B8%B1%E0%B8%87%E0%B8%81%E0%B8%A3%E0%B8%93%E0%B8%B5-i.1488213545.54818692790",
"shopUrl": "https://shopee.co.th/shop/1488213545",
"searchTerm": "phone case",
"description": null,
"brand": null,
"categoryId": null,
"categories": null,
"attributes": null,
"variants": null,
"videos": null,
"shopName": "ChaoYue.TH-ตัวแทนจำหน่ายเคสโทร",
"shopRating": 4.77,
"shopFollowers": null,
"isOfficialShop": null,
"isPreferredSeller": null,
"source": "shopee",
"sourceRoute": "crawler_html",
"fetchedAt": "2026-11-15T11:12:25.551Z",
"shopRatingCount": 8407,
"shopLookupStatus": "reported"
}
Send results to Slack or Notion
Pick your connector in the optional deliveryConnector field. After the run saves its data, the Actor posts a short summary (up to 25 rows and a link to the full dataset) there. Put a Notion page link or a Slack channel ID in deliveryTarget: in Notion every run is added on top of that one page, so your workspace does not fill up with new pages. A delivery error never fails the run and costs nothing extra. Connect a service once in Apify Console → MCP connectors.
Use case → fields
| Use case | Fields to read |
|---|---|
| Price watch | itemId, name, price, originalPrice, discountPercent, previousPrice, changeStatus, url |
| Niche research | name, price, rating, location, shopName, shopRating, searchTerm |
| Shop check | shopName, shopRating, shopRatingCount, shopFollowers, shopResponseRate, shopProductCount |
| Review reading | rating, comment, productName, sellerReply, updatedAt, ratingCountsByStar |
| Flash-sale watch | name, price, stockRemainingPercent, promotionName, promotionStart, promotionEnd |
Pricing
You pay per event. Apify platform usage is included in the event prices. The Free-plan prices are below, and Bronze, Silver and Gold plans pay 10%, 20% and 30% less. The start fee is the same on every plan.
Pricing unit
| Event | When it is charged | Free-plan price |
|---|---|---|
product | One product row from search, shop or category | $0.36 per 1,000 |
product-detail | One product row with details | $0.60 per 1,000 |
detail-lookup | One product page read | $0.60 per 1,000 |
listing-page | One search, shop or category page that returned products (a blocked or empty page is free) | $1.40 per 1,000 |
shop-lookup | One seller name and rating lookup | $0.05 per 1,000 |
profile-lookup | One full shop profile read | $1.00 per 1,000 |
review | One review row | $2.70 per 1,000 |
review-page | One review feed page read | $0.90 per 1,000 |
keyword | One keyword hint row | $0.45 per 1,000 |
category | One category row | $0.45 per 1,000 |
hint-page | One hint request | $0.30 per 1,000 |
category-page | One category tree request | $0.30 per 1,000 |
flash-page | One flash-sale page read | $0.30 per 1,000 |
flash-product | One flash-sale row | $1.80 per 1,000 |
detail-data | Each started 100 KiB of data when a product or shop page needs the automatic connection, at least one block per request | $4.50 per 1,000 |
monitor-history | One history read or write | $0.50 per 1,000 |
apify-actor-start | Once per run. The start fee grows with memory, one start per GB, but the allowed 256 to 512 MB always counts as one start. | $0.0008 per start |
- Valid run with 0 rows: you pay the start fee and the pages read. An empty request costs $0.0008. A filter with no matches on 1 page costs $0.0022.
- Monitoring with no changes: you pay the start fee and two history events, $0.0018 in our test.
- Partial result: you pay for the rows delivered and the pages read. Rows are saved before the run stops.
- Failed run: invalid input costs only the start fee, $0.0008. If Shopee blocks the run, you pay the start fee and the requests already made, and a failed page never costs more than the same page that worked.
Cost examples
We counted the events in real test runs and priced them at Free plan rates. Paid plans cost less per event, except the start fee. The search rows were measured on version 0.2. The other rows (product details, reviews, shop profile, flash sale, hints, categories, monitoring and filters) and the spending-limit tests below were measured on version 0.1; these modes read the same Shopee pages in 0.2, and small runs of each passed on 0.2.
| Scenario | Input scope | Expected item/event count | Base charge | Optional charge | Stop/cap behavior |
|---|---|---|---|---|---|
| Prefilled search | 1 keyword, 10 products | 10 products, 1 page, up to 10 sellers, 30 to 50 s | $0.0058 | Sellers up to $0.0005 | Total up to $0.0063, MAX_ITEMS |
| Medium search with sellers | 3 keywords, 300 products | 300 products, 15 pages, 198 sellers, 766 s | $0.1298 | Sellers $0.0099 | Total $0.1397. Timeout set to 900 s. |
| Large search, no sellers | 40 keywords, 1,000 products | 1,000 products, 40 pages, 262 s | $0.4168 | None | MAX_ITEMS |
| Largest search, no sellers (version 0.1) | 198 keywords, 5,000 products | 5,000 products, 198 pages, 1,230 s | $2.078 | None | MAX_ITEMS. Measured on version 0.1; version 0.2 was tested up to 1,000 products. |
| One product with details | 1 product link | 1 product, 1 detail lookup, 3 data blocks | $0.0169 | Included | Total $0.01695 |
| Reviews of one shop | 1 shop, 10 reviews | 10 reviews, 5 pages, 1 free summary | $0.03235 | None | Stops at your limit |
| Reviews of one shop, larger | 1 shop, 200 reviews | 200 reviews, 12 pages, 21 s | $0.55165 | None | Stops at your limit |
| Reviews of one shop, whole feed | 1 shop, maxReviewsPerShop: 0 | 1,134 reviews, 60 pages, 95 s | $3.11665 | None | Feed ended |
| Shop profile | 1 shop with metrics | 1 shop row | $0.0108 | Included | Done |
| Flash sale | Current session | 53 rows, 39 sellers | $0.0968 | Sellers $0.00195 | Total $0.09875. Session ended |
| Keyword hints | 1 keyword, limit 20 | 12 keywords, 1 page | $0.0065 | None | Source ended |
| Category tree | 264 categories | 264 categories | $0.1199 | None | maxItems |
| First monitoring run | Small search | Products and history | $0.01895 | History included | Done |
| Monitoring, no changes | Same search | 0 rows, 2 history events | $0.0018 | Included | Done |
| Filter with no matches | 1 page, 20 pages | 0 rows | $0.0022, $0.0288 | None | Source ended |
A spending limit works: in a test with a $0.02 limit on the Bronze plan, the run delivered 51 products and stopped with CHARGE_LIMIT. With a $5 limit on the same plan and maxReviewsPerShop: 0, a larger shop stopped at 2,022 reviews.
Limits
- Markets: keyword search was confirmed in 9 markets: Thailand, Indonesia, Singapore, Malaysia, Philippines, Vietnam, Taiwan, Brazil and Mexico. Rich product pages, reviews and flash sales were confirmed only in Thailand. Colombia and Chile are not supported.
- Result limit: 5,000 products per run (measured on version 0.1; version 0.2 was tested up to 1,000 products).
maxItemscounts rows, not pages read, so strict filters can read many pages. - Speed: with sellers on, expect about 20 products a minute: in a version 0.2 test, 300 products took 766 s. With sellers off, expect about 230 a minute: 1,000 products took 262 s. Product links and
includeDetailsread a full product page, so expect about 2 products a minute: 3 links took 92 s, and a list of 20 links stopped at 11 products at the default timeout. - Default timeout: 300 s fit 99 products with sellers on, 1,040 with sellers off, and 11 full product pages. For more, raise the timeout. If the timeout comes first, you keep the rows with
DEADLINE. - Page depth: one results page gave 20 to 25 new products in tests. Use many keywords for large runs: the 1,000-product test used 40 keywords, the 5,000-product test (version 0.1) used 198.
- Memory: 256 MB by default. The highest we saw in the final test series was 149 MB, and an earlier run reached 205 MB. The Actor allows up to 512 MB.
- Hidden data: guests may not see stock, sold counts or variant prices. These stay
null, not0. - Hidden prices: the lookup fills a price only if the same product ID and shop ID are found on a listing page.
- Reviews: the Actor reads the public shop feed. A product link filters the recent part of this feed, so older reviews of the product may be missing. We read one whole feed of 1,134 reviews. Longer feeds were not tested to the end, so set a spending limit with
maxReviewsPerShop: 0. - History:
onlyChangescompares the shown price only.onlyNewcan skip a known product link before reading it. Old records leave the history afterstateRetentionDays, or sooner if storage fills. If history is not available, the run ends as partial withSTATE_UNAVAILABLEand never marks a row as new by mistake. - Failures in a row: one failed product, shop or link is skipped and reported. After 3 failures in a row, the Actor stops that kind of request. Seller lookups stop without removing products. Other work stops with
SOURCE_FAILED_REPEATEDLY. - Requests: up to 2 retries per request, a 25-second timeout, and a 5 MB limit on one response. If Shopee asks to wait more than 10 seconds, the request is treated as failed. Full product pages are read with a browser-like HTTPS client (a small bundled Python helper,
src/protected_http.py); no browser is started. - Terms and privacy: Shopee's terms limit automated access, so check them before you use this for your business. Cookies, third-party keys and buyer IDs or contacts are not saved.
API, export and integrations
API. Start a run and get the rows, using your own Apify token:
curl -X POST "https://api.apify.com/v2/acts/cliqtomedia~shopee-scraper/run-sync-get-dataset-items" \
-H "Authorization: Bearer YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"country":"th","keywords":["phone case"],"maxItems":10}'
Export. Download the dataset as JSON, CSV, Excel, XML or RSS from the Output tab or the API. Add ?view=products to the dataset items link to get only the Products columns.
Scheduling. Use Apify Schedules to run a price check each day. Use onlyChanges so you get only what changed.
Webhooks. Use Apify webhooks to call your system when a run ends. Read RUN_SUMMARY to see if the run was complete or partial.
SDK.
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("cliqtomedia/shopee-scraper").call(
run_input={"country": "th", "keywords": ["phone case"], "maxItems": 10}
)
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
print(row["name"], row["price"], row["currency"])
Use with AI agents (MCP)
Connect this Actor as a tool through https://mcp.apify.com?tools=cliqtomedia/shopee-scraper.
The smallest input is:
{"country":"th","keywords":["phone case"],"maxItems":10}
- Main fields:
country,keywords,maxItems,includeSellerDetails,onlyChanges. - Time and cost: 30 to 50 seconds and about $0.006 on the Free plan.
- Limits: 5,000 products per run (version 0.2 was tested up to 1,000), and about 20 products a minute with sellers on. For large requests, set
includeSellerDetailstofalse, and set a timeout and a spending limit.
Troubleshooting
The run has fewer rows than maxItems
- Symptom: the status is
partialwithstopReason: DEADLINE. - Likely reason: the timeout came first. Seller lookups make the run slow.
- Check:
stopReasoninRUN_SUMMARY. - Action: raise the timeout or set
includeSellerDetailstofalse.
The run stopped at the spending limit
- Symptom:
stopReason: CHARGE_LIMIT. - Likely reason: the maximum cost you set for the run was reached.
- Check: the run's charged events.
- Action: raise the limit. The delivered rows are kept.
No rows
- Symptom: run
SUCCEEDEDwith 0 rows andstopReason: SOURCE_EXHAUSTED. - Likely reason: no product passed the filters, or the keyword has no results in this market. With the API, a misspelled field can also cause this: the Actor ignores unknown fields, so
keywordinstead ofkeywordsmeans an empty request, and you pay the start fee. - Check: your filters and field names. Use words in the language of the market.
- Action: fix the field names, remove filters and run again with a small limit.
A category link failed with LISTING_PAYLOAD_UNAVAILABLE
- Symptom: a category link returns no rows and the run fails with
LISTING_PAYLOAD_UNAVAILABLE. - Likely reason: the category ID belongs to another Shopee market, so the page has no products.
- Check: open the link in a browser.
- Action: find the IDs of your market with
mode: categories, then use those links orcategoryId.
Some links were skipped
- Symptom:
INVALID_URL_SKIPPEDand errors such asINVALID_URLwithproductUrls[1]. - Likely reason: the link is not a Shopee link of a supported market, or a product link has no shop ID.
- Check: the
errorslist inRUN_SUMMARY. - Action: fix that link. The other links still ran.
The run failed with SOURCE_BLOCKED or SOURCE_FAILED_REPEATEDLY
- Symptom: run
FAILEDorpartial, and these codes inRUN_SUMMARY. - Likely reason: Shopee refused the requests or was not available for some time.
- Check: whether the rows delivered before the stop are enough for you. A blocked page is not charged.
- Action: try again later or with a smaller scope. If it repeats, open an Issue with the run ID.
A product is missing or has no data
- Symptom:
DETAIL_UNAVAILABLEorPRODUCT_PAYLOAD_UNAVAILABLE. - Likely reason: the product page was not available for a guest. It may no longer be listed.
- Check: open the link in a private browser window.
- Action: the other products are kept. Retry this one later.
A link went to another page
- Symptom:
INVALID_REDIRECTorCROSS_MARKET_REDIRECT. - Likely reason: Shopee sent the request to a page outside the expected site or market.
- Check: the link and its country domain.
- Action: use the full product link from that market.
Seller fields are empty
- Symptom:
shopLookupStatus: unavailableandOPTIONAL_SELLER_UNAVAILABLE. - Likely reason: the seller lookup failed for this shop.
- Check:
optionalSellerErrorsinRUN_SUMMARY. - Action: the product rows are kept. Run again later for those sellers.
The input was refused
- Symptom: run
FAILEDwith an error code such asITEM_NEEDS_SHOP_ID,INVALID_ID,INVALID_PRICE_RANGEorPAID_PROXY_SELECTION_UNSUPPORTED. - Likely reason: the product ID has no shop ID, an ID has more than digits,
minPriceis abovemaxPrice, or the proxy is Residential or Unblocker. - Check: the code in
RUN_SUMMARY. - Action: fix that field. The run costs only the start fee.
FAQ
Do I need a Shopee login or cookies?
No. The Actor reads public guest pages only. Do not add a login, cookies or any Shopee keys.
How many products can I get, and what will it cost?
Up to 5,000 per run (measured on version 0.1; version 0.2 was tested up to 1,000). On version 0.2, 1,000 products with sellers off cost $0.4168 on the Free plan and took 262 s; the 5,000-product test on version 0.1 cost $2.078. If nothing is found, you pay only for the start and the pages read. An empty request costs $0.0008.
Why does a product cost 0.01?
Some sellers list one cheap variant, so Shopee shows the lowest variant price, for example 0.01 SGD. The Actor returns the price Shopee publishes and does not change it. Use minPrice to skip such rows.
Why are sold and stock empty?
Shopee hides them from guests on many products. The Actor returns null and never guesses or returns 0. Check soldStatus and stockStatus.
Are the rows complete and fresh?
The rows show what a guest sees at the time of the run, and fetchedAt gives that time. Prices can change at any moment, and sponsored cards can change the order. Search does not promise every product on Shopee.
Can I watch prices over time?
Yes. Use onlyChanges with a stateName and an Apify schedule. The first run saves the history, and later runs return only new products and price changes.
Related Actors
- Lazada Product Scraper: Prices, Sellers, Reviews, No Login: the same Southeast Asian markets on Lazada.
- TikTok Shop Scraper: Products, Sales & Prices, No Login: compare with products sold on TikTok Shop.
- AliExpress Scraper: Products, Prices & Reviews, No Login: compare prices with AliExpress products.
- Temu Scraper: Products, Prices, Variants & Reviews: compare prices with Temu products.
Support
Open a request in the Issues tab of this Actor. Include the run ID, the mode you used and the error code or the row that looks wrong. Do not send your Apify token or any other secret.
⭐ Found it useful? Rate this Actor. Something wrong? Report a problem — we fix reported problems.
Changelog
This Actor's version history is a separate document: https://apify.com/cliqtomedia/shopee-scraper/changelog.md
Actor input Schema
country (type: string):
Choose the Shopee market for keywords. Each pasted URL keeps its own market.
mode (type: string):
Auto reads the URL type. Reviews and profiles use shop or product links. Hints use keywords as prefixes. Categories and flash sales use the selected country.
keywords (type: array):
Product search terms, one per line. Results share one total limit. Each keyword receives a share before remaining results are collected.
startUrls (type: array):
HTTPS Shopee search, category, shop or product links, such as https://shopee.co.th/search?keyword=phone%20case. A link that is not on a supported Shopee market is skipped and reported.
productUrls (type: array):
HTTPS Shopee product links with shop and product IDs, such as https://shopee.co.th/product/333239573/56366098260. Each page lookup is charged; delivered products use the detailed-product rate. Extra page-data charges can apply.
shopUrls (type: array):
HTTPS Shopee shop links, such as https://shopee.co.th/shop/333239573. Collect product cards from each shop.
categoryUrls (type: array):
HTTPS Shopee category links, such as https://shopee.co.th/Women-Clothes-cat.11044951. Collect the products shown in each category.
shopId (type: string):
Shopee shop ID. Use it alone for shop products, or add an item ID for one product.
itemId (type: string):
Shopee product ID. A shop ID is also required.
categoryId (type: string):
Shopee category ID for the chosen market.
maxItems (type: integer):
Stop after this many product rows, categories or keyword hints across the run. A flash-sale item in two promotions is two rows. Explicit links are processed before keywords. Shop profiles and review summaries do not count. Review rows use Max reviews per shop.
includeSellerDetails (type: boolean):
Add seller name and rating from public shop pages. Turn on detailed shop metrics for followers and response metrics. One public shop lookup is charged per seller in the run. Detailed shop metrics are a separate option. This lookup is best effort: a blocked shop does not discard the product.
includeShopMetrics (type: boolean):
Add shop followers, response metrics and other available profile fields. One full profile lookup is charged per shop. If a direct page cannot be read, additional page data is charged per started 100 KiB of compressed response, with at least one block per request. The default already adds shop name and rating.
ongoingOnly (type: boolean):
For flash sales, collect the current session only. Turn off to also visit the other sessions listed by Shopee. All sessions share the product limit.
promotionId (type: string):
Optional public flash-sale promotion ID. Leave empty for the current session.
includeShopProfile (type: boolean):
For shop links, also return one shop profile row. Product limits count products, not shop profiles.
includeListingPrice (type: boolean):
For a product URL with hidden prices, look for the same product ID on its shop page and in search. Extra listing pages are charged. A price can still be unavailable.
includeDetails (type: boolean):
Open each product page for descriptions, gallery, categories, attributes and variants. Prices and stock may remain hidden. Each detailed page lookup is charged. A delivered product also uses the product-detail price instead of the product-card price. If a direct page cannot be read, additional page data is charged per started 100 KiB of compressed response, with at least one block per request.
sortBy (type: string):
Ask Shopee to sort listing results. Sponsored cards and changing prices can affect the order.
minPrice (type: number):
Keep cards whose displayed price is at least this amount in the local currency. Products without a price are excluded.
maxPrice (type: number):
Keep cards whose displayed price is at most this amount in the local currency. Products without a price are excluded.
minRating (type: number):
Keep cards with at least this star rating. Products without a rating are excluded.
minSold (type: number):
Keep products with at least this many reported units sold. Products with a hidden sold count are excluded. Adds product-detail lookups.
condition (type: string):
Ask Shopee for new products, used products, or either.
discountedOnly (type: boolean):
Keep products with a reported discount or a price below the original price.
freeShippingOnly (type: boolean):
Ask Shopee for free-shipping listings. Shipping depends on the destination and account.
officialShopOnly (type: boolean):
Ask Shopee for Shopee Mall listings.
preferredSellerOnly (type: boolean):
Ask Shopee for preferred sellers.
codAvailableOnly (type: boolean):
Ask Shopee for products with cash on delivery.
wholesaleOnly (type: boolean):
Ask Shopee for wholesale listings.
genuineOnly (type: boolean):
Ask Shopee for authenticity-guaranteed listings.
withVideoOnly (type: boolean):
Ask Shopee for product listings with video.
shippedFrom (type: array):
Ask Shopee for listings shipped from these locations. Use location labels from the chosen market.
brand (type: array):
Keep products with these brand names or IDs. Adds product-detail lookups; products with no reported brand are excluded.
includeText (type: string):
Keep product names containing this text. Matching ignores letter case.
excludeText (type: string):
Exclude product names containing this text. Matching ignores letter case.
includeReviews (type: boolean):
Also collect reviews from the public shop feed. Review requests and delivered reviews are charged. A product link filters the recent shop feed, so older product reviews can be outside that feed.
includeShopSummary (type: boolean):
Add a free summary row with the reviews collected, scanned count and feed coverage.
maxReviewsPerShop (type: integer):
Maximum delivered reviews per shop or product link, up to 100000. Use 0 to continue until the source ends or the run limit is reached.
starRatings (type: array):
Collect these star ratings, from 1 to 5. Stars are processed in the chosen order and share the review limit.
onlyWithText (type: boolean):
Keep reviews containing a text comment.
onlyWithMedia (type: boolean):
Keep reviews containing photos or videos.
reviewsSince (type: string):
Keep reviews created on or after this ISO date and time, such as 2026-01-01T00:00:00Z.
hintExpansion (type: string):
For keyword hints, also try each letter or letter and digit after the prefix. More prefixes require more requests.
onlyNew (type: boolean):
Return products not delivered by an earlier run using the same history. History read and write fees apply even when no products are returned. Known direct product links can be skipped before fetching.
onlyChanges (type: boolean):
Return new products and products with a different displayed price. The first run creates the history. History read and write fees apply even when no prices change.
stateName (type: string):
History name shared by your monitoring runs. Use a different name for a separate product watchlist.
stateRetentionDays (type: integer):
Keep delivered product history for this many days. Older history expires; the oldest records are also pruned when history storage fills. Monitoring continues.
proxyConfiguration (type: object):
Optional proxy for Shopee requests. The default uses direct HTTP. Use datacenter or your own proxy. Residential and Unblocker selections are not accepted here; detailed page requests use an automatic connection and a separate page data price.
deliveryConnector (type: string):
Your Slack, Notion or other MCP connector. After the run the Actor posts a short summary there. Connect services once in Apify Console → MCP connectors.
deliveryTarget (type: string):
Where to post the summary: a Notion page link (each run is added on top of that page) or a Slack channel ID. Notion needs a page here; without it the summary is not sent and the run summary says why.
Actor input object example
{
"country": "th",
"mode": "auto",
"keywords": [
"phone case"
],
"startUrls": [],
"productUrls": [],
"shopUrls": [],
"categoryUrls": [],
"maxItems": 10,
"includeSellerDetails": true,
"includeShopMetrics": false,
"ongoingOnly": true,
"includeShopProfile": true,
"includeListingPrice": true,
"includeDetails": false,
"sortBy": "relevancy",
"condition": "any",
"discountedOnly": false,
"freeShippingOnly": false,
"officialShopOnly": false,
"preferredSellerOnly": false,
"codAvailableOnly": false,
"wholesaleOnly": false,
"genuineOnly": false,
"withVideoOnly": false,
"shippedFrom": [],
"brand": [],
"includeReviews": false,
"includeShopSummary": true,
"maxReviewsPerShop": 100,
"starRatings": [
"1",
"2",
"3",
"4",
"5"
],
"onlyWithText": false,
"onlyWithMedia": false,
"hintExpansion": "none",
"onlyNew": false,
"onlyChanges": false,
"stateName": "default",
"stateRetentionDays": 30
}
Actor output Schema
products (type: string):
No description
details (type: string):
No description
reviews (type: string):
No description
shops (type: string):
No description
keywords (type: string):
No description
categories (type: string):
No description
summary (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
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
token: '<YOUR_API_TOKEN>',
});
// Prepare Actor input
const input = {
"keywords": [
"phone case"
],
"maxItems": 10
};
// Run the Actor and wait for it to finish
const run = await client.actor("cliqtomedia/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
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")
# Prepare the Actor input
run_input = {
"keywords": ["phone case"],
"maxItems": 10,
}
# Run the Actor and wait for it to finish
run = client.actor("cliqtomedia/shopee-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
CLI example
echo '{
"keywords": [
"phone case"
],
"maxItems": 10
}' |
apify call cliqtomedia/shopee-scraper --silent --output-dataset
MCP server setup
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,cliqtomedia/shopee-scraper"
}
}
}
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an Authorization: Bearer <APIFY_API_TOKEN> header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/MpgQmhxdjhoSsz2qd/builds/H7tC1LxJepY64BCha/openapi.json

