Shopee 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.
What is the Shopee 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.
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'
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-ph-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 Philippines SDK — search suggestions and shop profiles."""
from parse_apis.shopee_philippines_api import Shopee, Shop, Suggestion, NotFoundError
shopee = Shopee()
# Search for keyword suggestions — limit caps total items fetched
for suggestion in shopee.suggestions.search(query="laptop", limit=5):
print(suggestion.text, suggestion.shop_ids, suggestion.item_ids)
# Drill down: take the first suggestion and look up its associated shop
first_suggestion = shopee.suggestions.search(query="phone", limit=1).first()
if first_suggestion:
shop_id = str(first_suggestion.shop_ids[0])
try:
shop = shopee.shops.get(shop_id=shop_id)
print(shop.name, shop.rating_star, shop.follower_count)
print(shop.shop_location, shop.is_official_shop, shop.response_rate)
except NotFoundError as exc:
print(f"Shop not found: {exc}")
print("exercised: suggestions.search / shops.get")
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 API
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.
The Shopee API is a managed, monitored endpoint for shopee.ph — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when shopee.ph 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.ph 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 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 | 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 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.