# 即時商家列表搜尋任務
**API:** Data API
**Endpoint:** `POST /v1/beta/dataforseo/business_data/business_listings/search/live`
**Tags:** DataForSEO
依 `categories`、`description`、`title` 與 `location_coordinate`（緯度、經度與半徑三元組）搜尋 DataForSEO 自有的本地商家列表索引。回傳 `total_count`、`count`、`offset`、`offset_token` 與 `items`，並使用該權杖分頁。採用 DataForSEO 的信封結構：資料位於 `tasks[0].result`，結果狀態位於 `tasks[0].status_code`——被拒絕的請求仍會回傳 HTTP 200。此端點讀取索引並立即回傳結果；此處的其他端點都會將對來源的即時擷取排入佇列。先從這裡開始，只在確實需要時再深入。
### 計費參考
- 計量方式：依回報的回應成本計量。
- 參考請求估算：0.2428 美元。
- 參考客戶倍率：1.0。不得對已結算的客戶金額再次套用。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
## Base URL
- `https://openapi.felo.ai`
## Authentication
- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)
## Request body
Required: **no**
### application/json
Schema:
```json
{
"type": "array",
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"type": "object",
"properties": {
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "商家類別
選填欄位
指定的類別用於搜尋商家列表；
若未使用此欄位，我們將傳回指定位置中發現的商家列表；
最多可指定 10 個類別"
},
"description": {
"type": [
"string",
"null"
],
"description": "SERP 中元素的描述
選填欄位
收集結果所針對的商家實體描述；
最多可包含 200 個字元"
},
"title": {
"type": [
"string",
"null"
],
"description": "SERP 中元素的標題
選填欄位
收集結果所針對的商家實體名稱；
最多可包含 200 個字元"
},
"is_claimed": {
"type": [
"boolean",
"null"
],
"description": "表示商家是否已由其所有者在 Google Maps 上驗證
選填欄位"
},
"location_coordinate": {
"type": [
"string",
"null"
],
"description": "位置的 GPS 座標
選填欄位
location_coordinate 參數應以 \"latitude,longitude,radius\" 格式指定
\"latitude\" 與 \"longitude\" 的最大小數位數為 7
\"radius\" 的值以公里（km）為單位
\"radius\" 的最小值：1
\"radius\" 的最大值：100000
範例：
53.476225,-2.243572,200
如需進一步瞭解如何在此 API 中設定位置參數，請參閱我們的說明中心"
},
"filters": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
]
},
"description": "結果篩選參數陣列
選填欄位
可同時新增多個篩選條件（最多 8 個）
應在條件之間設定邏輯運算子 and、or
支援下列運算子：
regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
可將 % 運算子與 like、not_like 搭配使用，比對任意長度（含零個字元）的字串
範例：
[\"rating.value\",\">\",3]
可個別向 https://api.dataforseo.com/v3/business_data/business_listings/available_filters 發出請求，取得可用的篩選條件清單
完整的可用篩選條件清單請見此處。"
},
"order_by": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "結果排序規則
選填欄位
可使用與 filters 陣列相同的值對結果排序
可用的排序類型：
asc - 結果依升冪排列
desc - 結果依降冪排列
應使用逗號設定排序參數
範例：
[\"rating.value,desc\"]請注意，單一請求中最多可設定三條排序規則
應使用逗號分隔多條排序規則
範例：
[\"rating.value,desc\",\"rating.votes_count,desc\"]"
},
"limit": {
"type": [
"integer",
"null"
],
"description": "傳回的商家數量上限
選填欄位
預設值：100
最大值：1000"
},
"offset": {
"type": [
"integer",
"null"
],
"description": "傳回的商家在結果陣列中的位移量
選填欄位
預設值：0
若指定 10，結果陣列中的前 10 個實體將被略過，並傳回後續實體的資料
注意：建議僅在擷取最多 10,000 筆結果時使用此參數
如需擷取超過 10,000 筆結果，請改用 offset_token"
},
"offset_token": {
"type": [
"string",
"null"
],
"description": "用於後續請求的權杖
選填欄位
在每次請求回應的同名欄位中提供；
使用此參數可在單次請求嘗試取得超過 100,000 筆結果時避免逾時；
透過指定回應陣列中的唯一 offset_token 值，你將取得初始任務的後續結果；
offset_token 值對每個後續任務都是唯一的
注意：如果請求中指定了 offset_token，所有其他參數都應與先前的請求保持一致
如需進一步瞭解此參數，請參閱我們的 說明中心"
},
"tag": {
"type": [
"string",
"null"
],
"description": "使用者自訂任務識別碼
選填欄位
字元數上限為 255
可使用此參數識別任務，並將其與結果對應
可在回應的 data 物件中找到指定的 tag 值"
}
},
"example": [
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"title": "pizza",
"is_claimed": true,
"location_coordinate": "53.476225,-2.243572,10",
"order_by": [
"rating.value,desc"
],
"filters": [
[
"rating.value",
">",
3
]
],
"limit": 3
}
]
}
]
},
"example": [
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"title": "pizza",
"is_claimed": true,
"location_coordinate": "53.476225,-2.243572,10",
"order_by": [
"rating.value,desc"
],
"filters": [
[
"rating.value",
">",
3
]
],
"limit": 3
}
]
}
```
## Responses
### 200 — 操作成功
Headers:
- `X-Request-Id` (string) — 聯絡 Felo 支援時需提供的請求識別碼。
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo"
}
]
}
```
### 400 — 無法處理該要求。請檢查請求參數。
### 401 — 需要有效的 Felo API 金鑰。
### 402 — 由於未符合計費要求，要求無法繼續。
### 403 — 該帳戶無權執行此操作。
### 429 — 已達到要求或支出上限。
### 502 — 服務無法完成該要求。
### 503 — API 或計費服務暫時無法使用。
### 504 — 服務在處理要求時逾時。
### default — 錯誤回應；上游透傳回應可能採用供應商格式
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_AddressInfo
`#/components/schemas/Response36Afe1097B20_AddressInfo`
```json
{
"type": "object",
"properties": {
"borough": {
"type": [
"string",
"null"
],
"description": "本地商家所屬的行政單位或區域"
},
"address": {
"type": [
"string",
"null"
],
"description": "本地商家的街道地址"
},
"city": {
"type": [
"string",
"null"
],
"description": "本地商家所在城市的名稱"
},
"zip": {
"type": [
"string",
"null"
],
"description": "本地商家的郵遞區號"
},
"region": {
"type": [
"string",
"null"
],
"description": "本地商家所屬的 DMA 區域"
},
"country_code": {
"type": [
"string",
"null"
],
"description": "本地商家的 ISO 國家代碼"
}
}
}
```
### Response36Afe1097B20_BaseLocalBusinessLink
`#/components/schemas/Response36Afe1097B20_BaseLocalBusinessLink`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
}
},
"additionalProperties": false,
"discriminator": {
"propertyName": "type",
"mapping": {
"reservation": "#/components/schemas/Response36Afe1097B20_LocalBusinessReservationLink",
"order": "#/components/schemas/Response36Afe1097B20_LocalBusinessOrderLink",
"menu": "#/components/schemas/Response36Afe1097B20_LocalBusinessMenuLink"
}
}
}
```
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "API 的目前版本"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "一般狀態碼\n完整回應碼清單請見此處"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "一般資訊訊息\n完整的一般資訊訊息清單請見此處"
},
"time": {
"type": [
"string",
"null"
],
"description": "總執行時間，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任務總費用，美元",
"format": "double"
},
"tasks_count": {
"type": [
"integer",
"null"
],
"description": "tasks 陣列中的任務數",
"format": "int64"
},
"tasks_error": {
"type": [
"integer",
"null"
],
"description": "tasks 陣列中傳回錯誤的任務數",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseTaskInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`
```json
{
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "任務識別碼\n我們系統中 UUID 格式的唯一任務識別碼"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "任務的狀態碼\n由 DataForSEO 產生，範圍如下：10000-60000\n完整回應碼清單請見此處"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "任務的資訊訊息\n完整的一般資訊訊息清單請見此處"
},
"time": {
"type": [
"string",
"null"
],
"description": "執行時間，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任務總費用，美元",
"format": "double"
},
"result_count": {
"type": [
"integer",
"null"
],
"description": "result 陣列中的元素數",
"format": "int64"
},
"path": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "URL 路徑"
},
"data": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"object",
"null"
]
},
"description": "包含你在 POST 請求中指定的相同參數"
}
}
}
```
### Response36Afe1097B20_BusinessDataAttributesInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataAttributesInfo`
```json
{
"type": "object",
"properties": {
"available_attributes": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
}
},
"description": "可用屬性
表示商家實體可提供的屬性"
},
"unavailable_attributes": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
}
},
"description": "不可用屬性
表示商家實體無法提供的屬性"
}
}
}
```
### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveItem
`#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveItem`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"title": {
"type": [
"string",
"null"
],
"description": "SERP 中元素的標題
收集結果所針對的商家實體名稱"
},
"original_title": {
"type": [
"string",
"null"
],
"description": "項目的原始標題
未經 Google 翻譯的原始標題"
},
"description": {
"type": [
"string",
"null"
],
"description": "SERP 中元素的說明
收集結果所針對之商家實體的說明"
},
"category": {
"type": [
"string",
"null"
],
"description": "商家類別
最能描述商家實體所提供服務的 Google My Business 通用類別"
},
"category_ids": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "全域類別 ID
不隨所選國家/地區變更的通用類別 ID"
},
"additional_categories": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "其他商家類別
更詳細描述商家實體所提供服務的其他 Google My Business 類別"
},
"cid": {
"type": [
"string",
"null"
],
"description": "Google 定義的用戶端 ID
本地商家的唯一 ID
如需進一步瞭解此識別碼，請參閱這篇說明中心文章"
},
"feature_id": {
"type": [
"string",
"null"
],
"description": "SERP 中元素的唯一識別碼
如需進一步瞭解該識別碼，請參閱這篇說明中心文章"
},
"address": {
"type": [
"string",
"null"
],
"description": "商家實體的地址"
},
"address_info": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AddressInfo"
}
],
"description": "包含商家實體地址組成部分的物件"
},
"place_id": {
"type": [
"string",
"null"
],
"description": "唯一地點識別碼
元素中所示當地商家的地點 ID
如需進一步瞭解此識別碼，請參閱這篇說明中心文章"
},
"phone": {
"type": [
"string",
"null"
],
"description": "商家實體的電話號碼"
},
"url": {
"type": [
"string",
"null"
],
"description": "商家實體的絕對 URL"
},
"domain": {
"type": [
"string",
"null"
],
"description": "商家實體的網域"
},
"logo": {
"type": [
"string",
"null"
],
"description": "Google 我的商家檔案中展示的標誌 URL"
},
"main_image": {
"type": [
"string",
"null"
],
"description": "Google My Business 檔案中顯示的主圖片 URL"
},
"total_photos": {
"type": [
"integer",
"null"
],
"description": "Google My Business 檔案中顯示的圖片總數",
"format": "int64"
},
"snippet": {
"type": [
"string",
"null"
],
"description": "商家實體的額外資訊"
},
"latitude": {
"type": [
"number",
"null"
],
"description": "當地商家在 Google 地圖中的緯度座標
範例：
\"latitude\": 51.584091"
},
"longitude": {
"type": [
"number",
"null"
],
"description": "當地商家在 Google 地圖中的經度座標
範例：
\"longitude\": -0.31365919999999997"
},
"is_claimed": {
"type": [
"boolean",
"null"
],
"description": "顯示該實體是否已由其所有者在 Google Maps 上驗證"
},
"attributes": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataAttributesInfo"
}
],
"description": "以使用者評論勾選項形式呈現的服務詳情；
以勾選項形式展示、依據使用者意見回饋與商家 category 的商家實體服務詳情"
},
"place_topics": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"integer",
"null"
],
"format": "int64"
},
"description": "顧客評論中提及的關鍵字
包含與商家實體顧客評論中提及的產品/服務相關的最熱門關鍵字，以及提及每個關鍵字的評論數
範例：
\"place_topics\": {
\"egg roll\": 48,
\"birthday\": 33
}
依據評論並顯示於 SERP 的熱度評分"
},
"hotel_rating": {
"type": [
"integer",
"null"
],
"description": "飯店星級評分
星級評分範圍為 1-5 星，瞭解更多
如果沒有飯店星級評分資訊，該值將為 null"
},
"price_level": {
"type": [
"string",
"null"
],
"description": "場所價格等級
可採用下列值：inexpensive、moderate、expensive、very_expensive
如果沒有價格等級資訊，該值將為 null"
},
"rating_distribution": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"integer",
"null"
],
"format": "Int64"
},
"description": "商家實體的評分分佈
該物件顯示使用者評論的 1 星到 5 星評分數"
},
"people_also_search": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_PeopleAlsoSearch"
}
]
},
"description": "相關商家實體"
},
"work_time": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessWorkHoursInfo"
}
],
"description": "營業時間詳細資料
與商家實體營業時間相關的資訊"
},
"popular_times": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_PopularTimes"
}
],
"description": "熱門時段
與商家實體忙碌時段相關的資訊"
},
"local_business_links": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseLocalBusinessLink"
}
]
},
"description": "與商家可用的互動
可直接從搜尋結果與商家互動的選項清單"
},
"contact_info": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataContactInfo"
}
]
},
"description": "商家的可用聯絡方式
用於與商家聯絡的聯絡方式清單"
},
"check_url": {
"type": [
"string",
"null"
],
"description": "搜尋引擎結果的直接 URL
可用來確認我們提供了準確的結果"
},
"last_updated_time": {
"type": [
"string",
"null"
],
"description": "資料最後更新的日期與時間
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：
2023-01-26 09:03:15 +00:00"
},
"first_seen": {
"type": [
"string",
"null"
],
"description": "我們的檢索器首次發現該商家資訊元素的日期與時間
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：
2023-03-11 10:04:11 +00:00"
},
"services": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataServiceInfo"
}
]
}
}
}
}
```
### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo"
}
]
},
"description": "任務陣列"
}
}
}
]
}
```
### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResultInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResultInfo`
```json
{
"type": "object",
"properties": {
"total_count": {
"type": [
"integer",
"null"
],
"description": "我們資料庫中與你的請求相關的結果總數",
"format": "int64"
},
"count": {
"type": [
"integer",
"null"
],
"description": "項目類型
items 陣列中的項目數",
"format": "int64"
},
"offset": {
"type": [
"integer",
"null"
],
"format": "int64"
},
"offset_token": {
"type": [
"string",
"null"
]
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveItem"
}
]
},
"description": "遇到的項目類型
items 陣列中出現的搜尋引擎結果類型；
可能的項目類型：business_listing"
}
}
}
```
### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResultInfo"
}
]
},
"description": "結果陣列"
}
}
}
]
}
```
### Response36Afe1097B20_BusinessDataContactInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataContactInfo`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"value": {
"type": [
"string",
"null"
],
"description": "評分的值"
},
"source": {
"type": [
"string",
"null"
],
"description": "資料來源"
}
}
}
```
### Response36Afe1097B20_BusinessDataServiceInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataServiceInfo`
```json
{
"type": "object",
"properties": {
"category": {
"type": [
"string",
"null"
],
"description": "商家類別
最能描述商家實體所提供服務的 Google My Business 通用類別"
},
"title": {
"type": [
"string",
"null"
],
"description": "SERP 中元素的標題
收集結果所針對的商家實體名稱"
},
"snippet": {
"type": [
"string",
"null"
],
"description": "商家實體的額外資訊"
},
"price": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo"
}
]
}
}
}
```
### Response36Afe1097B20_BusinessWorkHoursInfo
`#/components/schemas/Response36Afe1097B20_BusinessWorkHoursInfo`
```json
{
"type": "object",
"properties": {
"work_hours": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_WorkHours"
}
],
"description": "營業時間
當地商家的營業時間資訊"
}
}
}
```
### Response36Afe1097B20_PeopleAlsoSearch
`#/components/schemas/Response36Afe1097B20_PeopleAlsoSearch`
```json
{
"type": "object",
"properties": {
"cid": {
"type": [
"string",
"null"
],
"description": "Google 定義的用戶端 ID
本地商家的唯一 ID
如需進一步瞭解此識別碼，請參閱這篇說明中心文章"
},
"feature_id": {
"type": [
"string",
"null"
],
"description": "SERP 中元素的唯一識別碼
如需進一步瞭解該識別碼，請參閱這篇說明中心文章"
},
"title": {
"type": [
"string",
"null"
],
"description": "SERP 中元素的標題
收集結果所針對的商家實體名稱"
},
"rating": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo"
}
],
"description": "元素的評分
依據評論並顯示於 SERP 的熱度評分"
}
}
}
```
### Response36Afe1097B20_PopularTimes
`#/components/schemas/Response36Afe1097B20_PopularTimes`
```json
{
"type": "object",
"properties": {
"popular_times_by_days": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_PopularWorkTimeInfo"
}
],
"description": "週日的營業時間"
}
},
"description": "熱門時段
本地商家每週各天忙碌時段的資訊"
}
}
}
```
### Response36Afe1097B20_PopularWorkTimeInfo
`#/components/schemas/Response36Afe1097B20_PopularWorkTimeInfo`
```json
{
"type": "object",
"properties": {
"time": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_TimeInfo"
}
],
"description": "24 小時制的小時"
},
"popular_index": {
"type": [
"integer",
"null"
],
"description": "人氣指數\n依時間衡量的相對人氣指數，範圍為 0 到 100；\n值越高表示一天中越繁忙的時段"
}
}
}
```
### Response36Afe1097B20_PriceInfo
`#/components/schemas/Response36Afe1097B20_PriceInfo`
```json
{
"type": "object",
"properties": {
"current": {
"type": [
"number",
"null"
],
"description": "目前價格\n表示結果中所展示產品或服務的目前價格",
"format": "double"
},
"regular": {
"type": [
"number",
"null"
],
"description": "一般價格\n表示未套用任何折扣的產品或服務一般價格",
"format": "double"
},
"max_value": {
"type": [
"number",
"null"
],
"description": "最高價格\n結果中所示產品或服務的最高價格",
"format": "double"
},
"currency": {
"type": [
"string",
"null"
],
"description": "所列價格的貨幣\n套用於該價格的貨幣 ISO 代碼"
},
"is_price_range": {
"type": [
"boolean",
"null"
],
"description": "價格以區間形式提供\n表示價格是否以區間形式提供"
},
"displayed_price": {
"type": [
"string",
"null"
],
"description": "結果中的價格字串\n結果中提供的原始價格字串"
}
}
}
```
### Response36Afe1097B20_RatingInfo
`#/components/schemas/Response36Afe1097B20_RatingInfo`
```json
{
"properties": {
"rating_type": {
"type": [
"string",
"null"
],
"description": "評分類型\n此處可以找到下列元素：Max5、Percents、CustomMax"
},
"value": {
"type": [
"number",
"null"
],
"description": "評分的值",
"format": "double"
},
"votes_count": {
"type": [
"integer",
"null"
],
"description": "回饋數量",
"format": "int64"
},
"rating_max": {
"type": [
"integer",
"null"
],
"description": "rating_type 的最大值"
}
}
}
```
### Response36Afe1097B20_TimeInfo
`#/components/schemas/Response36Afe1097B20_TimeInfo`
```json
{
"type": "object",
"properties": {
"hour": {
"type": [
"integer",
"null"
],
"description": "24 小時制的小時"
},
"minute": {
"type": [
"integer",
"null"
],
"description": "分鐘"
}
}
}
```
### Response36Afe1097B20_WorkDayInfo
`#/components/schemas/Response36Afe1097B20_WorkDayInfo`
```json
{
"type": "object",
"properties": {
"open": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_TimeInfo"
}
],
"description": "開始時間"
},
"close": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_TimeInfo"
}
],
"description": "結束時間"
}
}
}
```
### Response36Afe1097B20_WorkHours
`#/components/schemas/Response36Afe1097B20_WorkHours`
```json
{
"type": "object",
"properties": {
"timetable": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_WorkDayInfo"
}
],
"description": "週日的營業時間"
}
},
"description": "營業時間表"
},
"current_status": {
"type": [
"string",
"null"
],
"description": "商家的目前狀態
指出商家是否營業"
}
}
}
```