Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Klook API page →
docs / klook
Klook
Asian activities, attraction tickets and experiences, with packages, reviews and the price in the currency you ask for.
base /klook/v19 endpoints
post
/klook/v1/activities/search2 creditsSearch or browse Klook activities by keyword and/or destination, with category, price, date, instant-confirmation and sort filters. Every filter here was proved to change the result count against a same-run unfiltered control; filters Klook silently ignores are not offered.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Free text — a place, an attraction, a product type. Klook's search is fuzzy and typo-tolerant, so a nonsense term can still return a handful of weak matches; the count returned is Klook's own. |
| destination_id | optional | — | A city or country id AS RETURNED BY destinations/resolve in its search_location_id field. A country's own id is NOT accepted here (Klook offsets countries by 1000) and silently returns nothing, so take the value from the resolver rather than building it. |
| category = all | optional | all · tours · attractions · transport · hotels · more | Klook's own top-level product tabs. |
| sort = most_relevant | optional | most_relevant · price · participants · publish_time · review_score | Klook publishes exactly these five orderings. Any other value is accepted by the site and changes nothing, so it is rejected here instead. Note that these are Klook's RANKINGS, not strict sorts: asking for lowest price moves the cheapest results onto page one (the cheapest row on page one fell from 27.99 to 1.79 in a measured comparison) but promoted listings are still mixed in, so the page is about 63% strictly ascending. Sort the rows yourself if you need a guarantee. |
| price_min | optional | 0– | Lower bound, in the requested currency. Must be sent together with price_max. |
| price_max | optional | 0– | Upper bound, in the requested currency. |
| date | optional | — | Keep only activities bookable on this date (YYYY-MM-DD). With date_to it becomes a range. |
| date_to | optional | — | End of the availability range (YYYY-MM-DD). Ignored unless date is also given. |
| instant_confirmation | optional | — | Only activities Klook confirms immediately. |
| page = 1 | optional | 1– | 20 results per page — the page size is fixed by Klook and a limit parameter is ignored. Klook stops counting broad queries at 1000 matches. |
| currency = USD | optional | USD · HKD · SGD · JPY · KRW · TWD · THB · MYR · IDR · PHP · VND · CNY · AUD · NZD · GBP · EUR · CAD · INR · AED · CHF · SEK · DKK · NOK · PLN · CZK · HUF · RUB · BRL · MXN · ZAR · TRY · SAR · ILS · KHR · LAK · MMK · MOP · QAR · RON · EGP · LKR · BDT | ISO currency the prices are returned in. Klook prices in HKD when nothing is asked for, so this is always sent; every price in the response repeats the code it belongs to. |
| language = en-US | optional | en · en-US · en-GB · en-AU · en-CA · en-HK · en-IN · en-MY · en-NZ · en-PH · en-SG · en-AE · de · es · fr · id · it · ja · ko · ru · th · vi · zh-CN · zh-HK · zh-TW · ms-MY · pl · cs · sk · bg · nl · ca · pt-PT · pt-BR · da · sv · fi · nb · el · hu · tl · hi · ta · si · bn · ro | Content language. Klook's catalogue differs slightly per language — the same search returns 1,412 results in English and 1,319 in Japanese — so the row count is language-specific, not an error. |
post
/klook/v1/activities/list2 creditsDestination browse in 50-result pages — the bulk-listing shape for walking a city's or a country's whole catalogue. Fewer filters than activities/search (Klook's list endpoint ignores category and sort), but 2.5x the rows per call.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Free text. Optional — omit it to browse a destination. |
| city_id | optional | — | One or more Klook city ids (from destinations/resolve). Plain city ids here — no offset. |
| country_id | optional | — | One or more Klook country ids (from destinations/resolve). Plain country ids here. |
| price_min | optional | 0– | Lower bound in the requested currency. |
| price_max | optional | 0– | Upper bound in the requested currency. |
| instant_confirmation | optional | — | Only activities Klook confirms immediately. |
| page = 1 | optional | 1– | 50 results per page, fixed by Klook. |
| currency = USD | optional | USD · HKD · SGD · JPY · KRW · TWD · THB · MYR · IDR · PHP · VND · CNY · AUD · NZD · GBP · EUR · CAD · INR · AED · CHF · SEK · DKK · NOK · PLN · CZK · HUF · RUB · BRL · MXN · ZAR · TRY · SAR · ILS · KHR · LAK · MMK · MOP · QAR · RON · EGP · LKR · BDT | ISO currency the prices are returned in. Klook prices in HKD when nothing is asked for, so this is always sent; every price in the response repeats the code it belongs to. |
| language = en-US | optional | en · en-US · en-GB · en-AU · en-CA · en-HK · en-IN · en-MY · en-NZ · en-PH · en-SG · en-AE · de · es · fr · id · it · ja · ko · ru · th · vi · zh-CN · zh-HK · zh-TW · ms-MY · pl · cs · sk · bg · nl · ca · pt-PT · pt-BR · da · sv · fi · nb · el · hu · tl · hi · ta · si · bn · ro | Content language. Klook's catalogue differs slightly per language — the same search returns 1,412 results in English and 1,319 in Japanese — so the row count is language-specific, not an error. |
post
/klook/v1/activity/detail2 creditsThe full published record for one activity: description, highlights, what's included, images, address and coordinates, category path, rating, review count and the price span across its packages.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| activity_id | required | — | Klook activity id — the number in an activity URL (/activity/93901-…), or the activity_id from search. |
| currency = USD | optional | USD · HKD · SGD · JPY · KRW · TWD · THB · MYR · IDR · PHP · VND · CNY · AUD · NZD · GBP · EUR · CAD · INR · AED · CHF · SEK · DKK · NOK · PLN · CZK · HUF · RUB · BRL · MXN · ZAR · TRY · SAR · ILS · KHR · LAK · MMK · MOP · QAR · RON · EGP · LKR · BDT | ISO currency the prices are returned in. Klook prices in HKD when nothing is asked for, so this is always sent; every price in the response repeats the code it belongs to. |
| language = en-US | optional | en · en-US · en-GB · en-AU · en-CA · en-HK · en-IN · en-MY · en-NZ · en-PH · en-SG · en-AE · de · es · fr · id · it · ja · ko · ru · th · vi · zh-CN · zh-HK · zh-TW · ms-MY · pl · cs · sk · bg · nl · ca · pt-PT · pt-BR · da · sv · fi · nb · el · hu · tl · hi · ta · si · bn · ro | Content language. Klook's catalogue differs slightly per language — the same search returns 1,412 results in English and 1,319 in Japanese — so the row count is language-specific, not an error. |
post
/klook/v1/activity/packages2 creditsEvery bookable package (option) of one activity with its OWN price, cancellation policy, confirmation type, voucher type and party-size limits — plus the dates Klook currently publishes as available. Klook prices packages independently: the same attraction can run from 46 to 503 in one currency, so a headline price is not the price.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| activity_id | required | — | Klook activity id. |
| currency = USD | optional | USD · HKD · SGD · JPY · KRW · TWD · THB · MYR · IDR · PHP · VND · CNY · AUD · NZD · GBP · EUR · CAD · INR · AED · CHF · SEK · DKK · NOK · PLN · CZK · HUF · RUB · BRL · MXN · ZAR · TRY · SAR · ILS · KHR · LAK · MMK · MOP · QAR · RON · EGP · LKR · BDT | ISO currency the prices are returned in. Klook prices in HKD when nothing is asked for, so this is always sent; every price in the response repeats the code it belongs to. |
| language = en-US | optional | en · en-US · en-GB · en-AU · en-CA · en-HK · en-IN · en-MY · en-NZ · en-PH · en-SG · en-AE · de · es · fr · id · it · ja · ko · ru · th · vi · zh-CN · zh-HK · zh-TW · ms-MY · pl · cs · sk · bg · nl · ca · pt-PT · pt-BR · da · sv · fi · nb · el · hu · tl · hi · ta · si · bn · ro | Content language. Klook's catalogue differs slightly per language — the same search returns 1,412 results in English and 1,319 in Japanese — so the row count is language-specific, not an error. |
post
/klook/v1/activities/batch1 creditPrice, rating, coordinates, package count and availability for up to 50 activities in ONE upstream call. This is the efficient shape for refreshing a watchlist — 50 ids cost one call instead of 50.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| activity_id | required | — | Up to 50 Klook activity ids. Ids Klook does not publish are reported in missing_ids rather than silently dropped. |
| currency = USD | optional | USD · HKD · SGD · JPY · KRW · TWD · THB · MYR · IDR · PHP · VND · CNY · AUD · NZD · GBP · EUR · CAD · INR · AED · CHF · SEK · DKK · NOK · PLN · CZK · HUF · RUB · BRL · MXN · ZAR · TRY · SAR · ILS · KHR · LAK · MMK · MOP · QAR · RON · EGP · LKR · BDT | ISO currency the prices are returned in. Klook prices in HKD when nothing is asked for, so this is always sent; every price in the response repeats the code it belongs to. |
| language = en-US | optional | en · en-US · en-GB · en-AU · en-CA · en-HK · en-IN · en-MY · en-NZ · en-PH · en-SG · en-AE · de · es · fr · id · it · ja · ko · ru · th · vi · zh-CN · zh-HK · zh-TW · ms-MY · pl · cs · sk · bg · nl · ca · pt-PT · pt-BR · da · sv · fi · nb · el · hu · tl · hi · ta · si · bn · ro | Content language. Klook's catalogue differs slightly per language — the same search returns 1,412 results in English and 1,319 in Japanese — so the row count is language-specific, not an error. |
post
/klook/v1/activity/reviews1 creditTraveller reviews for one activity, newest first, with rating, text, photos, the package the reviewer booked and any operator reply.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| activity_id | required | — | Klook activity id. |
| page = 1 | optional | 1– | Klook serves at most 2,000 reviews per activity even when the activity has far more; a page past that boundary returns an empty list. |
| limit = 20 | optional | 1–100 | Reviews per page (Klook honours up to 100). |
| language = en-US | optional | en · en-US · en-GB · en-AU · en-CA · en-HK · en-IN · en-MY · en-NZ · en-PH · en-SG · en-AE · de · es · fr · id · it · ja · ko · ru · th · vi · zh-CN · zh-HK · zh-TW · ms-MY · pl · cs · sk · bg · nl · ca · pt-PT · pt-BR · da · sv · fi · nb · el · hu · tl · hi · ta · si · bn · ro | Content language. Klook's catalogue differs slightly per language — the same search returns 1,412 results in English and 1,319 in Japanese — so the row count is language-specific, not an error. |
post
/klook/v1/destinations/resolvefreeTurn a typed place name into the ids the other actions need. Returns cities and countries, each with a search_location_id already in the form activities/search expects — Klook offsets country ids by 1000 there and answers a bare country id with an empty result, so this is the intended way in.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | A place as a traveller would type it. |
| language = en-US | optional | en · en-US · en-GB · en-AU · en-CA · en-HK · en-IN · en-MY · en-NZ · en-PH · en-SG · en-AE · de · es · fr · id · it · ja · ko · ru · th · vi · zh-CN · zh-HK · zh-TW · ms-MY · pl · cs · sk · bg · nl · ca · pt-PT · pt-BR · da · sv · fi · nb · el · hu · tl · hi · ta · si · bn · ro | Content language. Klook's catalogue differs slightly per language — the same search returns 1,412 results in English and 1,319 in Japanese — so the row count is language-specific, not an error. |
post
/klook/v1/destinations/browsefreeKlook's own destination directory — world regions with their featured cities, and every country Klook sells in, each already carrying the id activities/search needs. The starting point when you have no place name to resolve. Ask for include_all_cities to get the complete 1,400-plus city list instead of the featured ones.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| include_all_cities = false | optional | — | Include every city Klook publishes (about 1,440) rather than only the featured ones. Adds roughly 200 KB to the response. |
| language = en-US | optional | en · en-US · en-GB · en-AU · en-CA · en-HK · en-IN · en-MY · en-NZ · en-PH · en-SG · en-AE · de · es · fr · id · it · ja · ko · ru · th · vi · zh-CN · zh-HK · zh-TW · ms-MY · pl · cs · sk · bg · nl · ca · pt-PT · pt-BR · da · sv · fi · nb · el · hu · tl · hi · ta · si · bn · ro | Content language. Klook's catalogue differs slightly per language — the same search returns 1,412 results in English and 1,319 in Japanese — so the row count is language-specific, not an error. |
post
/klook/v1/categoriesfreeThe category vocabulary: Klook's top-level product tabs (the values activities/search accepts) and the second-level activity categories with their ids and links.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| language = en-US | optional | en · en-US · en-GB · en-AU · en-CA · en-HK · en-IN · en-MY · en-NZ · en-PH · en-SG · en-AE · de · es · fr · id · it · ja · ko · ru · th · vi · zh-CN · zh-HK · zh-TW · ms-MY · pl · cs · sk · bg · nl · ca · pt-PT · pt-BR · da · sv · fi · nb · el · hu · tl · hi · ta · si · bn · ro | Content language. Klook's catalogue differs slightly per language — the same search returns 1,412 results in English and 1,319 in Japanese — so the row count is language-specific, not an error. |
Example request · activities/search
curl -X POST https://api.reefapi.com/klook/v1/activities/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"destination_id":28,"category":"attractions","currency":"USD"}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}