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: json { "requests": [ { "url": "https://shopee.co.id/api/v4/pdp/get_rw?item_id=28211708960&shop_id=1394297", "method": "GET", }, { "url": "https://shopee.co.id/api/v4/flash_sale/flash_sale_batch_get_items", "method": "POST", "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}" } ], "cookie": "<your cookies>" } Example Output: json [ { "bff_meta": null, "error": null, "error_msg": null, "data": { "item": { "item_id": 22629118746, "shop_id": 27731952, "item_status": "normal", "status": 1, "item_type": 0, "reference_item_id": "", "title": "RAINBOWCO Brooklyn Korean Baseball Cap Unisex Fashion Cap For Men And Women Outdoor Sumbrero", "image": "ph-11134201-23030-qr69g073f8nvfe", "label_ids": [ 29, 1002657, 1013151, 844931064601283, 844931086908638, 1563576, 22, 1400290061, 298628331, 1718073025, 1119699, 700610229, 13, 839709523705368, 1048596, 1048595, 822059952759830, 831765669597722, 700020221, 700610210, 1717997940, 997971007, 298623321 ], "is_adult": false, "is_preview": false, "flag": 196608, "is_service_by_shopee": false, "condition": 1, "cat_id": 100009, "has_low_fulfillment_rate": false, "is_live_streaming_price": null, "currency": "PHP", "brand": null, "brand_id": 0, "show_discount": 73, "ctime": 1677843336, "item_rating": { "rating_star": 4.6801654142921985 }, "cb_option": 0, "has_model_with_available_shopee_stock": false, "shop_location": "", "spl_info": null, "estimated_days": 1, "is_pre_order": false, "is_free_shipping": false, "overall_purchase_limit": null, "min_purchase_limit": 1, "is_hide_stock": false, "stock": null, "normal_stock": null, "current_promotion_reserved_stock": 0, "can_use_wholesale": false, "wholesale_tier_list": [], "price": 5500000, "raw_discount": 73, "hidden_price_display": null, "price_min": 5500000, "price_max": 5500000, "price_before_discount": 20000000, "price_min_before_discount": 20000000, "price_max_before_discount": 20000000, "other_stock": 0, "discount_stock": null, "current_promotion_has_reserve_stock": false, "complaint_policy": null, "show_recycling_info": false, "should_show_amp_tag": true, "all_models_has_pre_order": false, "is_item_inherited": false, "max_quantity": 4867 }, ... } ... }, ... ] 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.