# Shopee Shop Profile, Item & Category Scraper (`vexaloom-labs/shopee-shop-profile-item-and-category-scraper`) Actor

Collect Shopee shop profiles with ratings and followers, shop product feeds, full item detail pages, and curated category listings across six Southeast Asian markets.

- **URL**: https://apify.com/vexaloom-labs/shopee-shop-profile-item-and-category-scraper.md
- **Developed by:** [vexaloom-labs](https://apify.com/vexaloom-labs) (community)
- **Categories:** E-commerce, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 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

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

#### Example: item detail in Singapore

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

#### Example: full category tree in Indonesia

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

#### Example: mall shops in the Philippines

```json
{
  "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.

# Actor input Schema

## `mode` (type: `string`):

What to collect.

## `market` (type: `string`):

Shopee market. Used for categoryTree, mallShops and bare IDs; a full URL keeps its own market.

## `shopUrl` (type: `string`):

Shop username, numeric shop ID, /shop/<id> path, or full Shopee shop URL (mode=shopProfile).

## `itemUrl` (type: `string`):

Full item URL, -i.<shopid>.<itemid>, shopid.itemid, or /product/<shopid>/<itemid> (mode=itemByUrl).

## `categoryId` (type: `string`):

Numeric category ID from categoryTree mode, or a category name. Leave blank for the whole tree (mode=categoryTree).

## `includeChildren` (type: `boolean`):

Include child categories (mode=categoryTree). When categoryId is blank, false returns only top-level categories.

## `includeShopCategories` (type: `boolean`):

Add the shop's own category list to the shop record (mode=shopProfile).

## `includeFeaturedItem` (type: `boolean`):

Add the featured product card published on the shop page; on itemByUrl, merge it when the item matches.

## `maxItems` (type: `integer`):

Hard cap on emitted records. Use 500 for a complete category tree.

## Actor input object example

```json
{
  "mode": "shopProfile",
  "market": "MY",
  "shopUrl": "watsons.my",
  "includeChildren": true,
  "includeShopCategories": false,
  "includeFeaturedItem": true,
  "maxItems": 1
}
```

# Actor output Schema

## `items` (type: `string`):

Dataset containing Shopee shop, item, category and mall-shop records.

# 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

```javascript
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 = {
    "mode": "shopProfile",
    "market": "MY",
    "shopUrl": "watsons.my",
    "includeChildren": false,
    "includeShopCategories": false,
    "includeFeaturedItem": false,
    "maxItems": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("vexaloom-labs/shopee-shop-profile-item-and-category-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

```python
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 = {
    "mode": "shopProfile",
    "market": "MY",
    "shopUrl": "watsons.my",
    "includeChildren": False,
    "includeShopCategories": False,
    "includeFeaturedItem": False,
    "maxItems": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("vexaloom-labs/shopee-shop-profile-item-and-category-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

```bash
echo '{
  "mode": "shopProfile",
  "market": "MY",
  "shopUrl": "watsons.my",
  "includeChildren": false,
  "includeShopCategories": false,
  "includeFeaturedItem": false,
  "maxItems": 1
}' |
apify call vexaloom-labs/shopee-shop-profile-item-and-category-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,vexaloom-labs/shopee-shop-profile-item-and-category-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/QfRXeFPvqqB0A6cjw/builds/UbLTInQaLPvmv9zOa/openapi.json