SeerMarTech API 文档

主题

按任务 ID 获取高级 Google店信息结果 ​

本接口使用 GET 方法，通过任务 ID 获取高级 Google店信息结果：

GET https://api.seermartech.cn/v3/business_data/google/hotel_info/task_get/advanced/$id

高级信息接口可返回指定实体的结构化数据描述、地址、地理位置、星级、设施、评价、图片、价格、第三方预订渠道及按日期的价格信息等。

返回结果与创建任务时指定的 hotel_identifier、位置和语言参数。本平台会尽可能还原指定参数下的搜索结果。你可以通过响应中的 check_url 在无痕模式下打开搜索结果页面，以核验数据准确性。

计费说明 ​

  • 在创建任务时计费。
  • 任务创建后 30 天可获取结果。
  • 结果查询不会重复扣费。
  • 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数 ​

请求路径中的 $id 替换为任务的唯一标识。

参数类型说明
idstring任务唯一标识。格式为 UUID，可在任务创建后的 30 天重复用于查询结果。

响应结构 ​

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段 ​

字段类型说明
versionstring当前 API 版本。
status_codeinteger通用响应状态码。完整状态码请参考错误码文档。建议客户端实现异常和错误处理机制。
status_messagestring通用状态说明。
timestring请求执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量。
tasks_errorintegertasks 数组中返回错误的任务数量。
tasksarray任务结果数组。

tasks 数组中的字段 ​

字段类型说明
idstring任务唯一标识，UUID 格式。
status_codeinteger任务状态码，通常位于 10000-60000 范围。
status_messagestring任务状态说明。
timestring任务执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的结果数量。
patharray请求路径信息。
dataobject创建任务时提交的参数。
resultarray店信息结果数组。

result 字段说明 ​

基本信息 ​

字段类型说明
hotel_identifierstring店唯一标识，即创建任务时提交的标识。例如：CgoI-KWyzenM_MV3EAE。
location_codeinteger创建任务时提交的位置代码。
language_codestring创建任务时提交的语言代码。
check_urlstring可直接访问的搜索结果 URL，可用于核验返回结果。
datetimestring获取结果的 UTC 日期和时间，格式为 yyyy-mm-dd hh-mm-ss +00:00。
titlestring店名称。
starsinteger店星级，取值范围为 1 至 5。
stars_descriptionstring店星级的文字描述。
addressstring店实体的物理地址。
phonestring店联系电话。

about：介绍 ​

字段类型说明
aboutobject店介绍信息。
descriptionstring店主要描述。
sub_descriptionsarray店补描述信息。

###住和退房时间

字段类型说明
check_in_timeobject店时间。
check_in_time.hourinteger住时间的小时部分。
check_in_time.minuteinteger住时间的分钟部分。
check_out_timeobject店退房时间。
check_out_time.hourinteger退房时间的小时部分。
check_out_time.minuteinteger退房时间的分钟部分。
full_addressstring标准化格式的完整地址。
domainstring店官方网站域名。
urlstring店官方网站 URL。

amenities：设施 ​

amenities 是按标准化类别组织的设施信息。

字段类型说明
amenitiesarray店设施分类数组。
categorystring设施标准化类别。
category_labelstring设施类别的展示名称。
itemsarray该类别下的设施。
items.amenitystring设施标准化名称。
items.amenity_labelstring设施展示名称。
items.hintstring设施的标准化补说明。
items.hint_labelstring设施补说明的展示文本。
items.is_availableboolean指示该设施是否在提供。
字段类型说明
popular_amenitiesarray被标记为热门的设施。
amenitystring设施标准化名称。
amenity_labelstring设施展示名称。
hintstring设施标准化补说明。
hint_labelstring设施补说明的展示文本。
is_availableboolean指示该设施是否在提供。

location：位置 ​

字段类型说明
locationobject店位置信息。
neighborhoodstring店所在街区或区域名称。
neighborhood_descriptionstring所在街区或区域的描述。
maps_urlstring店在地图中的位置 URL。
overall_scorefloat店位置综合评分，范围为 1 至 5。评分综合考虑附近景点、餐、交通和机场等因素，各因素权重可能不同。
score_by_categoriesobject按位置类别划分的评分。
score_by_categories.overallfloat位置综合评分，范围为 1 至 5。
score_by_categories.things_to_dofloat附近景点及休闲活动评分，范围为 1 至 5。
score_by_categories.restaurantsfloat附近餐评分，范围为 1 至 5。
score_by_categories.transitfloat附近交通评分，范围为 1 至 5。
score_by_categories.airport_accessfloat机场通达性评分，范围为 1 至 5。
latitudefloat店纬度。例如：39.4806397。
longitudefloat店经度。例如：-106.0512973。
location_chainarray位置层级链中的。

location_chain素 ​

字段类型说明
card_idstring卡片标识。
feature_idstring功能特征标识。
cidstring客户或地点标识。
titlestring位置层级名称。

reviews：评价 ​

字段类型说明
reviewsobject店评价信息。
valuefloat基于用户投票计算的综合评分。
votes_countinteger用于计算评分的用户投票数量。
mentionsarray按评价维度统计的提及信息。
rating_distributionobject1 至 5 分评价的投票分布。
rating_distribution.5integer5 分评价数量。
rating_distribution.4integer4 分评价数量。
rating_distribution.3integer3 分评价数量。
rating_distribution.2integer2 分评价数量。
rating_distribution.1integer1 分评价数量。
other_sites_reviewsarray第三方网站上的评价。

mentions素 ​

字段类型说明
titlestring被评价维度的名称。
positive_scorefloat该维度的正面评价分数。
positive_countinteger正面评价数量。
negative_countinteger负面评价数量。
total_countinteger该维度的评价数量。
visible_by_defaultboolean该评价维度是否默认展示。

other_sites_reviews素 ​

字段类型说明
titlestring第三方评价网站名称。
urlstring第三方评价页面 URL。
review_textstring评价正文。
ratingobject第三方评价中的评分信息。
rating.rating_typestring评分类型，可为 CustomMax 或 Max5。
rating.valuefloat评分值。CustomMax 的取值范围为 1 至 10，Max5 的取值范围为 1 至 5。
rating.votes_countinteger该评价的投票数量。
rating.rating_maxinteger当前评分类型的最大评分值。

图片 ​

字段类型说明
overview_imagesarray店概览页面展示的图片 URL 数组。

prices：价格 ​

字段类型说明
pricesobject店住宿价格信息。
priceinteger当前每晚价格。
price_without_discountinteger未应用折扣时的每晚价格。
currencystring价格货币。默认通常为 USD，取决于创建任务时的设置。
discount_textstring折扣说明文本。
check_instring住日期和时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
check_outstring退房日期和时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
visitorsinteger住人数。
itemsarray第三方网站提供的价格明细。
offersarray重点展示的价格优惠。
prices_by_datesarray按日期列出的住宿价格。

prices.items素 ​

支持的 type 值为 hotel_info_price。

字段类型说明
typestring固定为 hotel_info_price。
titlestring第三方价格网站或渠道名称。
priceinteger第三方网站显示的每晚价格。
currencystring价格货币。
urlstring第三方预订页面 URL。
domainstring第三方网站域名。
is_paidboolean是否为付费预订链接。true 表示广告，false 表示预订链接。
official_siteboolean是否展示“官方网站”标签。
free_cancellation_untilstring | null取消截止时间，使用 UTC 格式。如果所选日期不支持取消，则为 null。

prices.offers素 ​

type 固定为 hotel_info_price_offer。

字段类型说明
typestring固定为 hotel_info_price_offer。
titlestring价格优惠名称。
priceinteger优惠价格。
currencystring价格货币。
urlstring展示该优惠的网站页面 URL。
max_visitorsinteger该价格适用的最大人数。
offer_imagesarray价格优惠图片 URL。
free_cancellation_untilstring | null取消截止时间，使用 UTC 格式；不支持取消时为 null。

prices.prices_by_dates素 ​

字段类型说明
priceinteger指定日期的每晚价格。
currencystring价格货币，例如 USD。
check_in_datestring住日期和时间，UTC 格式。例如：2025-05-20 12:00:00 +00:00。
check_out_datestring退房日期和时间，UTC 格式。例如：2025-05-21 12:00:00 +00:00。

请求示例 ​

cURL ​

bash
id="09171517-0696-0242-0000-a96bc1ad0bce"

curl --location --request GET \
  "https://api.seermartech.cn/v3/business_data/google/hotel_info/task_get/advanced/${id}" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json"

Python ​

python
import requests

task_id = "09171517-0696-0242-0000-a96bc1ad0bce"

url = (
    "https://api.seermartech.cn/v3/business_data/google/"
    f"hotel_info/task_get/advanced/{task_id}"
)

response = requests.get(
    url,
    headers={
        "Authorization": "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
    },
)

response.raise_for_status()
result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        f"请求失败，状态码：{result.get('status_code')}，"
        f"信息：{result.get('status_message')}"
    )

TypeScript ​

typescript
import axios from "axios";

const taskId = "02231934-2604-0066-2000-570459f04879";

axios
  .get(
    `https://api.seermartech.cn/v3/business_data/google/hotel_info/task_get/advanced/${taskId}`,
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    },
  )
  .then((response) => {
    // 处理、设施、评价和价格信息
    console.log(response.data);
  })
  .catch((error) => {
    console.error("获取信息失败：", error.response?.data || error.message);
  });

响应示例 ​

以下示例展示主要字段，数组中的部分已省略。响应可能更多设施、评价、图片和第三方价格条目。

json
{
  "version": "0.1.20260420",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0736 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "09171517-0696-0242-0000-a96bc1ad0bce",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0500 sec.",
      "cost": 0,
      "result_count": 1,
      "data": {
        "se_type": "hotel_info",
        "se": "google",
        "api": "business_data",
        "function": "hotel_info",
        "location_name": "New York,New York,United States",
        "language_name": "English",
        "hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
          "location_code": 2840,
          "language_code": "en",
          "check_url": "https://www.google.com/travel/hotels",
          "datetime": "2026-04-24 13:19:22 +00:00",
          "title": "President Hotel Athens",
          "stars": 4,
          "stars_description": "4-star hotel",
          "address": "Leof. Kifisias 43, Athina 115 23, Greece",
          "phone": null,
          "about": {
            "description": "Hotel description",
            "sub_descriptions": []
          },
          "check_in_time": {
            "hour": 15,
            "minute": 0
          },
          "check_out_time": {
            "hour": 11,
            "minute": 0
          },
          "full_address": "President Hotel Athens, Leof. Kifisias 43, Athina 115 23, Greece",
          "domain": "president.gr",
          "url": "https://president.gr/",
          "amenities": [
            {
              "category": "food_and_drink",
              "category_label": "Food & drink",
              "items": [
                {
                  "amenity": "restaurant",
                  "amenity_label": "Restaurant",
                  "hint": null,
                  "hint_label": null,
                  "is_available": true
                }
              ]
            }
          ],
          "popular_amenities": [],
          "location": {
            "neighborhood": "Central Athens Regional Unit",
            "neighborhood_description": "Busy Central Athens is known for classical landmarks.",
            "maps_url": "https://maps.google.com/",
            "overall_score": 3.1,
            "score_by_categories": {
              "overall": 3.1,
              "things_to_do": 3.2,
              "restaurants": 3.3,
              "transit": 4.1,
              "airport_access": 3.9
            },
            "latitude": 37.9890814,
            "longitude": 23.7638777,
            "location_chain": []
          },
          "reviews": {
            "value": 4.2,
            "votes_count": 8552,
            "mentions": [],
            "rating_distribution": {
              "1": 5,
              "2": 3,
              "3": 10,
              "4": 26,
              "5": 56
            },
            "other_sites_reviews": []
          },
          "overview_images": [],
          "prices": {
            "price": 165,
            "price_without_discount": null,
            "currency": "USD",
            "discount_text": null,
            "check_in": "2026-04-25 00:00:00 +00:00",
            "check_out": "2026-04-26 00:00:00 +00:00",
            "visitors": 2,
            "items": [
              {
                "type": "hotel_info_price",
                "title": "Booking.com",
                "price": 169,
                "currency": "USD",
                "url": "https://example.com/booking",
                "domain": "example.com",
                "is_paid": true,
                "official_site": false,
                "free_cancellation_until": null,
                "offers": []
              }
            ],
            "prices_by_dates": null
          }
        }
      ]
    }
  ]
}

错误处理 ​

请同时检查顶层和任务级别的 status_code：

  • 20000：请求或任务成功。
  • 40000 及以上：任务通常存在错误，应结合 status_message 进行处理。
  • 当 result 为 null 或 result_count 为 0 时，应视为没有可用结果，并记录任务状态信息。

实用场景 ​

  • 采集设施与服务信息，构建页或住宿目录，帮助用户快速比较不同的条件。
  • 监测评分和评价维度，分析星级、综合评分、正负面提及及评分分布，支持口碑管理。
  • 比较不同预订渠道的房价，汇总官网、在线平台及渠道的价格，发现价格差异和渠道机会。
  • 跟踪指定日期的价格变化，利用 prices_by_dates 分析日期与退房日期对应的房价趋势， SEO 和价格规划。
  • 评估位置竞争力，结合景点、餐、交通和机场通达性评分，优化“近景点”“交通便利”等本地搜索。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API