Shopee Official Shop Scraper

Shopee Official Shop Scraper extracts the official brand shops listed in any Shopee category, across 9 storefronts — Vietnam, Indonesia, Singapore, Malaysia, Thailand, Philippines, Taiwan, Brazil and Mexico. Every row carries the shop name, username, brand, storefront URL and logo, with follower, rating and item counts on demand.

中文说明

Shopee 官方店铺目录抓取工具，按类目 ID 采集该类目下的全部官方（品牌认证）店铺，覆盖越南、印尼、新加坡、马来西亚、泰国、菲律宾、台湾、巴西、墨西哥九个站点。

每条数据包含店铺名称 shop_name、账号 username、品牌 brand_name、店铺链接 shop_url 和店铺标识图 logo_url；开启 scrape_analytics 后再加上粉丝数、评分、在售商品数、回复率与所在地。把 category_ids 留空并开启 discover_all，即可一次采集该国全部官方店铺类目。

运行自带住宅代理，无需自行配置。在 Apify Console 填好输入点击 Start 即可，也可以通过 Apify API 提交同样的 JSON。结果支持导出 JSON、CSV 或 Excel。

What you get

One dataset row per official shop. Export as JSON, CSV or Excel.

{
  "category_id": "11035567",
  "shop_id": "24710134",
  "username": "coolmate.vn",
  "shop_name": "Coolmate - Official Store",
  "brand_name": "Coolmate",
  "shop_url": "https://shopee.vn/coolmate.vn",
  "logo_url": "https://cf.shopee.vn/file/vn-11134258-81ztc-mlg620bdy58if7",
  "shop_created_at": "2021-06-21T07:07:26+00:00"
}

Rows also carry user_id, shop_type, entity_id, brand_label and scraped_at. Turn on scrape_analytics and each row adds follower count, rating (star, good, normal, bad), item count, chat response rate and time, shop location, Shopee's verification and Preferred+ badges, the storefront description and the last-active date.

What it costs

Event	Free	Bronze	Silver	Gold+
Actor Start (apify-actor-start)	$0.005	$0.005	$0.005	$0.005
Shop (official-shop-result)	$0.006	$0.00567	$0.00533	$0.005
Shop Analytics (official-shop-detail)	$0.004	$0.00367	$0.00333	$0.003

You pay per shop, not per minute: $0.006 for a directory row, and $0.004 more for a shop when analytics is on. A thousand shops is about $6.01 as a directory, or about $10.01 with analytics, and the residential proxy is included in that price. Higher Apify subscription tiers pay the lower per-shop rates shown above.

Input

Field	Type	Required	Default	What it does
category_ids	array	no	—	Shopee category IDs whose official (brand-verified) shops you want. IDs are per storefront and never shared between countries. Find one in a category URL: https://shopee.vn/Men-Clothes-cat.11035567 has category ID 11035567. Give either category_ids or discover_all — leave empty and turn discover_all on to sweep every official-shop category in the selected country instead. A category with no official-shop directory returns no rows and is not charged; the run reports which IDs came back empty.
discover_all	boolean	no	false	Sweep every official-shop category in the selected country, so there are no IDs to look up. Give either discover_all or category_ids: turn this on only while category_ids is empty, and it is ignored whenever category_ids is set. Default false. A whole-country sweep can return a great many shops, so pair it with max_results to cap what a run returns per category.
country	string	no	"vn"	Shopee storefront to list shops from. It decides which shops exist, the language of their names and the domain of every shop_url. Default vn. Supported: vn Vietnam, id Indonesia, sg Singapore, my Malaysia, th Thailand, ph Philippines, tw Taiwan, br Brazil, mx Mexico. Category IDs belong to one storefront, so change the IDs whenever you change this.
scrape_analytics	boolean	no	false	Add the analytics set to every shop: follower count, rating, item count, chat response rate and time, location, verification and Preferred+ badges, storefront description and last-active date. Default false, which returns the directory fields only and is the fast, cheap listing. Each enriched shop is charged one extra shop-analytics event on top of its shop event.
max_results	integer	no	—	Most shops returned per category, minimum 1. Leave empty to page through a category until Shopee's own total for it is exhausted, which is what a complete directory needs. Set it to cap a large run: with discover_all on it applies to each category separately, so a run returns roughly this many shops times the number of categories found.
offset	integer	no	0	Where each category starts, counted in shops. Default 0, minimum 0 — the first shop in the category. Raise it to resume a large category from an exact position instead of paging from the beginning. It applies to every category in the run, not just the first.
limit	integer	no	50	How many shops each page of results asks for. Default 50, minimum 1, maximum 100. It sets the page size only, not how many shops a run returns in total — max_results does that. Leave it at 50 unless you are resuming a category from a specific offset.
proxyUrls	array	no	—	Leave empty: the run uses the residential proxy this actor ships with, included in the price of the run. To route the run through your own provider instead, add one gateway URL per entry, for example http://user:pass@host:port — works with any provider that issues URLs (DataImpulse, Bright Data, Oxylabs, Smartproxy, or your own). When set, these are used exactly as entered and nothing else is.

How to run it

1. Open the actor on Apify Console.
2. Paste one or more category IDs — a category URL such as https://shopee.vn/Men-Clothes-cat.11035567 ends in its ID. Or leave the IDs empty and turn on Scrape all categories.
3. Pick the country, then Run. Export JSON, CSV or Excel from the dataset.

{
  "category_ids": ["11035567"],
  "country": "vn",
  "max_results": 100,
  "scrape_analytics": false
}

Minimal input:

{
  "category_ids": ["11035567"]
}

Available as the MCP tool herus13--shopee-shop-scraper on mcp.apify.com and through the Apify API; send the same JSON.

Why this scraper

• The official directory, not the seller long tail — Shopee marks brand-verified stores separately from ordinary third-party sellers. This actor reads that directory, so what comes back is the shortlist of real brands in a category rather than every reseller listing the same goods.
• Nine storefronts, one input — Vietnam, Indonesia, Singapore, Malaysia, Thailand, Philippines, Taiwan, Brazil and Mexico all answer the same JSON. Switching markets means changing one field and the category IDs.
• Whole-country sweeps — no category IDs to hand? Turn on discover_all and the run finds every official-shop category in the country and lists them all.
• Analytics only where you want them — sweep a category cheaply, then re-run the shops worth the follower counts, ratings and response metrics.
• Nothing to set up — no account, no cookies, no proxy configuration; a residential proxy is included in the price of the run.

Use cases

• Official brand-store directories — Name, username, brand and storefront URL for every verified shop in a category is exactly the list a category overview page or a partner directory needs.
• Brand-presence monitoring — Watching which brands hold an official store in a category, and in which of the nine countries, shows regional expansion while it is happening rather than after the press release.
• Competitor tracking — A category's official-shop roster is the set of serious competitors in that market, already separated from the long tail of unofficial resellers.
• Partner and supplier discovery — For sourcing or partnerships, official stores are the verified sellers worth approaching, and the analytics fields rank them by followers, rating and catalogue size.
• Market entry research — Compare how many brands hold official stores in the same category across Vietnam, Thailand and the Philippines before committing to a market.

FAQ

What counts as an "official shop"? Shopee's own brand-verified store designation, which is distinct from an ordinary third-party seller shop. This actor lists only the shops in that official directory, which is why a category can return far fewer shops than it has sellers.

Where do I find category IDs? At the end of a category URL: https://shopee.vn/Men-Clothes-cat.11035567 is category 11035567. IDs belong to one storefront, so an ID copied from shopee.co.id will not resolve on shopee.vn. The Shopee Category Lister returns a country's whole category tree, or you can skip IDs entirely with discover_all.

Why did my run return 0 shops? Almost always because that category has no official-shop directory on the storefront you picked. Shopee answers such an ID with an empty list rather than an error, so the run finishes successfully, names the IDs that came back empty, and you are not charged for them.

Which analytics fields do I get? scrape_analytics adds follower count, rating star plus good, normal and bad counts, item count, chat response rate and time, shop location, verification and Preferred+ badges, the storefront description, the last-active date and the following count.

Is a proxy included? A residential proxy is included in the price of the run. To use your own, paste gateway URLs into Your own proxy URLs. Scraping at volume? Your own DataImpulse account is cheaper per GB.

Is scraping Shopee legal? This actor collects only publicly available shop listing data. You are responsible for complying with Shopee's terms and applicable laws. Do not collect personal data without a lawful basis.

Related actors

Southeast Asia marketplace data — Singapore, Malaysia, Vietnam, Thailand, Philippines, Indonesia:

• Shopee Category Lister — one country's full Shopee category tree; use it to find the IDs this actor takes.
• Lazada Scraper — one product row per Lazada search result.
• TikTok Shop Scraper — one TikTok Shop product row, across ten storefronts.
• Amazon Scraper — one product row, including Amazon Singapore.