shopee.ph APIshopee.ph ↗
Access Shopee Philippines shop profiles, search suggestions, and trending item previews via a structured API. 7 endpoints covering seller ratings, item counts, and more.
curl -X GET 'https://api.parse.bot/scraper/6e392256-3411-4800-ab21-22fc3bfefa95/search_products?limit=5&query=phone' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Shopee Philippines. NOTE: This endpoint currently requires authentication (Shopee login) and will return an error for unauthenticated requests.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max results per page |
| queryrequired | string | Search keyword |
| offset | integer | Pagination offset |
{
"type": "object",
"fields": {
"status": "string",
"message": "string"
},
"sample": {
"status": "error",
"message": "This endpoint requires authentication. Shopee PH now requires login to access this data."
}
}About the shopee.ph API
The Shopee Philippines API provides 7 endpoints for accessing public marketplace data from shopee.ph. The get_search_suggestions endpoint returns autocomplete queries along with associated item IDs, images, and shop IDs for each suggestion, while get_shop_info exposes a seller's star rating, follower count, response rate, item count, and verification status — all without requiring a Shopee login.
What the API Covers
Two endpoints are fully operational without authentication. get_search_suggestions accepts a query string and returns an array of suggestion objects, each containing the suggestion text, a hint label, associated item_ids, images, and shop_ids. The has_more boolean indicates whether additional suggestion pages exist. get_shop_info accepts a numeric shop_id and returns a detailed seller profile including name, username, country, item_count, rating_star (1–5 scale), and individual rating breakdowns (rating_good, rating_normal, rating_bad).
Authentication-Required Endpoints
Five endpoints — search_products, get_product_details, get_product_reviews, get_shop_products, and get_category_tree — currently require a Shopee login session and will return an error status for unauthenticated requests. Their response shapes expose only a status string and a message string at this time. These endpoints exist in the spec and will return data once authentication requirements change.
Pagination and Identifiers
Endpoints that support pagination accept limit and offset integer parameters. Shop and product identifiers on Shopee follow a two-part scheme: a shop_id and an item_id are both required for product-level lookups. get_search_suggestions conveniently returns shop_ids and item_ids alongside each suggestion, making it useful for seeding downstream product or shop lookups.
Official Shopee Developer Program
Shopee operates an official Open Platform API (open.shopee.com) aimed at merchants and logistics partners. That platform targets sellers managing orders and inventory, not general marketplace data retrieval. The Parse API surfaces public-facing data independently of that merchant program.
- Monitor a competitor shop's total item count and star rating over time using
get_shop_info - Build a search autocomplete feature backed by Shopee's own suggestion data via
get_search_suggestions - Collect trending item IDs and preview images from search suggestions for market research
- Audit seller verification status and response rate for a list of shop IDs
- Seed a product watchlist using item IDs and shop IDs returned from search suggestions
- Track changes in a shop's
rating_goodvsrating_badcounts to detect reputation shifts - Populate a shop directory with
name,country,description, anditem_countfromget_shop_info
| 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_shop_info` actually return beyond a star rating?+
get_shop_info returns the shop's name, username, shopid, country, description, item_count, rating_star (a decimal on a 1–5 scale), and three raw rating counts: rating_good, rating_normal, and rating_bad. These let you compute rating distributions rather than relying on the aggregate star score alone.Can I retrieve product prices or inventory levels through this API?+
get_product_details, which requires authentication and currently returns only a status and message. You can fork this API on Parse and revise it to add authenticated product detail retrieval once you have a valid session.What are the limitations of the `get_search_suggestions` endpoint?+
get_search_suggestions returns suggestion text, item IDs, shop IDs, and preview images, but does not include prices, review counts, or sales figures for the suggested items. The has_more boolean indicates additional suggestions exist, but the endpoint does not expose an offset parameter for paginating through them.