shopee.com.br APIshopee.com.br ↗
Access Shopee Brazil product search, details, reviews, shop profiles, category tree, flash sales, and search hints via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/5b62a4d4-17ae-49f3-bf5e-5cf45df26edb/search_products' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Shopee Brazil. Note: Subject to aggressive anti-crawler protection (error 90309999).
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of items to return |
| order | string | Sort order (asc/desc) |
| queryrequired | string | Search keyword |
| newest | integer | Offset for pagination |
| sort_by | string | Sort criteria (relevancy, price, sales, rating) |
{
"type": "object",
"fields": {
"items": "array",
"total_count": "integer"
},
"sample": {
"items": [
{
"name": "Camisa de Time",
"price": 5000000,
"itemid": 123,
"shopid": 456
}
],
"total_count": 100
}
}About the shopee.com.br API
The Shopee Brazil API covers 8 endpoints across shopee.com.br, letting you retrieve product listings, detailed item data, shop profiles, customer reviews, flash sale sessions, and autocomplete suggestions. The get_product_details endpoint returns a full item object including specifications and pricing, while get_official_shops exposes paginated brand storefronts with IDs you can feed into get_shop_info for seller-level metrics.
Product and Shop Data
The search_products endpoint accepts a required query string plus optional sort_by (relevancy, price, sales, rating), order (asc/desc), limit, and newest offset for pagination. It returns an items array and a total_count integer. For full item details, get_product_details takes a paired item_id and shop_id and returns a single item object. Note that both endpoints are subject to Shopee's anti-crawler protection (error 90309999), which can result in blocked responses depending on query patterns.
Reviews, Categories, and Suggestions
get_product_comments retrieves customer reviews for a specific product, accepting item_id, shop_id, an optional filter value (0 for all, 1–5 to filter by star rating), plus limit and offset for pagination — it returns a ratings array. get_category_tree requires no inputs and returns a category_list array representing the full category hierarchy on shopee.com.br. get_search_hints accepts a keyword and returns a suggestions array where each object includes keyword, catid, cat_display_name, and position.
Official Shops and Flash Sales
get_official_shops returns a paginated list of verified brand storefronts — each object includes shopid, shop_name, username, logo, brand_name, and entity_id. The total integer tells you how many official shops exist. Pass a shopid from that response into get_shop_info to get seller-level fields: rating_star, follower_count, item_count, and full shop_rating breakdown. get_flash_sale_sessions takes no inputs and returns a sessions array of current promotional sale windows.
Anti-Crawler Limitations
Shopee Brazil employs aggressive anti-bot measures. The endpoints most affected are search_products, get_product_details, get_product_comments, get_category_tree, and get_flash_sale_sessions. When the protection triggers, responses return error code 90309999 instead of data. Plan for retry logic or graceful error handling when integrating these endpoints.
- Monitor competitor pricing on Shopee Brazil by polling
search_productssorted by price and tracking item fields over time. - Build a seller intelligence dashboard using
get_shop_infofields likerating_star,follower_count, anditem_count. - Populate an autocomplete widget for a Shopee-focused search tool using
get_search_hintskeyword suggestions. - Map the full Shopee Brazil catalog structure with
get_category_treeto classify or index products by category. - Aggregate and analyze customer sentiment by pulling star-filtered reviews from
get_product_commentswith thefilterparameter. - Identify flash sale opportunities by querying
get_flash_sale_sessionsto list active promotional windows. - Enumerate verified brand stores on Shopee Brazil using
get_official_shopswithoffsetandlimitfor full pagination.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Shopee have an official public developer API?+
What does `get_shop_info` return beyond a shop name?+
get_shop_info returns a data object containing shopid, name, rating_star, follower_count, item_count, account-level info, and a shop_rating breakdown. You need a valid shop_id to call it — the shopid field from get_official_shops is a direct source for that value.How reliable are the product search and detail endpoints given the anti-crawler protection?+
search_products, get_product_details, get_product_comments, get_category_tree, and get_flash_sale_sessions. get_official_shops, get_shop_info, and get_search_hints are generally more stable. Building in retry logic and monitoring for 90309999 error codes in responses is advisable.Can I retrieve individual product variants or seller shipping options?+
item object from get_product_details and an items array from search_products, but variant-level SKU breakdowns and shipping cost data are not exposed as distinct fields in the current endpoints. You can fork this API on Parse and revise it to extract those fields if they appear in the item response.Is there a way to browse flash sale products, not just the sale sessions?+
get_flash_sale_sessions returns a sessions array describing the active promotional windows but does not enumerate the individual products within each session. You can fork this API on Parse and revise it to add a flash sale items endpoint that accepts a session ID.