v1

latestOpenAPI 3.0.02026-07-13806.5 KB

Search products by keyword with full-text search

get/products/search

Query parameters

qstring

Keyword search query (full-text)

domainstring

Filter by merchant platform (e.g. lazada, shopee)

regionstring

Filter by region (sea, us, eu, au)

country_code'SG' | 'US' | 'VN' | 'TH' | 'MY'

Filter by ISO country code. When provided without an explicit currency param, the default currency is inferred (SG→SGD, US→USD, VN→VND, TH→THB, MY→MYR). min_price/max_price apply in the inferred currency. Default: SG.

min_pricenumber

Minimum price in the active currency (inferred from country_code or explicit currency param)

max_pricenumber

Maximum price in the active currency (inferred from country_code or explicit currency param)

currencystring

Explicit currency override. If omitted and country_code is set, currency is inferred from country_code.

compactboolean

Return minimal payload for AI agents (id, title, price, currency, url, specs)

limitinteger
offsetinteger
mode'keyword' | 'semantic' | 'hybrid'

Search mode. keyword (default) is full-text search on the indexed search_vector. semantic uses the Jina v3 query embedding against the pgvector pool, and hybrid RRF-merges the FTS and semantic candidate ranks. If vector infrastructure is unavailable, semantic and hybrid fall back to the keyword path.

Response

Product list with meta (total, response_time_ms, cached, mode)