Shopee Scraper

This actor enables you to directly access Shopee's unofficial API, which powers its frontend and provides all the data displayed on the website. You can seemlessly fetch detailed information such as product sales, discounts, ratings, search results, recommendations, official shop details, flash sales, and more by utilizing account cookies.

The API Scraper manages all the complex aspects, sparing you from the headache of handling these details yourself.

Available Endpoints

The following table outlines the available API endpoints for accessing various data through the Shopee Scraper. Each endpoint serves a specific purpose, allowing you to retrieve detailed information on categories, search results, product details, recommendations, shop details, flash sales, and more.

API Path	Description	Method	Example Parameters
/api/v2/category_list/get	Retrieve category list	GET	-
/api/v4/search/search_facet	Get search facets for filtering	GET	-
/api/v4/search/search_items	Search for items by keywords	GET	by=relevancy&rating_filter=4&categoryids=100194&limit=60&match_id=1104429
/api/v4/recommend/recommend	Retrieve personalized recommendations	GET	-
/api/v4/collection/get_items	Get items from a specific collection	GET	by=relevancy&limit=100&offset=0&order=desc&page_type=collection&scenario=PAGE_COLLECTION&version=2&view_session_id=335cbf9b-c016-4353-aa58-27b545b66da9&collection_id=123123&item_order=0&limit=60&source=3
/api/v4/microsite/campaign_site_page	Access campaign site pages	GET	-
/api/v4/campaign_collection/get_campaign_list	List available campaign collections	GET	-
/api/v4/homepage/mall_shops	Retrieve featured mall shops	GET	-
/api/v4/shop/get_shop_tab	Access specific shop tabs	POST	{"shopid":123123}
/api/v4/shop/rcmd_items	Get shop items list	GET	bundle=shop_page_category_tab_main&limit=100&offset=100&shop_id=123123&sort_type=1&upstream=
/api/v4/shop/search_items	Search items within a shop	GET	by=relevancy&rating_filter=4&categoryids=100194&limit=60&match_id=1104429
/api/v4/shop/get_shop_base	Retrieve basic shop information	GET	shopid=123123
/api/v4/product/get_shop_info	Get detailed shop information	GET	shopid=123123
/api/v4/flash_sale/get_all_sessions	List all flash sale sessions	GET	category_personalization_type=1&tracker_info_version=1
/api/v4/flash_sale/get_all_itemids	Get item IDs in a flash sale	GET	need_personalize=true&promotionid=123123&sort_soldout=false
/api/v4/flash_sale/flash_sale_batch_get_items	Retrieve flash sale items in batches	POST	{"promotionid":66229947863041,"categoryid":0,"itemids":[23419068712],"limit":16,"with_dp_items":true}
/api/v4/flash_sale/brand_sale_get_all_shops_item_ids	Get all item IDs for brand sales	GET	-
/api/v4/flash_sale/brand_sale_get_all_sessions	Retrieve all sessions for brand sales	GET	-
/api/v4/pdp/get	Get product details page (PDP) info	GET	item_id=28211708960&shop_id=1394297
/api/v4/pdp/get_rw	Access product details v2	GET	item_id=28211708960&shop_id=1394297
/api/v2/item/get_ratings	Retrieve ratings for an item	GET	itemid=4269625641&limit=6&offset=0&shopid=39425361
/api/v4/item/get_list	Bulk product details	POST	{"shop_item_ids":[{"shop_id":37667557,"item_id":25119194921}],"source":"microsite_individual_product"}

Example Usage with Apify Request Schema

To make a request with the Shopee API Scraper, you can define the requests parameter in JSON format as shown below. Be sure to add your Shopee account cookies for enhanced data access. This example demonstrates how to fetch product reviews.

How to scrape Shopee?

Getting started

Get started with Shopee API Scraper by following these simple steps:

Start: Click on Try for free. Prepare Requests: Specify the API request URLs you wish to scrape. Refer to the API reference section for guidance. Example URLs include:

• Search for popular products by keyword: https://shopee.ph/api/v4/search/search_items?keyword=torso
• Retrieve top categories: https://shopee.ph/api/v4/pages/get_category_tree
• List products by category: https://shopee.ph/api/v4/search/search_items?match_id=11027757
• List products by shop: https://shopee.ph/api/v4/shop/rcmd_items?shop_id=39425361
• Access product detail: https://shopee.ph/api/v4/pdp/get_rw?item_id=4269625641&shop_id=39425361
• Access product ratings: https://shopee.ph/api/v2/item/get_ratings?itemid=4269625641&limit=6&offset=0&shopid=39425361

Execution: Click Start and wait for the results. The status will switch from Running to Succeeded upon completion. Results: Access your data in the Storage tab, available in various formats like JSON, CSV, and more.

Example Input:

1{
2    "requests": [
3        {
4            "url": "https://shopee.co.id/api/v4/pdp/get_rw?item_id=28211708960&shop_id=1394297",
5            "method": "GET",
6        },
7		{
8			"url": "https://shopee.co.id/api/v4/flash_sale/flash_sale_batch_get_items",
9			"method": "POST",
10			"payload": "{\"promotionid\":66229947863041,\"categoryid\":0,\"itemids\":[23419068712,11077890837,13268587518,24663561722,22456442694,21185747156,21678147556,17910422893,22254627658,18657547854,10855609617,11264869002,13793758485,25605244917,22482701323,12854902761],\"limit\":16,\"with_dp_items\":true}"
11		}
12    ],
13	"cookie": "<your cookies>"
14}

Example Output:

1[
2	{
3		"bff_meta": null,
4		"error": null,
5		"error_msg": null,
6		"data": {
7			"item": {
8				"item_id": 22629118746,
9				"shop_id": 27731952,
10				"item_status": "normal",
11				"status": 1,
12				"item_type": 0,
13				"reference_item_id": "",
14				"title": "RAINBOWCO Brooklyn  Korean Baseball Cap Unisex Fashion Cap For Men And Women Outdoor Sumbrero",
15				"image": "ph-11134201-23030-qr69g073f8nvfe",
16				"label_ids": [
17					29,
18					1002657,
19					1013151,
20					844931064601283,
21					844931086908638,
22					1563576,
23					22,
24					1400290061,
25					298628331,
26					1718073025,
27					1119699,
28					700610229,
29					13,
30					839709523705368,
31					1048596,
32					1048595,
33					822059952759830,
34					831765669597722,
35					700020221,
36					700610210,
37					1717997940,
38					997971007,
39					298623321
40				],
41				"is_adult": false,
42				"is_preview": false,
43				"flag": 196608,
44				"is_service_by_shopee": false,
45				"condition": 1,
46				"cat_id": 100009,
47				"has_low_fulfillment_rate": false,
48				"is_live_streaming_price": null,
49				"currency": "PHP",
50				"brand": null,
51				"brand_id": 0,
52				"show_discount": 73,
53				"ctime": 1677843336,
54				"item_rating": {
55					"rating_star": 4.6801654142921985
56				},
57				"cb_option": 0,
58				"has_model_with_available_shopee_stock": false,
59				"shop_location": "",
60				"spl_info": null,
61				"estimated_days": 1,
62				"is_pre_order": false,
63				"is_free_shipping": false,
64				"overall_purchase_limit": null,
65				"min_purchase_limit": 1,
66				"is_hide_stock": false,
67				"stock": null,
68				"normal_stock": null,
69				"current_promotion_reserved_stock": 0,
70				"can_use_wholesale": false,
71				"wholesale_tier_list": [],
72				"price": 5500000,
73				"raw_discount": 73,
74				"hidden_price_display": null,
75				"price_min": 5500000,
76				"price_max": 5500000,
77				"price_before_discount": 20000000,
78				"price_min_before_discount": 20000000,
79				"price_max_before_discount": 20000000,
80				"other_stock": 0,
81				"discount_stock": null,
82				"current_promotion_has_reserve_stock": false,
83				"complaint_policy": null,
84				"show_recycling_info": false,
85				"should_show_amp_tag": true,
86				"all_models_has_pre_order": false,
87				"is_item_inherited": false,
88				"max_quantity": 4867
89			},
90			...
91		}
92		...
93	},
94	...
95]

Your Shopee account browser cookies are not stored and will be encrypted or redacted by Apify. After the process is finished, they will be destroyed.

About Cookies

We are not responsible for any potential account bans. Please use this actor wisely and ensure that you follow Shopee's terms of service when using the scraper.

Is it legal to scrape Shopee?

Scraping publicly available data such as product descriptions, prices, or ratings is generally legal. However, you should always review the terms of service of the website you're scraping and ensure compliance with applicable laws. For more information, you can read Apify's blog post on the legality of web scraping.

Share Your Feedback

We value your feedback! If you have any suggestions for improvements, encounter any bugs, or have any other comments, feel free to create an issue in the Actor's issues tab in the Apify Console.