> ## Documentation Index
> Fetch the complete documentation index at: https://scrapebadger-feat-flights-booking-options.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Products

> Search the Shopee catalog with sorting and pagination.

## Query Parameters

<ParamField query="keyword" type="string" required>
  Search keywords. Matches against product titles, brands, and attributes within the selected market.
</ParamField>

<ParamField query="market" type="string" default="sg">
  Shopee storefront code. See [`/v1/shopee/markets`](/api-reference/endpoint/shopee/list-markets) for all supported values.

  Examples: `sg`, `my`, `th`, `vn`, `id`
</ParamField>

<ParamField query="limit" type="integer" default={60}>
  Number of results to return per page.
</ParamField>

<ParamField query="offset" type="integer" default={0}>
  Number of results to skip (offset-based pagination). Page 2 of a 60-item page is `offset=60`.
</ParamField>

<ParamField query="sort_by" type="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  |
</ParamField>

## Response

<ResponseField name="keyword" type="string">The search keyword that was executed.</ResponseField>
<ResponseField name="market" type="string">Storefront code that was searched.</ResponseField>

<ResponseField name="results" type="array">
  Array of matching products.

  <Expandable title="Product object">
    <ResponseField name="item_id" type="integer">Shopee item ID.</ResponseField>
    <ResponseField name="shop_id" type="integer">Shopee shop ID.</ResponseField>
    <ResponseField name="name" type="string">Product name.</ResponseField>
    <ResponseField name="price" type="number">Current price (normalized from Shopee's 1e5 scale).</ResponseField>
    <ResponseField name="price_min" type="number">Lowest variant price.</ResponseField>
    <ResponseField name="price_max" type="number">Highest variant price.</ResponseField>
    <ResponseField name="price_before_discount" type="number">Original price before discount (nullable).</ResponseField>
    <ResponseField name="discount" type="string">Discount label (e.g. `"20%"`, nullable).</ResponseField>
    <ResponseField name="currency" type="string">ISO 4217 currency code for the market.</ResponseField>
    <ResponseField name="rating_star" type="number">Average star rating (0-5).</ResponseField>
    <ResponseField name="rating_count_total" type="integer">Total number of ratings.</ResponseField>
    <ResponseField name="stock" type="integer">Available stock.</ResponseField>
    <ResponseField name="sold" type="integer">Recent units sold.</ResponseField>
    <ResponseField name="historical_sold" type="integer">All-time units sold.</ResponseField>
    <ResponseField name="liked_count" type="integer">Number of likes.</ResponseField>
    <ResponseField name="image" type="string">Primary product image CDN URL.</ResponseField>
    <ResponseField name="shop_location" type="string">Seller location.</ResponseField>
    <ResponseField name="is_official_shop" type="boolean">Whether the seller is a Shopee official shop.</ResponseField>
    <ResponseField name="ctime_utc" type="integer">Listing creation time (Unix).</ResponseField>
    <ResponseField name="created_at" type="string">Listing creation time (ISO 8601 UTC).</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata with `limit`, `offset`, `total`.
</ResponseField>

### Example Response

```json theme={null}
{
  "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 }
}
```

<Note>
  Each search request costs **5 credits**. Failed requests are not charged.
</Note>