tiki.vn APItiki.vn ↗
Access Tiki.vn product listings, reviews, category browsing, and seller data via 6 structured endpoints. Prices in VND, paginated results, rating filters.
curl -X GET 'https://api.parse.bot/scraper/aedb7e16-79f1-4fd4-b7fc-1cd7bbb7fec8/search_products?page=1&sort=default&limit=5&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Tiki.vn. Returns paginated results with product summaries including price, rating, seller, and thumbnail.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number. |
| sort | string | Sort order. Accepted values: default, top_seller, price_asc, price_desc, newest. |
| limit | integer | Number of items per page. |
| queryrequired | string | Search keyword. |
{
"type": "object",
"fields": {
"data": "array of product summary objects with id, name, price, rating_average, seller_name, thumbnail_url, etc.",
"paging": "object with total, per_page, current_page, last_page, from, to"
},
"sample": {
"data": {
"data": [
{
"id": 279217929,
"name": "Laptop Dell 14 DC14250",
"price": 20999000,
"seller_id": 1,
"brand_name": "Dell",
"seller_name": "Tiki Trading",
"review_count": 0,
"discount_rate": 16,
"thumbnail_url": "https://salt.tikicdn.com/cache/280x280/ts/product/ed/f0/75/7762164f9ccde47bc3c898f16c028f77.jpg",
"original_price": 24990000,
"rating_average": 0
}
],
"paging": {
"to": 5,
"from": 1,
"total": 2000,
"per_page": 5,
"last_page": 400,
"current_page": 1
}
},
"status": "success"
}
}About the tiki.vn API
The Tiki.vn API provides 6 endpoints covering product search, detailed product data, category listings, customer reviews, and seller profiles from one of Vietnam's largest e-commerce platforms. The get_product_details endpoint returns price in VND, HTML product description, specification groups, multiple image sizes, and current seller information — all in a single call. Other endpoints let you browse by category, filter by price range or minimum rating, and pull paginated customer reviews with images.
Product Search and Category Browsing
The search_products endpoint accepts a query string and returns an array of product summaries — each including id, name, price, rating_average, seller_name, and thumbnail_url — along with a paging object (total, current_page, last_page, per_page). Sort order is controlled by the sort parameter, which accepts default, top_seller, price_asc, price_desc, or newest. The get_products_by_category endpoint mirrors this structure but takes a category_id (for example, 1846 for Laptop & Computer) and adds price_min, price_max, and rating filter parameters, making it useful for scoped catalog retrieval.
Product Details and Specifications
get_product_details requires a product_id and optionally a spid (seller product ID) for variant-specific pricing. The response includes current_seller (with seller id, name, price, and logo), original_price for discount comparison, an images array with base_url, large_url, medium_url, and thumbnail_url variants, and a specifications array of grouped attribute objects. The description field returns HTML content directly from the product page.
Reviews and Seller Data
get_product_reviews returns paginated review objects with title, content, rating, images, created_by, and timeline fields, plus top-level reviews_count and rating_average (0–5 scale). An optional spid parameter narrows results to a specific variant, and seller_id filters reviews by seller. For seller-level data, get_seller_info returns a data object with store details and a product list, while get_products_by_seller provides a paginated product summary list for a given seller_id.
- Track VND price changes on specific Tiki products by polling
get_product_detailswith aproduct_id. - Build a category price comparison tool using
get_products_by_categorywithprice_min,price_max, andsortfilters. - Aggregate customer sentiment by fetching review
content,rating, andimagesfromget_product_reviews. - Identify top-rated products in a category by filtering with the
ratingparameter set to 4 or 5. - Compare sellers offering the same product by combining
get_product_details(forcurrent_seller) withget_seller_info. - Build a seller catalog browser using
get_products_by_sellerto list all products from a givenseller_id. - Pull specification data from
get_product_detailsto populate structured product comparison tables.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Tiki.vn have an official public developer API?+
What does `get_product_reviews` return beyond just review text?+
id, title, content, rating, an images array, a created_by object with reviewer info, and a timeline field. The top-level response also includes reviews_count (total integer count) and rating_average (float, 0–5). You can filter by seller_id or spid to scope reviews to a specific seller or product variant.Are flash-sale or time-limited promotional prices returned?+
price field in get_product_details reflects the current listed price at query time, and original_price is included for discount comparison. Whether a price reflects an active flash sale depends on Tiki's live catalog state at the moment of the request — the API does not return a separate flash-sale price field or countdown metadata. You can fork this API on Parse and revise it to add a dedicated promotional-pricing endpoint if needed.Can I retrieve order history, cart data, or user account information?+
How should I paginate through large category or search result sets?+
search_products, get_products_by_category, get_products_by_seller) return a paging object with total, per_page, current_page, last_page, from, and to fields. Increment the page parameter and use last_page as the stop condition. The limit parameter controls page size.