v1
latestOpenAPI 3.0.02026-07-13806.5 KBSearch products by keyword with full-text search
Query parameters
Keyword search query (full-text)
Filter by merchant platform (e.g. lazada, shopee)
Filter by region (sea, us, eu, au)
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.
Minimum price in the active currency (inferred from country_code or explicit currency param)
Maximum price in the active currency (inferred from country_code or explicit currency param)
Explicit currency override. If omitted and country_code is set, currency is inferred from country_code.
Return minimal payload for AI agents (id, title, price, currency, url, specs)
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)