Viator API

The Viator API lets developers retrieve full tour product profiles and attraction-based tour listings from Viator by URL. Access itineraries, pricing with discounts, review breakdowns, cancellation policies, age band configs, and meeting point coordinates—ideal for travel aggregators, activity finders, and tour comparison tools.

原始信息汇总

Viator API 数据集概述

基本信息

• 数据集名称: Viator API
• 提供者: kakoto
• 类别: Travel
• 当前版本: 1.0.0
• API类型: REST API
• 订阅计划:
  • BASIC: $0.00 / 月
  • PRO: $15.00 / 月
  • ULTRA: $49.00 / 月
  • MEGA: $139.00 / 月

核心功能

Viator API 允许开发者通过URL从Viator检索完整的旅游产品资料和基于景点的旅游列表。可访问行程、含折扣的价格、评论细分、取消政策、年龄组配置和集合点坐标。适用于旅游聚合商、活动查找器和旅游比较工具。

端点详情

1. POST /tour/get-by-url — 获取完整旅游详情

使用Viator旅游的完整URL检索全面的产品信息。

输入字段:

字段	类型	必需	描述
url	string	✅	完整的Viator旅游URL

响应结构:

• 包含 product_code, title, primary_product_type, rating, destination, duration, has_free_cancellation, is_private_tour, is_excellent, supplier_name, time_zone, pricing, itinerary, reviews, availability_config, logistics_location 等字段。

关键嵌套对象:

• 定价 (pricing): 包含 retail_price, discounted_price, discount_amount, is_discounted, has_tiered_pricing, special_offer, special_offer_end_date, is_likely_to_sell_out, is_on_sale。
• 行程 (itinerary): 包含 itinerary_type, itinerary_item_list[].itinerary_stop_list，每个停靠点包含 location_name, duration, geo_coordinates, admission_inclusion_type, pass_by_without_stopping, viator_attraction_id。
• 评论 (reviews): 包含 ratings, viator_reviews, ta_reviews, viator_review_count, ta_review_count, total_ta_and_viator_reviews_count, total_review_pages, sorted_by。每个评论包含 review_id, rating, text, title, published_at, owner_response, is_machine_translated。
• 可用性配置 (availability_config): 包含 age_band_ranges (如 ADULT, CHILD, INFANT)，每个年龄组包含 age_min, age_max, passenger_min, passenger_max, default_input_value, is_counted_as_viable_to_book。还包含 max_travellers_per_booking, next_available_date, search_dates。

2. POST /tour/listing-by-url — 从景点URL列出旅游

从Viator景点或分类页面URL检索旅游摘要列表。返回适用于浏览和比较视图的轻量级对象。

输入字段:

字段	类型	必需	描述
url	string	✅	完整的Viator景点或分类URL

响应结构:

• 包含 product_code, title, url, description, category, location, rating, pricing_info, display_duration, offered_languages, max_travelers_allowed, product_badges, behaviours, geolocation, images 等字段。

响应信封

所有端点共享相同的响应信封结构： json { "statusCode": 200, "messageCode": "OK", "data": [ /* 结果对象数组 */ ] }

状态码

状态码	含义
400	错误请求 — 检查URL格式
404	未找到旅游
500	内部服务器错误 — 短暂延迟后重试

使用建议与最佳实践

• 使用列表进行发现，使用详情获取深度: 使用 /tour/listing-by-url 从景点或分类页面收集 product_code 值，然后对选定的旅游调用 /tour/get-by-url 以获取完整的行程、定价、预订配置和评论数据。
• 解析行程以进行地图集成: itinerary_item_list[].itinerary_stop_list 中的每个停靠点都包含 geo_coordinates。使用这些坐标在地图上渲染步行旅游路径或放置标记。
• 正确解读定价: 详情端点中的 pricing.price 对象包含 retail_price 和 discounted_price。在显示销售价格之前，始终检查 is_discounted — 如果为 false，则仅显示 retail_price。
• 验证年龄组要求: 在显示预订流程之前，检查 availability_config.age_band_ranges。is_counted_as_viable_to_book 标志指示哪些年龄组计入满足最低预订要求。
• 错误处理:
  • 出现 404 时，旅游URL可能已过时或产品在Viator上不再活跃。
  • 出现 400 时，请验证URL是否为有效的 viator.com 路径。
  • 出现 500 时，使用指数退避策略重试。

法律声明

确保您对此API的使用符合Viator的服务条款，然后再将收集的数据用于商业用途或重新分发。