Tiki APItiki.vn ↗
Access Tiki.vn product listings, reviews, category browsing, and seller data via 6 structured endpoints. Prices in VND, paginated results, rating filters.
What is the Tiki 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace tiki-vn-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Tiki.vn SDK — search products, drill into details, read reviews."""
from parse_apis.tiki_vn_api import Tiki, Sort, ProductNotFound
client = Tiki()
# Search for laptops sorted by top sellers, capped at 5 results.
for product in client.products.search(query="laptop", sort=Sort.TOP_SELLER, limit=5):
print(product.name, product.price, product.rating_average)
# Drill into the first result for full details (description, images, specs).
product = client.products.search(query="laptop", limit=1).first()
if product:
print(product.name, product.original_price, product.discount_rate)
# Walk the product's reviews sub-resource.
for review in product.reviews.list(limit=3):
print(review.title, review.rating, review.created_by.name)
# Browse a category — Laptop & Computer (1846), sorted by price ascending.
for item in client.products.by_category(category_id="1846", sort=Sort.PRICE_ASC, limit=3):
print(item.name, item.price, item.seller_name)
# Construct a Seller from a known ID and list their products.
seller = client.seller(id=1)
for p in seller.products(limit=3):
print(p.name, p.price, p.review_count)
# Typed error handling: catch a not-found product.
try:
missing = client.products.search(query="nonexistent_zzz_xyz_000", limit=1).first()
except ProductNotFound as exc:
print(f"Product not found: {exc.product_id}")
print("exercised: products.search / products.by_category / product.reviews.list / seller.products")
Full-text search over Tiki.vn product listings. Returns paginated results with product summaries including price, rating, seller, and thumbnail. Paginates via page number; each page returns up to `limit` items.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number. |
| sort | string | Sort order. |
| 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": 21500000,
"seller_id": 1,
"brand_name": "Dell",
"seller_name": "Tiki Trading",
"review_count": 0,
"discount_rate": 14,
"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 API
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.
The Tiki API is a managed, monitored endpoint for tiki.vn — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tiki.vn changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official tiki.vn API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.