Tiki Product API returns one Tiki product: name, brand, description, price, original price and discount, rating, review and sold counts, availability, the full-size image gallery, specifications, configurable options and products, the current seller and other sellers, categories and breadcrumbs.
Send the id from search, or a Tiki product page url. The optional spid is the seller product id from search; pass it unchanged because it changes the buybox seller and price.
Prices are VND numbers and images are full-size URLs. A product Tiki has removed answers 404 and is free. Costs 1 credit per successful request. 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.
3 optional filters available.
integer
Optional
Product id from search, for example 278628812. Send id or url.
1234567890
string
Optional
Tiki product page url, for example https://tiki.vn/example-p278628812.html. Send id or url.
https://example.com/product
integer
Optional
Seller product id from search, for example 278630772. Pass it unchanged.
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": {
"id": "278628812",
"name": "Example phone",
"price": 12500000,
"images": [
"https://salt.tikicdn.com/media/catalog/product/example.jpg"
],
"currency": "VND",
"discount": 1500000,
"brand_name": "Example",
"categories": [],
"breadcrumbs": [],
"review_count": 213,
"discount_rate": 10.7,
"other_sellers": [],
"current_seller": {
"id": 1,
"name": "Tiki",
"price": 12500000
},
"original_price": 14000000,
"rating_average": 4.8,
"specifications": [
{
"name": "Screen",
"value": "6.5 inch"
}
],
"inventory_status": "in_stock",
"configurable_options": [],
"configurable_products": []
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "product"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Not Found
The product does not exist on Tiki. This response is not billable.
{
"meta": {
"credits": 0,
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested product was not found."
},
"success": false
}Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"id": [
"A product id or a product url is required."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Tiki could not be reached. This response is not billable.
{
"meta": {
"credits": 0,
"billable": false,
"retryable": true,
"endpoint_family": "product"
},
"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.