Skip to main content
GET
Search Within Public Merchant Catalog

Path Parameters

​
merchantId
string
required

Query Parameters

​
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 listed price.

​
max_price
number

Maximum listed price.

​
in_stock
boolean

Filter by stock availability.

​
sort
enum<string>
default:relevance

Sort order.

Available options:
relevance,
price_asc,
price_desc
​
platform
enum<string>

Marketplace platform filter.

Available options:
shopee,
lazada
​
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:merchant_search_v1