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
/api/v2/category_list/get	Retrieve category list
/api/v4/search/search_facet	Get search facets for filtering
/api/v4/search/search_items	Search for items by keywords
/api/v4/recommend/recommend	Retrieve personalized recommendations
/api/v4/collection/get_items	Get items from a specific collection
/api/v4/microsite/campaign_site_page	Access campaign site pages
/api/v4/campaign_collection/get_campaign_list	List available campaign collections
/api/v4/homepage/mall_shops	Retrieve featured mall shops
/api/v4/shop/get_shop_tab	Access specific shop tabs
/api/v4/shop/rcmd_items	Get shop items list
/api/v4/shop/search_items	Search items within a shop
/api/v4/shop/get_shop_base	Retrieve basic shop information
/api/v4/product/get_shop_info	Get detailed shop information
/api/v4/flash_sale/get_all_sessions	List all flash sale sessions
/api/v4/flash_sale/get_all_itemids	Get item IDs in a flash sale
/api/v4/flash_sale/flash_sale_batch_get_items	Retrieve flash sale items in batches
/api/v4/flash_sale/brand_sale_get_all_shops_item_ids	Get all item IDs for brand sales
/api/v4/flash_sale/brand_sale_get_all_sessions	Retrieve all sessions for brand sales
/api/v4/pdp/get	Get product details page (PDP) info
/api/v4/pdp/get_rw	Access product details v2
/api/v2/item/get_ratings	Retrieve ratings for an item

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.