Shopee Campaign Microsite Scraper

Scrape products from Shopee campaign landing pages (/m/{slug}) — hand-curated promotional microsites for brand events and lifestyle programs like Shopee Fitcheck, Pilih Lokal, Barokah, and Dikelola Shopee.

Why use this actor

• Campaign-exclusive visibility — see exactly which products Shopee's merchandising team is promoting right now
• Automatic campaign discovery — fetch the Shopee homepage to get a live list of active campaign slugs without hardcoding anything
• Handles both layout types — full product card data (Type A) and editorial link grids with optional enrichment (Type B)
• No account or login required
• Stable JSON output suitable for competitor intelligence and affiliate research

How it works

1. Choose mode: "discover" to get a list of currently active campaign slugs from the Shopee homepage — or use mode: "scrape" with a known slug.
2. The actor fetches the campaign page and automatically detects the layout:
   • Type A (card grid): full product data — name, price, image, rating, sold count — is immediately available.
   • Type B (editorial link grid): hundreds of product links are extracted; enable fetchDetail to retrieve full product data for each.
3. Results stream into your dataset as JSON.

Campaign slugs change weekly as Shopee rotates promotions. Use mode: "discover" regularly to stay current.

Input

Scrape a specific campaign:

{
  "mode": "scrape",
  "country": "id",
  "slug": "shopee-fitcheck",
  "maxProducts": 25,
  "fetchDetail": false
}

Discover active campaigns from homepage:

{
  "mode": "discover",
  "country": "id"
}

Field	Type	Description
mode	string	scrape (default) — fetch products from a campaign. discover — list active campaigns.
slug	string	Campaign slug, e.g. shopee-fitcheck. Required for mode=scrape unless url is provided.
url	string	Full campaign URL as alternative to slug, e.g. https://shopee.co.id/m/shopee-fitcheck.
country	string	Shopee regional site: id (default), sg, my, th, ph, and more.
maxProducts	integer	Max products to return. Default: 25. For Type B, caps how many links are enriched.
fetchDetail	boolean	For Type B campaigns: fetch full product data (name, price, images, seller). Default: false.
delay	number	Seconds between requests. Default: 1.0.

Output

mode: "scrape" — Type A layout (e.g. shopee-fitcheck)

[
  {
    "shop_id": 243352643,
    "item_id": 24094096408,
    "name": "kaos pria lengan panjang hoodie wafer",
    "url": "https://shopee.co.id/kaos-pria-lengan-panjang-hoodie-wafer-i.243352643.24094096408",
    "image_url": "https://down-id.img.susercontent.com/file/id-11134207-7rbka-m8m0h674emam50",
    "price": 50000,
    "discount_pct": null,
    "rating": null,
    "sold_count": 5000,
    "location": null,
    "is_mall": false,
    "currency": "IDR",
    "original_price": null,
    "rating_count": null,
    "campaign_slug": "shopee-fitcheck"
  },
  {
    "shop_id": 12597744,
    "item_id": 24914631167,
    "name": "Setelan Anak Rui Top Celana Cargo Korea Unik",
    "url": "https://shopee.co.id/Setelan-Anak-Rui-Top-Celana-Cargo-Korea-Unik-i.12597744.24914631167",
    "image_url": "https://down-id.img.susercontent.com/file/id-11134207-7r98x-ls0vcd63u5bx8c",
    "price": 35000,
    "discount_pct": null,
    "rating": null,
    "sold_count": 10000,
    "location": null,
    "is_mall": false,
    "currency": "IDR",
    "campaign_slug": "shopee-fitcheck"
  }
  // ... more
]

mode: "discover" — active campaign slugs

[
  { "slug": "shopee-pilih-lokal", "url": "https://shopee.co.id/m/shopee-pilih-lokal", "country": "id" },
  { "slug": "barokah",            "url": "https://shopee.co.id/m/barokah",            "country": "id" },
  { "slug": "shopee-fitcheck",    "url": "https://shopee.co.id/m/shopee-fitcheck",    "country": "id" }
  // ... more
]

mode: "scrape" — Type B layout (fetchDetail: false)

When the campaign uses an editorial layout (e.g. Pilih Lokal, Barokah), the actor returns product ID stubs. Enable fetchDetail: true to retrieve full product data.

{
  "shop_id": 123456789,
  "item_id": 98765432100,
  "url": "https://shopee.co.id/product/123456789/98765432100",
  "campaign_slug": "shopee-pilih-lokal",
  "country": "id",
  "layout_type": "B"
}

Field	Type	Description
shop_id	integer	Numeric seller shop ID
item_id	integer	Numeric product item ID
name	string	Product title (Type A, or Type B with fetchDetail: true)
price	integer	Price in local currency
discount_pct	integer	Discount percentage, or null
rating	float	Average rating, or null
sold_count	integer	Units sold, or null
currency	string	ISO currency code
campaign_slug	string	The campaign slug this product was found in
layout_type	string	"B" for editorial link-grid campaigns (only in stub output)

Other Shopee Actors

Actor	What it does
../shopee-search-act	Keyword + category search across all sellers
../shopee-mall-search	Official brand store search (Shopee Mall)
../shopee-detail-act	Full product detail by shop/item ID or URL
../shopee-shop-act	All products from a specific Shopee shop
../shopee-flash-sale	Current flash sale session products
../shopee-search-hint	Keyword autocomplete suggestions