KKday Tours Search Scraper: Extract Tour Listings & Pricing Data

---

What Is KKday.com?

KKday is a major Asia-Pacific travel experience platform offering thousands of tours, activities, and vacation packages across destinations worldwide. Its category/search pages list products with rich metadata — pricing tiers, ratings, supplier details, and promotional labels — making it a valuable source for competitive travel market intelligence. Manually collecting this data at scale is impractical; the KKday Tours Search Scraper automates the extraction.

---

Overview

This scraper targets KKday category and search listing pages, returning structured records for each tour product. It is built for:

• Travel aggregators feeding tour data into comparison platforms
• Price monitoring tools tracking official, min, and max prices
• Market researchers analyzing destination demand and supplier activity
• Revenue managers benchmarking competitor tour pricing

---

Input Format

The Actor supports two scraping modes — use only one at a time:

1. Scrape by URLs — scrape data directly from a list of KKday category/search listing page URLs.

{
  "urls": [
    "https://www.kkday.com/en-us/category/sg-singapore/cruise-vacation/list?currency=USD&sort=prec&page=2&count=10"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

2. Scrape by search filters — scrape data using a keyword and additional filters (destination, currency, price range, etc.) instead of providing URLs.

{
  "keyword": "cruise",
  "sort_by": "omdesc",
  "currency": "USD",
  "destination": "",
  "price_from": "0",
  "price_to": "100000",
  "page": 1,
  "max_items_per_url": 200,
}

There is also a General settings group that applies to both modes.

1. Scrape by URLs

Use this mode when you already have specific listing page URLs. When this mode is used, all options in the "Scrape by search filters" section will be disabled.

Field	Type	Default	Description
urls	array	(required)	One or more KKday category/search listing page URLs to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. Each URL can include destination, category, currency, sort order, and pagination parameters. Add multiple URLs for multi-page or multi-query runs.
ignore_url_failures	boolean	true	If true, the scraper continues running when a URL fails instead of stopping the entire run. Recommended for bulk jobs.

Tip: Control pagination and result count directly in the URL using the page= and count= parameters. Use sort=prec for suggested order or other sort values (see the sort_by field below) to change the ordering.

2. Scrape by search filters

Use this mode when you want to search using a keyword and additional filter attributes instead of scraping by URLs. If you use this mode, leave the urls field above empty.

Field	Type	Default	Description
keyword	string	—	The keyword to search for.
destination	string	—	The destination code(s) to search for. Check valid destination names on the KKday website before entering — e.g. from https://www.kkday.com/en-us/product/productlist?destination=D-JP-3255,D-JP-3256, use D-JP-3255,D-JP-3256.
sort_by	string (prec, omdesc, sdesc, pasc)	—	Sort results by Suggestions (prec), Popularity (omdesc), Ratings (sdesc), or Price (pasc).
currency	string	—	The currency to display prices in. Supported codes: USD, AUD, CAD, CNY, EUR, GBP, HKD, IDR, INR, JPY, KRW, MYR, NZD, PHP, SGD, THB, TWD, VND.
price_from	string	—	The minimum price to filter items by.
price_to	string	—	The maximum price to filter items by.
page	integer	—	The page number to start scraping from.

3. General settings

Applies to both scraping modes above.

Field	Type	Default	Description
max_items_per_url	integer	20	The maximum number of tour products to collect per URL/search. Set up to 200 for full-page sweeps.

---

Output Format

Sample output

{
  "prod_mid": 262755,
  "prod_oid": 262755,
  "name": "[KKday Exclusive] Disney Cruise Line, Disney Adventure | 3/4 Night Cruises from Singapore",
  "introduction": "Sail from Singapore in 2025 on the Disney Adventure with Disney Cruise Line! Enjoy Broadway-style shows, themed dining, and new attractions like Disney Imagination Garden, Marvel Landing, and San Fransokyo Street — plus exclusive experiences for Southeast Asia.",
  "rating_count": 23,
  "rating_star": 4,
  "show_order_count": "900+",
  "earliest_sale_date": "20260528",
  "sale_status": 1,
  "purchase_type": null,
  "purchase_date": null,
  "is_tourism_product": true,
  "readable_url": "disney-adventure-cruise-singapore",
  "product_category": {
    "main": "CATEGORY_053",
    "sub": []
  },
  "display_tags": [
    "Instant Confirmation"
  ],
  "img_url_list": [
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20251120065342_OkDAl/jpg",
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20260331110434_eNo7j/jpg",
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20260331110433_bnm8E/jpg",
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20250128052806_ev609/jpg",
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20250128052805_276NN/jpg",
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20250128052804_Aftcg/jpg",
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20241122055818_T9YBe/jpg",
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20241122055825_tWyjm/png",
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20241122055822_eQL93/png",
    "https://image.kkday.com/image/get/w_600%2Cc_fit/s1.kkday.com/product_262755/20250825082518_kqRPk/jpg"
  ],
  "clip_urls": [],
  "currency": "USD",
  "official_price": 1149.9,
  "max_price": 5015.8,
  "min_price": 1149.9,
  "discount": 0,
  "is_display_price": false,
  "destinations": [
    {
      "code": "D-SG-4608",
      "name": "Central Singapore"
    }
  ],
  "is_marketplace": false,
  "supplier_oid_list": [
    32791
  ],
  "supplier_name": null,
  "supplier_logo": null,
  "supplier_badge": 0,
  "is_zero_price": false,
  "is_kkday_best_route": false,
  "prod_discount_type": null,
  "cid_activity_labels": [],
  "activity_labels": [],
  "discount_labels": [],
  "user_promotion_labels": [],
  "rq_session_id": "873b15c2-0675-4d5e-8417-ff882bb570a6",
  "algo_version": "category-list",
  "exp_version": 0,
  "star_percentage": [
    "100",
    "100",
    "100",
    "100",
    0
  ],
  "show_url_order_num": "",
  "show_country_name": "",
  "show_rating_star": [
    "100",
    "100",
    "100",
    "100",
    0
  ],
  "url": "http://www.kkday.com/en-us/product/262755-disney-adventure-cruise-singapore",
  "from_url": "https://www.kkday.com/en-us/category/sg-singapore/cruise-vacation/list?currency=USD&sort=prec&page=2&count=10"
}

Each tour listing returns 43 fields grouped below:

Product Identification

Field	Meaning
Prod MID	Master product ID — top-level identifier for the tour
Prod OID	Option-level product ID for specific variants
Name	Full tour product name as displayed on KKday
Introduction	Short promotional description of the tour
Readable URL	SEO-friendly URL slug for the product detail page
URL	Full direct link to the tour listing page
Product Category	Category classification (e.g., cruise, day-trip, activity)

Pricing

Field	Meaning
Currency	Currency code for all prices (e.g., USD)
Official Price	Original listed price before discounts
Max Price	Highest price variant across options
Min Price	Lowest available price shown in search
Discount	Discount amount or percentage applied
Prod Discount Type	Type of discount (e.g., early-bird, coupon)
Is Display Price	Whether a price is shown publicly on the listing
Is Zero Price	Flag for free or price-on-request products

Ratings & Popularity

Field	Meaning
Rating Count	Total number of reviews submitted
Rating Star	Average star rating (e.g., 4.8)
Show Rating Star	Whether the rating is rendered on the listing
Star Percentage	Rating expressed as a percentage
Show Order Count	Displayed booking count (may be rounded/capped)
Show URL Order Num	Order volume associated with the specific URL variant

Sale & Purchase Info

Field	Meaning
Sale Status	Current availability status (on sale, sold out, etc.)
Earliest Sale Date	Earliest available date for booking
Purchase Type	How the product is purchased (instant, request, etc.)
Purchase Date	Date context for purchase availability
Is Tourism Product	Flags whether this is a regulated tourism offering

Labels & Tags

Field	Meaning
Display Tags	Visual badges shown on the card (e.g., "Bestseller")
CID Activity Labels	Internal category-based activity classification labels
Activity Labels	User-facing activity type tags
Discount Labels	Promotional discount badges (e.g., "15% OFF")
User Promotion Labels	Personalized or account-targeted promo labels

Supplier Information

Field	Meaning
Supplier OID List	List of supplier option IDs linked to the product
Supplier Name	Name of the tour operator/supplier
Supplier Logo	URL to the supplier's logo image
Supplier Badge	Verified or quality badges assigned to the supplier
Is Marketplace	Whether the product is listed via KKday's marketplace model
Is KKday Best Route	KKday's curated "best route" flag

Media

Field	Meaning
Image URL List	Array of product image URLs
Clip URLs	Short video/clip preview URLs if available

Destinations & Geo

Field	Meaning
Destinations	Destination tags associated with the tour
Show Country Name	Country name displayed on the listing card

Analytics / Internal

Field	Meaning
RQ Session ID	Request session identifier from KKday's backend
Algo Version	Search algorithm version used for ranking
Exp Version	A/B experiment version applied to the result

---

How to Use

1. Get a search/category URL — Navigate to any KKday category page, apply filters (destination, sort, currency), and copy the URL.
2. Configure pagination — Adjust page= and count= in the URL to target specific result sets.
3. Set item limit — Use max_items_per_url to cap results (max 200 per run per URL).
4. Add multiple URLs — Paste one URL per line to scrape across categories or destinations in one run.
5. Enable failure tolerance — Keep ignore_url_failures: true for multi-URL runs.
6. Export — Download results as JSON, CSV, or Excel for analysis.

Common issues:

• If results return empty, verify the URL loads correctly in a browser and contains visible listings.
• Price fields may vary if the URL specifies a currency not supported in that region — match currency= to the target market.

---

Use Cases & Business Value

• Price tracking: Monitor Min Price, Max Price, and Discount fields across time to detect pricing patterns
• Supplier research: Map Supplier Name and Supplier Badge data across categories
• Content aggregation: Build destination-specific tour feeds using Destinations, Activity Labels, and Image URL List
• Demand signals: Use Rating Count, Show Order Count, and Display Tags as proxies for product popularity

---

Conclusion

The KKday Tours Search Scraper delivers structured, detailed data from one of Asia's leading travel platforms — covering pricing, ratings, suppliers, and promotional metadata across any destination or category. Whether you're building a travel comparison tool or conducting market research, it provides the raw data needed to work efficiently at scale.