Search Products

Query Parameters

string

required

Search keywords. Matches against product titles, brands, and attributes within the selected market.

string

default:"sg"

Shopee storefront code. See /v1/shopee/markets for all supported values.Examples: sg, my, th, vn, id

integer

default:60

Number of results to return per page.

integer

default:0

Number of results to skip (offset-based pagination). Page 2 of a 60-item page is offset=60.

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

string

The search keyword that was executed.

string

Storefront code that was searched.

array

Array of matching products.

Show Product object

integer

Shopee item ID.

integer

Shopee shop ID.

string

Product name.

number

Current price (normalized from Shopee’s 1e5 scale).

number

Lowest variant price.

number

Highest variant price.

number

Original price before discount (nullable).

string

Discount label (e.g. "20%", nullable).

string

ISO 4217 currency code for the market.

number

Average star rating (0-5).

integer

Total number of ratings.

integer

Available stock.

integer

Recent units sold.

integer

All-time units sold.

integer

Number of likes.

string

Primary product image CDN URL.

string

Seller location.

boolean

Whether the seller is a Shopee official shop.

integer

Listing creation time (Unix).

string

Listing creation time (ISO 8601 UTC).

object

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.

Overview

Search

Products

Categories

Reference

Query Parameters

Response

Example Response

​Query Parameters

​Response

​Example Response

Query Parameters

Response

Example Response