shopee.vn APIshopee.vn ↗
Access Shopee Vietnam product listings, shop profiles, search results, and autocomplete suggestions via 4 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/f88dd171-7333-4da5-8a3e-03ff6573d062/get_search_suggestions?keyword=iPhone' \ -H 'X-API-Key: $PARSE_API_KEY'
Get search suggestions for a given keyword. Returns suggested queries with associated item IDs, shop IDs, images, and hint text. Useful for discovering popular items and shops related to a search term.
| Param | Type | Description |
|---|---|---|
| keywordrequired | string | Search keyword prefix to get suggestions for. |
{
"type": "object",
"fields": {
"data": "object containing queries array with suggestion items, has_more boolean, and session metadata",
"error": "null on success",
"bff_meta": "null",
"error_msg": "null on success"
},
"sample": {
"data": {
"data": {
"queries": [
{
"id": null,
"pic": [
"6cbcc1172168fa87bb6225ed2ebe0ebf"
],
"hint": "Kính Gương",
"text": "Kính Gương",
"count": null,
"image": "6cbcc1172168fa87bb6225ed2ebe0ebf",
"images": [
"6cbcc1172168fa87bb6225ed2ebe0ebf"
],
"item_ids": [
29112981443
],
"shop_ids": [
365272393
],
"icon_code": 0,
"query_labels": "",
"rewrite_keyword": ""
}
],
"has_more": true,
"refresh_interval_sec": 360
},
"error": null,
"bff_meta": null,
"error_msg": null
},
"status": "success"
}
}About the shopee.vn API
The Shopee Vietnam API provides 4 endpoints covering product search, product detail retrieval, shop profile lookups, and search suggestions from shopee.vn. The get_shop_info endpoint returns follower counts, rating stars, response rates, and item counts for any shop by numeric ID, while search_products lets you paginate through results by keyword with sort controls for price, sales, or relevancy.
What the API covers
Four endpoints expose the core data surfaces of shopee.vn: product search, product detail, shop profile, and search suggestions. search_products accepts a keyword and optional parameters — by (relevancy, price, sales, rating), order (asc/desc), limit, and offset — and returns an items array alongside a total count for pagination. get_product_detail takes both item_id and shop_id and returns a full item object including pricing, description, and variant data.
Shop and discovery endpoints
get_shop_info retrieves a shop's profile by numeric shop_id, returning structured fields: shopid, name, follower_count, rating_star, item_count, response_rate, and configuration details. This is useful for profiling sellers or filtering by merchant quality signals. get_search_suggestions takes a keyword prefix and returns a queries array of suggested search terms, each enriched with associated item_ids, shop_ids, and hint images — handy for building autocomplete or discovering trending queries in a category.
Known limitations
Two endpoints — search_products and get_product_detail — may return error code 90309999, which indicates an anti-bot block. This occurs when requests are not associated with an authenticated session. Results from these endpoints should be treated as potentially unavailable during high-restriction periods. Pagination on search_products is handled through the offset parameter; there is no cursor-based mechanism.
- Track competitor pricing on Shopee Vietnam by polling
search_productswith category keywords and sorting by price - Build a seller research tool using
get_shop_infofields likerating_star,follower_count, andresponse_rate - Power autocomplete in a Vietnamese shopping assistant using
get_search_suggestionsquery arrays and hint images - Monitor product availability and detail changes by periodically calling
get_product_detailwith knownitem_idandshop_idpairs - Aggregate top-selling products in a niche by querying
search_productssorted bysalesdescending - Identify high-follower shops by extracting
follower_countanditem_countfrom bulkget_shop_infolookups
| 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 developer API?+
What does `get_search_suggestions` return beyond a list of query strings?+
queries array includes associated item_ids and shop_ids linked to that suggestion, plus image references and hint text. This means you can use a single call to surface both query completions and candidate items or shops without a separate search call.Why do `search_products` and `get_product_detail` sometimes fail with error 90309999?+
Does the API return product reviews or ratings for individual items?+
Can I retrieve a full list of items belonging to a specific shop?+
get_shop_info returns aggregate shop metadata such as item_count, but not individual product listings for that shop. You can fork this API on Parse and revise it to add a shop-level product listing endpoint.