Search Products

Query Parameters

keyword

string

required

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

market

string

default:"sg"

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

limit

integer

default:60

Number of results to return per page.

offset

integer

default:0

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

keyword

string

The search keyword that was executed.

market

string

Storefront code that was searched.

results

array

Array of matching products.

Show Product object

item_id

integer

Shopee item ID.

shop_id

integer

Shopee shop ID.

name

string

Product name.

price

number

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

price_min

number

Lowest variant price.

price_max

number

Highest variant price.

price_before_discount

number

Original price before discount (nullable).

discount

string

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

currency

string

ISO 4217 currency code for the market.

rating_star

number

Average star rating (0-5).

rating_count_total

integer

Total number of ratings.

stock

integer

Available stock.

sold

integer

Recent units sold.

historical_sold

integer

All-time units sold.

liked_count

integer

Number of likes.

image

string

Primary product image CDN URL.

shop_location

string

Seller location.

is_official_shop

boolean

Whether the seller is a Shopee official shop.

ctime_utc

integer

Listing creation time (Unix).

created_at

string

Listing creation time (ISO 8601 UTC).

pagination

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