hasaki.vn APIhasaki.vn ↗
Access Hasaki.vn's beauty and skincare catalog via API. Search products, fetch reviews, browse brands, categories, flash deals, and autocomplete suggestions.
curl -X GET 'https://api.parse.bot/scraper/bf606614-615b-4332-9217-888820291bae/search_products?page=1&size=3&query=kem+ch%E1%BB%91ng+n%E1%BA%AFng' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword using the mobile API. Returns paginated product results with metadata including total count and filters.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| size | integer | Number of results per page. |
| queryrequired | string | Search keyword (e.g. 'kem chống nắng'). |
{
"type": "object",
"fields": {
"products": "array of product objects with id, name, price, brand, image, rating, etc.",
"meta_data": "object containing products_total, sort_params, and filter options"
},
"sample": {
"data": {
"products": [
{
"id": 102959,
"sku": "422208973",
"name": "Sữa Rửa Mặt CeraVe Sạch Sâu Cho Da Thường Đến Da Dầu 473ml",
"brand": {
"name": "CeraVe"
},
"image": "https://media.hcdn.vn/catalog/product/p/r/special-deal-sua-rua-mat-cerave.png",
"price": 360000,
"rating": {
"total": 116,
"average": 4.9
},
"market_price": 490000,
"discount_percent": 27
}
],
"meta_data": {
"products_total": 500
}
},
"status": "success"
}
}About the hasaki.vn API
The Hasaki.vn API exposes 12 endpoints covering Hasaki's Vietnamese beauty and skincare catalog, including product search, detailed product pages, customer reviews, Q&A threads, brand listings, category trees, flash deals, best sellers, and new arrivals. The get_product_reviews endpoint alone returns per-review star ratings, user info, images, and aggregate rating distributions, while get_search_autocomplete delivers keyword, product, category, and brand matches from a single partial query.
Product Discovery and Search
The search_products endpoint accepts a query string (e.g. 'kem chống nắng') and returns paginated product arrays alongside a meta_data object containing products_total, sort parameters, and available filters. Pagination is controlled via page and size parameters. For browsing without a keyword, get_category_products and get_brand_products accept a slug parameter and support four sort orders: position, topsale, price_asc, and price_desc. Both return filter arrays with grouped filter options, making it straightforward to surface facet data for a given category or brand.
Product Detail, Reviews, and Q&A
get_product_detail takes a numeric product_id and returns a blocks array covering product descriptions, variants, deal information, and related products. Customer sentiment data comes from two separate endpoints: get_product_reviews returns a rating object with avg_rate, total count, and per-star distribution, plus a paginated reviews array with content, user details, images, and timestamps. Reviews can be sorted by create, best, worst, or buy, and filtered by star count or image presence. get_product_qa retrieves the Vietnamese Hỏi đáp Q&A section, including sub_comments that contain staff replies, with comments_total in the metadata.
Brands, Categories, and Promotions
get_brands_list returns all brands alphabetically grouped, each entry including name and URL slug. get_categories returns the full hierarchical category tree as a blocks array that includes the navigation topBar, banners, and customer info blocks. Flash Deal data is available through get_flash_deals, which returns deal_products with discount_percent and deal countdown fields; the optional key parameter selects a specific deal period (e.g. 'deal08'). get_best_sellers and get_new_arrivals both accept an optional category slug to narrow results and return the same product object shape alongside products_total metadata.
- Build a Vietnamese skincare product comparison tool using price, brand, and rating fields from
search_products - Track flash deal discounts and countdown timers across product categories using
get_flash_deals - Aggregate customer review sentiment and star distributions for beauty products via
get_product_reviews - Populate a category navigation tree with banner data for a Hasaki-mirrored storefront using
get_categories - Monitor new arrivals in a specific skincare category by polling
get_new_arrivalswith a categoryslug - Build a brand directory for Vietnamese beauty products using
get_brands_listalphabetical groupings - Implement search-as-you-type with keyword, product, and brand suggestions from
get_search_autocomplete
| 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 Hasaki.vn have an official public developer API?+
What does `get_product_reviews` return, and how can reviews be filtered?+
rating object with avg_rate, a total review count, and a breakdown by star level (1–5), plus a paginated reviews array where each item includes review text, username, star rating, uploaded images, and created_at timestamp. You can filter using the filter parameter with values like filter_5_star, filter_has_image, or filter_all, and sort with create, best, worst, or buy.Does the API return inventory or stock availability data?+
How does `get_flash_deals` handle multiple deal periods?+
key parameter that selects a specific deal period, for example 'deal08'. Omitting it returns the default active deal period. Each product in deal_products includes discount_percent and countdown fields indicating when the deal expires. The filters array provides category options to narrow results within the active deal.Are individual product ingredients or detailed cosmetic formulation data available?+
get_product_detail returns content blocks covering descriptions, variants, and related products, but structured ingredient lists or formulation tables are not broken out as discrete fields. You can fork this API on Parse and revise it to parse and expose ingredient data from within the product content blocks.