Tiki Search API searches products on Tiki in Vietnam. Each card has the id, sku, name, brand, price, original price, list price, discount amount and rate, rating, review count, sold count, seller ids, full-size image and product url.
Filter by price range, brand id, rating, sort order and category id. Get category ids from the Categories API and brand ids from data.filters.brands of an earlier search. Every item in the answer follows the filters you send. Page N returns the real page N with 40 results per page, up to page 50.
Prices are numbers in VND. The id and seller product id feed the Product and Reviews APIs unchanged. Costs 1 credit per successful request. Empty results and failed requests are free.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
8 optional filters available.
string
Optional
Search text, for example dien thoai. Required unless you send a category.
coffee shops
integer
Optional
Category id from the Categories API. Required unless you send a query.
10
integer
Optional
One-based page number, 1 to 50 (default 1).
1
string
Optional
One of default, top_seller, newest, price_asc or price_desc.
relevance
number
Optional
Lowest price in VND.
10
number
Optional
Highest price in VND.
10
integer
Optional
Brand id.
10
integer
Optional
Minimum rating, 1 to 5.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"query": "dien thoai",
"filters": {
"sorts": [
"default",
"top_seller",
"newest",
"price,asc",
"price,desc"
],
"brands": [
{
"id": "42",
"name": "Example"
}
],
"categories": [
{
"id": "1789",
"name": "Dien thoai"
}
]
},
"results": [
{
"id": "278628812",
"sku": "SKU-123",
"name": "Example phone",
"price": 12500000,
"brand_id": 42,
"currency": "VND",
"discount": 1500000,
"url_path": "https://tiki.vn/example-p278628812.html",
"seller_id": 1,
"brand_name": "Example",
"list_price": 15000000,
"availability": true,
"review_count": 213,
"discount_rate": 10.7,
"quantity_sold": 1200,
"thumbnail_url": "https://salt.tikicdn.com/ts/product/example.jpg",
"original_price": 14000000,
"rating_average": 4.8,
"seller_product_id": 278630772
}
],
"category": null,
"currency": "VND",
"pagination": {
"page": 1,
"has_next": true,
"per_page": 40,
"total_results": 5000
}
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "search"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"query": [
"A search text or a category id is required."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Tiki could not be reached. This response is not billable. Retry shortly.
{
"meta": {
"credits": 0,
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Tiki could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.