Shopee APIshopee.com.br ↗
Access Shopee Brazil product listings, shop profiles, customer reviews, category trees, flash sales, and search suggestions via a structured REST API.
What is the Shopee API?
This API covers 8 endpoints for Shopee Brazil (shopee.com.br), exposing product search results, detailed item data, seller profiles, customer reviews, category hierarchies, flash sale sessions, official branded shops, and search autocomplete suggestions. The get_shop_info endpoint alone returns fields like rating_star, follower_count, item_count, response_rate, and a full shop_rating breakdown for any numeric shop ID.
curl -X GET 'https://api.parse.bot/scraper/5b62a4d4-17ae-49f3-bf5e-5cf45df26edb/search_products' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace shopee-com-br-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Shopee Brazil SDK — browse official shops, search suggestions, shop details."""
from parse_apis.shopee_brazil_api import Shopee, OfficialShop, SearchSuggestion, NotFoundError
shopee = Shopee()
# List official/branded shops on Shopee Brazil
for shop in shopee.officialshops.list(limit=3):
print(shop.shop_name, shop.brand_name, shop.shopid)
# Get search keyword suggestions for a popular term
first_suggestion = shopee.searchsuggestions.search(keyword="notebook", limit=1).first()
if first_suggestion:
print(first_suggestion.keyword, first_suggestion.position, first_suggestion.catid)
# Get detailed shop info by ID
try:
detail = shopee.shops.get(shop_id="962032865")
print(detail.name, detail.rating_star, detail.follower_count, detail.item_count)
print(detail.account.username, detail.shop_rating.rating_good)
except NotFoundError as exc:
print(f"Shop not found: {exc}")
print("exercised: officialshops.list / searchsuggestions.search / shops.get")
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 API
Product and Search Data
The search_products endpoint accepts a required query string plus optional sort_by (relevancy, price, sales, rating), order (asc/desc), limit, and newest (pagination offset). It returns an items array and a total_count integer. Note that this endpoint is subject to aggressive anti-crawler protection on Shopee Brazil (error code 90309999), so availability may be intermittent. The get_product_details endpoint takes a shop_id and item_id and returns a full item object with specifications, pricing, and listing metadata. It carries the same protection caveat.
Shop and Seller Data
get_official_shops returns a paginated list of verified branded sellers — each record includes shopid, shop_name, username, logo, brand_name, entity_id, and userid. The total field reflects how many official shops are available across all pages (pagination uses limit and offset). Once you have a shopid, pass it to get_shop_info to retrieve the full seller profile: name, rating_star, follower_count, item_count, account metadata, and a shop_rating breakdown.
Reviews, Categories, and Flash Sales
get_product_comments retrieves customer reviews for any item, with a filter parameter accepting values 0 (all ratings) through 5 (five-star only), plus limit and offset for pagination. The response returns a ratings array. get_category_tree requires no inputs and returns a category_list array covering the full Shopee Brazil category hierarchy. get_flash_sale_sessions returns the current active flash sale sessions array with no input required.
Search Suggestions
get_search_hints accepts a keyword string and returns a suggestions array where each object contains keyword, catid, cat_display_name, and position. This is useful for discovering trending search terms and mapping keywords to specific category IDs available in the category tree.
The Shopee API is a managed, monitored endpoint for shopee.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when shopee.com.br changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official shopee.com.br API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor competitor pricing and sales rank on Shopee Brazil using
search_productssorted bysales. - Build a seller research tool by pulling
follower_count,rating_star, anditem_countfromget_shop_info. - Aggregate customer sentiment by filtering
get_product_commentsby star rating (1–5) for a specific product. - Map out the full Shopee Brazil taxonomy with
get_category_treeto categorize your own product catalog. - Discover trending search terms in a niche using
get_search_hintsand itscat_display_namefield for category context. - Track flash sale timing and availability by polling
get_flash_sale_sessions. - Compile a directory of verified brand storefronts on Shopee Brazil using
get_official_shopswith offset-based 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 | 100 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 Brazil have an official developer API?+
What does error 90309999 mean and which endpoints are affected?+
search_products and get_product_details are flagged as subject to aggressive anti-crawler protection on Shopee Brazil. When this protection triggers, the response carries error code 90309999 instead of the expected data. Other endpoints — get_shop_info, get_official_shops, get_category_tree, get_flash_sale_sessions, get_product_comments, and get_search_hints — do not carry this caveat.How do I paginate through official shops, and how many are available?+
get_official_shops uses limit (max observed: 20) and offset parameters. The total field in every response tells you the total number of official shops across all pages, so you can calculate how many pages to iterate. Each record includes shopid, shop_name, username, logo, brand_name, entity_id, and userid.