Shopee Shop Profile, Item & Category Scraper

Collect public Shopee data across Malaysia, Singapore, the Philippines, Thailand, Vietnam, Indonesia, Brazil and Taiwan. Get shop profiles with ratings, followers and response metrics; item pages with descriptions, images, variants and specifications; complete category trees; and mall-shop directories. No login, cookies or proxy setup required. Shop profiles and category trees work in all eight markets; mall-shop directories work in seven (Indonesia returns none); item detail works in seven because Taiwan's item pages are not public.

What this actor does

• Four modes: shopProfile (shop page), itemByUrl (item page), categoryTree (full taxonomy), mallShops (mall directory)
• Eight markets: MY / SG / PH / TH / VN / ID / BR / TW, with the correct local currency. Item detail is available in MY / SG / PH / TH / VN / ID / BR; TW item pages are not public.
• Shop profiles: rating, rating counts, followers, item count, response rate and time, joined date, official/verified badges, description, cover image, optional shop categories
• Item details: title, description, brand, category path, images, option groups, attributes, per-model stock, condition, shipping flags
• Featured product card: the one product Shopee publishes on a shop page, with its public price, original price, discount, rating, sold count, stock and likes
• Category trees: every top-level and child category for the selected market, with IDs, paths and child counts
• Mall shops: the shops listed in a market's mall directory, enriched with their public profiles
• Empty fields are omitted

Output per shop (recordType: "shop")

• shopId, userid, shopName, username, country, market, currency
• ratingStar, ratingCount, rating_good, rating_normal, rating_bad
• followerCount, itemCount, responseRate, responseTimeSeconds
• createdTimestamp, joinedAt, lastActiveTimestamp, lastActiveAt, cancellationRate
• isOfficialShop, isShopeeVerified, isPreferredPlusSeller, showOfficialShopLabel, isShopeeChoiceShop, vacation, isFollowed
• description, coverImage
• shopCategories[] — categoryId, name, itemCount (when requested)
• featuredItemId — the featured product, when one is published
• warnings[] — per-row note when the featured card was requested but unavailable
• sourceUrl, scrapedAt, recordType

Output per item (recordType: "item")

• itemId, shopId, title, shopName, shopUsername
• price, priceMin, priceMax, priceOriginal, discountPercent, currency — featured product only
• sold, soldLast30Days, stock, ratingStar, ratingCount, likeCount — featured product only
• categoryId, category, categoryPath, categories[], location
• listedTimestamp, listedAt, images[], imageCover
• description, itemStatus, brand, brandId, condition
• variations[] — legacy text form, e.g. Colour: Red, Blue
• variationGroups[] — name, options[]
• attributes[] — id, name, value
• variants[] — modelId, name, stock; plus modelCount
• isPreOrder, isFreeShipping, isServiceByShopee, isOfficialShop
• featured — true when the price/rating/sold/stock fields come from the shop's featured card
• status — item_page_unavailable when only the featured card could be returned
• warnings[] — per-row note explaining a card fallback or an unavailable featured card
• sourceUrl, scrapedAt, recordType

Output per category (recordType: "category")

• categoryId, category, categoryName, displayName
• parentCategoryId, level, path, childCount
• imageUrl, market, currency, sourceUrl
• scrapedAt, recordType

Input

Field	Type	Default	Description
mode	string	shopProfile	shopProfile / itemByUrl / categoryTree / mallShops
market	string	–	MY / SG / PH / TH / VN / ID / BR / TW (prefill MY)
shopUrl	string	–	Shop username, numeric ID, /shop/<id> path or full URL (mode=shopProfile; prefill watsons.my)
itemUrl	string	–	Full item URL, -i.<shopid>.<itemid>, shopid.itemid or /product/<shopid>/<itemid> (mode=itemByUrl)
categoryId	string	–	Category ID or name; blank = whole tree (mode=categoryTree)
includeChildren	boolean	true	Include child categories; when categoryId is blank, false returns only top-level categories
includeShopCategories	boolean	false	Add the shop's own category list (mode=shopProfile)
includeFeaturedItem	boolean	true	Add the featured product card; on itemByUrl, merge it when the item matches. Also enables the shop-page mirror that supplies cancellationRate and showOfficialShopLabel
maxItems	integer	50	Hard cap on emitted records (1–500). Use 500 for a full category tree

Legacy values shopProducts and browseByCategory are still accepted and mapped to the current modes; legacy domain, shopUsername, and category inputs are also mapped.

Example: shop profile in Malaysia

{
  "mode": "shopProfile",
  "market": "MY",
  "shopUrl": "watsons.my",
  "includeShopCategories": true,
  "includeFeaturedItem": true,
  "maxItems": 20
}

Example: item detail in Singapore

{
  "mode": "itemByUrl",
  "itemUrl": "https://shopee.sg/product/15235546/26306526891",
  "includeFeaturedItem": true,
  "maxItems": 5
}

Example: full category tree in Indonesia

{
  "mode": "categoryTree",
  "market": "ID",
  "maxItems": 500
}

Example: mall shops in the Philippines

{
  "mode": "mallShops",
  "market": "PH",
  "maxItems": 10
}

Use cases

• Seller intelligence — compare shop ratings, follower counts, response times and official badges across markets
• Catalogue enrichment — add descriptions, images, attributes and option groups to an existing product list
• Category mapping — build a local category taxonomy with IDs and parent paths for each Shopee market
• Marketplace monitoring — track the featured product's public price, discount, rating and sold count over time
• Mall discovery — collect the shops promoted in a market's mall directory for outreach or benchmarking
• Multi-market research — run the same shop or item across eight catalogues with the correct currencies

FAQ

What is the data source? Public Shopee shop and item pages, and Shopee's public category and mall-directory endpoints. This actor is a third-party tool and is not affiliated with or endorsed by Shopee.

Do I need an account, cookies or a proxy? No. The actor reads public pages and requires no login, cookies or proxy configuration.

Why can't I search by keyword or list every item in a category? Shopee gates keyword search and category item listings behind a login/anti-bot wall for automated visitors. This actor deliberately uses the public shop, item and category surfaces instead.

Why are price, rating, sold count or stock missing on some items? Shopee hides those fields from logged-out visitors on most item pages. They are included when the item is the shop's featured product, whose public card carries them. The featured field tells you which records have them. The public card comes from a translation mirror that can rate-limit (HTTP 429); in that case the shop record is still returned but the card is omitted.

What is the featured product? It is the single product card Shopee publishes on a shop page. It usually changes over time; it is not a substitute for a full catalogue.

Which markets are supported? Malaysia, Singapore, the Philippines, Thailand, Vietnam, Indonesia, Brazil and Taiwan. The market is inferred from a full URL; otherwise the market input is used. Item detail is currently public in all markets except Taiwan, where the item page returns no data; itemByUrl can then return only the shop's featured card when includeFeaturedItem is on.

What does cancellationRate mean? It is Shopee's public seller cancellation metric, reported as a percentage as published. It is omitted when Shopee does not expose it.

Why are some fields missing? Empty fields are omitted by design. Descriptions, brands, attributes and shop categories are not published for every shop or item.

How fresh is the data? Live — every run fetches the current public pages.

Can I get a shop's complete catalogue? No. Shopee's public shop page exposes the profile and at most a featured product; the full item feed requires login. Use itemByUrl for specific items.

Limitations

• Keyword search, category item listings and full shop item feeds are not public; they are not supported.
• Item price, rating, sold count and stock are only available for a shop's featured product.
• Taiwan item pages are not public: the page returns an empty item payload (Shopee error 90309999). itemByUrl therefore returns no item detail in TW; with includeFeaturedItem on, it can return only the featured card. Shop profiles, category trees and mall shops still work in TW.
• The translation mirror that supplies the featured card can return HTTP 429. The actor backs off and keeps the shop record, but the card may be missing for that run; featured is absent on those item records.
• cancellationRate and showOfficialShopLabel come from the same shop-page mirror as the featured card. They are omitted when includeFeaturedItem is off or the mirror is rate-limited.
• Mall-shop directories are available for most markets; Indonesia currently returns none, while shop and item URLs still work.
• Item descriptions, brands and attributes are published for most but not all items; missing values are omitted.
• maxItems caps emitted records at 500; a full category tree can be collected with maxItems: 500.
• On Taiwan, some item pages do not expose a usable payload. When the item is the shop's featured product, the actor returns that card with status: "item_page_unavailable" and a warning instead of an empty row.
• If the featured card is temporarily rate-limited after three attempts, the shop row is still returned with a warnings[] entry instead of being dropped.
• Reviews, seller contact details and per-variant prices are not part of this actor.
• Old saved tasks that send the retired mode values shopProducts or browseByCategory are rejected by input validation before the actor starts; use shopProfile or categoryTree instead. Legacy minPrice, maxPrice, minRating and containsKeyword still apply to the featured card, and proxyConfiguration is ignored. The schema also supplies market and shopUrl defaults, so old tasks that relied only on legacy domain or shopUsername should set market and shopUrl explicitly.