Skip to main content
GET
Search Public Merchant Products

Query Parameters

currency
string

ISO currency code. Required for price ranges and price sorting; no cross-currency ranking or conversion.

Pattern: ^[A-Z]{3}$
min_rating
number

Minimum average imported product review rating. Unrated products do not match; not a marketplace-wide lifetime rating.

Required range: 1 <= x <= 5
min_review_count
integer

Minimum number of imported rated product reviews.

Required range: 1 <= x <= 1000000
added_after
string<date-time>

Inclusive catalog creation timestamp with time zone. Does not mean product release date.

variant_options
string

JSON array of 1-5 exact, case-insensitive option pairs, e.g. [{"name":"Color","value":"Red"}]. All options must match the same variant.

q
string

Natural-language search query.

Maximum string length: 300
category
string

Optional category-name filter.

Maximum string length: 120
brand
string

Optional brand filter.

Maximum string length: 120
min_price
number

Minimum catalogPrice in the requested currency (inclusive). Requires currency.

Required range: x >= 0
max_price
number

Maximum catalogPrice in the requested currency (inclusive). Requires currency.

Required range: x >= 0
in_stock
boolean

Filter by stock availability.

merchant_ids
string

Comma-separated merchant IDs to scope the search.

sort
enum<string>
default:relevance

Sort by relevance, newest catalog addition, catalog price, imported average rating, or review count. Price sorting requires currency; most_reviewed is not best selling.

Available options:
relevance,
newest,
price_asc,
price_desc,
rating_desc,
most_reviewed
platform
enum<string>

Marketplace platform filter.

Available options:
shopee,
lazada,
tiktok,
shopify,
whatsapp,
zalora,
amazon,
ebay
country
string

Marketplace country hint (example: sg).

language
enum<string>
default:en

Localization language. Defaults to en.

Available options:
en,
th,
id,
ms,
vi,
tl
include_intent
boolean

Include lightweight parsed query intent metadata.

limit
integer
default:20

Result limit (1..100). Defaults to 20.

Required range: 1 <= x <= 100
offset
integer
default:0

Pagination offset (0..10000). Defaults to 0.

Required range: 0 <= x <= 10000

Response

Success

ok
boolean
apiVersion
string
default:public_search_v1