Query Parameters
Search keywords. Matches against product titles, brands, and attributes within the selected market.
Shopee storefront code. See /v1/shopee/markets for all supported values.Examples: sg, my, th, vn, id Number of results to return per page.
Number of results to skip (offset-based pagination). Page 2 of a 60-item page is offset=60.
sort_by
string
default:"relevancy"
Sort order for results.| Value | Description |
|---|
relevancy | Best match (default) |
ctime | Newest listings first |
sales | Best-selling first |
price_low_to_high | Cheapest first |
price_high_to_low | Most expensive first |
Response
The search keyword that was executed.
Storefront code that was searched.
Array of matching products.
Current price (normalized from Shopee’s 1e5 scale).
Original price before discount (nullable).
Discount label (e.g. "20%", nullable).
ISO 4217 currency code for the market.
Average star rating (0-5).
Primary product image CDN URL.
Whether the seller is a Shopee official shop.
Listing creation time (Unix).
Listing creation time (ISO 8601 UTC).
Pagination metadata with limit, offset, total.
Example Response
{
"keyword": "wireless earbuds",
"market": "sg",
"results": [
{
"item_id": 23456789012,
"shop_id": 345678,
"name": "TWS Bluetooth Earbuds Noise Cancelling",
"price": 29.9,
"price_min": 29.9,
"price_max": 39.9,
"price_before_discount": 49.9,
"discount": "40%",
"currency": "SGD",
"rating_star": 4.8,
"rating_count_total": 12480,
"stock": 320,
"sold": 540,
"historical_sold": 18230,
"liked_count": 2104,
"image": "https://cf.shopee.sg/file/abc123",
"shop_location": "Singapore",
"is_official_shop": true,
"ctime_utc": 1716960000,
"created_at": "2026-05-29T00:00:00Z"
}
],
"pagination": { "limit": 60, "offset": 0, "total": 480 }
}
Each search request costs 5 credits. Failed requests are not charged.
