Category Items

List products within a Shopee category.

Path Parameters

category_id · integer · required

The Shopee category ID to list products from. Look up IDs with /v1/shopee/categories.

Query Parameters

market · string · default: "sg"

Shopee storefront code.

Examples: sg, my, th, vn

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

category_id · integer

The category ID that was listed.

market · string

Storefront code.

results · array

Array of products in the category. Each item uses the same shape as a search Product object.

Show Product object

item_id · integer

Shopee item ID.

shop_id · integer

Shopee shop ID.

name · string

Product name.

price · number

Current price (normalized).

currency · string

ISO 4217 currency code.

rating_star · number

Average star rating (0-5).

rating_count_total · integer

Total number of ratings.

sold · integer

Recent units sold.

historical_sold · integer

All-time units sold.

image · string

Primary product image CDN URL.

shop_location · string

Seller location.

is_official_shop · boolean

Whether the seller is a Shopee official shop.

pagination · object

Pagination metadata with limit, offset, total.

Example Response

{
  "category_id": 11012345,
  "market": "sg",
  "results": [
    {
      "item_id": 23456789012,
      "shop_id": 345678,
      "name": "TWS Bluetooth Earbuds Noise Cancelling",
      "price": 29.9,
      "currency": "SGD",
      "rating_star": 4.8,
      "rating_count_total": 12480,
      "sold": 540,
      "historical_sold": 18230,
      "image": "https://cf.shopee.sg/file/abc123",
      "shop_location": "Singapore",
      "is_official_shop": true
    }
  ],
  "pagination": { "limit": 60, "offset": 0, "total": 660 }
}

Each category request costs 5 credits. Failed requests are not charged.