Pricing

Rating

Developer

Actor stats

Categories

Share

Shopee Search & Category Scraper

Search Shopee products by keyword, browse a category page, or auto-detect any Shopee listing URL. Returns lightweight product cards by default, or fully enriched product detail when fetchDetail: true.

Related Actors

Modes

Supported Countries

Where the request comes from matters

Search and shop listing pages work for every country regardless of where your request comes from. Two specific cases need attention:

• category mode for co (Colombia) and cl (Chile) — these regions do not expose category pages publicly. The actor will stop early with a clear message. Use keyword or shop mode instead, or pick a different country.
• fetchDetail: true — to enrich each product with full information (description, brand, variants, attributes, image gallery), the request must originate inside the target country. On Apify Cloud this is handled automatically for id/sg/my/th/ph via residential proxy. From outside, or for vn/br/tw/mx/co/cl, enrichment returns a lighter set (title, price, primary image, rating, sold count, seller info).

What you get per country × mode

Full = title, price range, description, brand, all variant names, all attributes, all images, full categories, breadcrumb, seller info.

Light = title, price, primary image, rating, sold count, seller info.

Input

Sample Input

Keyword search

{
"country":"sg",
"mode":"keyword",
"keyword":"laptop gaming",
"sort":"sales",
"maxProducts":40
}

Category page

{
"country":"id",
"mode":"category",
"category":"/Laptop-cat.11044364.11044440",
"maxProducts":40
}

Auto-detect from any URL

{
"mode":"url",
"url":"https://shopee.sg/search?keyword=mouse+wireless"
}

Sample Output

Default — one product card per row

Each item in the dataset looks like this:

{
"shop_id":12345678,
"item_id":98765432100,
"name":"Laptop Gaming ASUS ROG Strix G15 Ryzen 7 16GB 512GB RTX3060",
"url":"https://shopee.co.id/Laptop-Gaming-ASUS-ROG-i.12345678.98765432100",
"image_url":"https://down-id.img.susercontent.com/file/id-11134207-xxx",
"price":14999000,
"original_price":17500000,
"discount_pct":14,
"rating":4.9,
"rating_count":312,
"sold_count":1200,
"location":"Jakarta Barat",
"is_mall":false,
"currency":"IDR"
}

When fetchDetail: true — full product detail per row

{
"shop_id":196846900,
"item_id":11089699432,
"title":"Laptop Lenovo Thinkpad X1 Carbon 6th Intel Core i5 Gen8 16GB 256GB",
"currency":"IDR",
"description":"Laptop bekas berkualitas premium, sudah dicek dan bersih...",
"brand":"Lenovo",
"brand_id":52756,
"condition":4,
"cat_id":11044440,
"price":3570000.0,
"price_min":3200000.0,
"price_max":8370000.0,
"price_before_discount":null,
"discount_pct":null,
"availability":"InStock",
"stock":31,
"is_hide_stock":false,
"rating_star":4.87,
"rating_count":[55,0,0,1,5,49],
"total_ratings":55,
"images":[
"https://down-id.img.susercontent.com/file/id-11134207-7ra0n-xxx",
"https://down-id.img.susercontent.com/file/id-11134207-7ra0n-yyy"
],
"attributes":[
{"name":"Screen Size","value":"14 inches"},
{"name":"Operating System","value":"Windows"},
{"name":"Processor Type","value":"Intel Core i5"}
],
"models":[
{
"model_id":227787022248,
"name":"i5 Gen8 RAM 16GB / 256GB SSD",
"price":null,
"stock":null,
"has_stock":true
}
],
"tier_variations":[
{"name":"Configuration","options":["i5 Gen8 16GB/256GB","i7 Gen8 16GB/512GB"]}
],
"categories":[
{"catid":11044364,"name":"Computers & Accessories"},
{"catid":11044440,"name":"Laptops"}
],
"breadcrumb":[
{"position":1,"name":"Shopee"},
{"position":2,"name":"Computers & Accessories"},
{"position":3,"name":"Laptops"}
],
"shop":{
"shopid":196846900,
"name":"RASYIDJAYA COMPUTER",
"username":"rasyidjaya_computer",
"location":"KOTA BANDUNG",
"rating_star":4.84,
"item_count":120,
"follower_count":2248,
"response_rate":98,
"response_time":2
}
}

Fields available depend on the country and where the request comes from — see the support matrix above. For countries marked Light, only shop_id, item_id, title, currency, price, images (primary), rating_star, sold, shop_location, and shop are returned.

Known Limitations

• Roughly 40 products per search page. The actor pages through additional sort orders to surface more unique results, but the total can fall short of maxProducts for narrow queries.

  Tip — to collect more varied results, run several related keywords instead of relying on one broad term. For example, rather than only laptop, run separate searches for laptop, laptop gaming, laptop bekas, laptop asus, notebook, etc., then merge the datasets. Each keyword surfaces a different slice of Shopee's catalog, so combining them yields far broader coverage than a single search.

• category mode is not available for Colombia and Chile. These regions do not expose category pages publicly. Use keyword or shop mode for those countries.
• Mexico shows fewer prices. Roughly 30–40% of products on Shopee Mexico do not have a public price — those will come back with price: null.
• fetchDetail: true returns a lighter data set for vn, br, tw, mx, co, cl, even on Apify Cloud. Description, brand, variant list, attributes, and the full image gallery are not available for these countries.
• "Sold count" is missing for most products. Shopee hides this number; the actor recovers it on a best-effort basis (~30–50% of products).