# 实时商家列表搜索任务

**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": "<em>商家类别</em><br>可选字段<br>指定的类别用于搜索商家列表；<br>如果未使用此字段，我们将返回指定位置中发现的商家列表；<br>最多可指定 <strong>10 个类别</strong>"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>SERP 中元素的描述</em><br>可选字段<br>收集结果所针对的商家实体的描述；<br>最多可包含 200 个字符"
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>SERP 中元素的标题</em><br>可选字段<br>收集结果所针对的商家实体的名称；<br>最多可包含 200 个字符"
          },
          "is_claimed": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>表示商家是否已由其所有者在 Google Maps 上验证</em><br>可选字段"
          },
          "location_coordinate": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>位置的 GPS 坐标</em><br>可选字段<br><code>location_coordinate</code> 参数应按 <em>\"latitude,longitude,radius\"</em> 格式指定<br><em>\"latitude\"</em> 和 <em>\"longitude\"</em> 的最大小数位数为 7<br><em>\"radius\"</em> 的值以公里（km）为单位<br><em>\"radius\"</em> 的最小值：<code>1</code><br><em>\"radius\"</em> 的最大值：<code>100000</code><br>示例：<br><code class=\"long-string\">53.476225,-2.243572,200</code><br>有关如何在此 API 中设置位置参数的更多信息，请参阅我们的<a href=\"https://dataforseo.com/help-center/how-to-specify-location-settings-in-business-listings-api\" target=\"_blank\">帮助中心</a>"
          },
          "filters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "object",
                "null"
              ]
            },
            "description": "<em>结果筛选参数数组</em><br>可选字段<br><strong>可同时添加多个筛选条件（最多 8 个）</strong><br>应在条件之间设置逻辑运算符 <code>and</code>、<code>or</code><br>支持以下运算符：<br><code>regex</code>, <code>not_regex</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&gt;=</code>, <code>=</code>, <code>&lt;&gt;</code>, <code>in</code>, <code>not_in</code>, <code>like</code>, <code>not_like</code>, <code>ilike</code>, <code>not_ilike</code>, <code>match</code>, <code>not_match</code><br>可将 <code>%</code> 运算符与 <code>like</code>、<code>not_like</code> 配合使用，匹配任意长度（含零个字符）的字符串<br>示例：<br><code>[\"rating.value\",\"&gt;\",3]</code><br>可单独向 <code>https://api.dataforseo.com/v3/business_data/business_listings/available_filters</code> 发起请求，获取可用的筛选条件列表<br>完整的可用筛选条件列表见<a href=\"/v3/business_data/business_listings/filters\" rel=\"noopener noreferrer\" target=\"_blank\">此处。</a>"
          },
          "order_by": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>结果排序规则</em><br>可选字段<br>可使用与 <code>filters</code> 数组相同的值对结果排序<br>可用的排序类型：<br><code>asc</code> - 结果按升序排列<br><code>desc</code> - 结果按降序排列<br>应使用逗号设置排序参数<br>示例：<br><code>[\"rating.value,desc\"]</code><strong>注意，单个请求中最多可设置三条排序规则</strong><br>应使用逗号分隔多条排序规则<br>示例：<br><code>[\"rating.value,desc\",\"rating.votes_count,desc\"]</code>"
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>返回的商家数量上限</em><br>可选字段<br>默认值：<code>100</code><br>最大值：<code>1000</code>"
          },
          "offset": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>返回的商家在结果数组中的偏移量</em><br>可选字段<br>默认值：<code>0</code><br>如果指定 <code>10</code>，结果数组中的前十个实体将被跳过，并返回后续实体的数据<br><strong>注意：</strong>建议仅在检索最多 10,000 条结果时使用此参数<br>如需检索超过 10,000 条结果，请改用 <code>offset_token</code>"
          },
          "offset_token": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>用于后续请求的令牌</em><br>可选字段<br>在每次请求响应的同名字段中提供；<br>使用此参数可在单次请求尝试获取超过 100,000 条结果时避免超时；<br>通过指定响应数组中的唯一 <code>offset_token</code> 值，你将获得初始任务的后续结果；<br><code>offset_token</code> 值对每个后续任务都是唯一的<br><strong>注意：</strong>如果请求中指定了 <code>offset_token</code>，所有其他参数都应与此前的请求保持一致<br>有关此参数的更多信息，请参阅我们的 <a href=\"https://dataforseo.com/help-center/what-is-the-difference-between-the-offset-and-offset_token-parameters#offset_token\" target=\"_blank\">帮助中心</a>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>用户自定义任务标识符</em><br>可选字段<br><em>字符数上限为 255</em><br>可使用此参数标识任务，并将其与结果对应<br>可在响应的 <code>data</code> 对象中找到指定的 <code>tag</code> 值"
          }
        },
        "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": "<em>本地商家所属的行政单位或区域</em>"
    },
    "address": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>本地商家的街道地址</em>"
    },
    "city": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>本地商家所在城市的名称</em>"
    },
    "zip": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>本地商家的邮政编码</em>"
    },
    "region": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>本地商家所属的 DMA 区域</em>"
    },
    "country_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>本地商家的 ISO 国家代码</em>"
    }
  }
}
```

### 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": "<em>可用属性</em><br>表示商家实体可提供的属性"
    },
    "unavailable_attributes": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "description": "<em>不可用属性</em><br>表示商家实体无法提供的属性"
    }
  }
}
```

### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveItem

`#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "元素类型"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>SERP 中元素的标题</em><br>收集结果所针对的商家实体的名称"
    },
    "original_title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>元素的原始标题</em><br>未经 Google 翻译的原始标题"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>SERP 中元素的描述</em><br>收集结果所针对的商家实体的描述"
    },
    "category": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>商家类别</em><br>最能描述商家实体所提供服务的 Google My Business 通用类别"
    },
    "category_ids": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>全局类别 ID</em><br>不随所选国家/地区变化的通用类别 ID"
    },
    "additional_categories": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>附加商家类别</em><br>更详细地描述商家实体所提供服务的其他 Google My Business 类别"
    },
    "cid": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>Google 定义的客户 ID</em><br>本地商家的唯一 ID<br>如需了解该标识符的更多信息，请参阅<a href=\"https://dataforseo.com/help-center/what-is-cid-place-id-feature-id\" target=\"_blank\" rel=\"noopener noreferrer\">这篇帮助中心文章</a>"
    },
    "feature_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>SERP 中元素的唯一标识符</em><br>如需了解该标识符的更多信息，请参阅<a href=\"https://dataforseo.com/help-center/what-is-cid-place-id-feature-id\" target=\"_blank\" rel=\"noopener noreferrer\">此帮助中心文章</a>"
    },
    "address": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>商家实体的地址</em>"
    },
    "address_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_AddressInfo"
        }
      ],
      "description": "<em>包含商家实体地址组成部分的对象</em>"
    },
    "place_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>唯一地点标识符</em><br>元素中出现的本地商家的<a href=\"https://developers.google.com/places/place-id\">地点 ID</a><br>如需了解该标识符的更多信息，请参阅<a href=\"https://dataforseo.com/help-center/what-is-cid-place-id-feature-id\" target=\"_blank\" rel=\"noopener noreferrer\">这篇帮助中心文章</a>"
    },
    "phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>商家实体的电话号码</em>"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>商家实体的绝对 URL</em>"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>商家实体的域名</em>"
    },
    "logo": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>Google 我的商家资料中展示的徽标 URL</em>"
    },
    "main_image": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>Google My Business 资料中展示的主图片 URL</em>"
    },
    "total_photos": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>Google My Business 资料中展示的图片总数</em>",
      "format": "int64"
    },
    "snippet": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>商家实体的附加信息</em>"
    },
    "latitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "<i>本地商家在 Google 地图中的纬度坐标</i><br>示例：<br><code>\"latitude\": 51.584091</code>"
    },
    "longitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "<i>本地商家在 Google 地图中的经度坐标</i><br>示例：<br><code>\"longitude\": -0.31365919999999997</code>"
    },
    "is_claimed": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<i>显示该实体是否已由其在 Google Maps 上的所有者验证</i>"
    },
    "attributes": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataAttributesInfo"
        }
      ],
      "description": "<em>以用户评价勾选项形式呈现的服务详情；</em><br>以勾选项形式展示、基于用户反馈和商家 <code>category</code> 的商家实体服务详情"
    },
    "place_topics": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>客户评论中提到的关键词</em><br>包含与商家实体客户评论中提到的产品/服务相关的最热门关键词，以及提及每个关键词的评论数量<br>示例：<code><br>\"place_topics\": {<br>\"egg roll\": 48,<br>\"birthday\": 33<br>}</code>"
    },
    "rating": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo"
        }
      ],
      "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": [
            "number",
            "null"
          ],
          "description": "rating_type 的最大值",
          "format": "double"
        }
      },
      "description": "<em>元素的评分 </em><br>基于评价并在 SERP 中显示的热度评分"
    },
    "hotel_rating": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>酒店星级评分</em><br>星级评分范围为 1-5 星，<a href=\"https://support.google.com/business/answer/7660515?hl=en\" rel=\"noopener noreferrer\" target=\"_blank\">了解更多</a><br>如果没有酒店星级评分信息，该值将为 <code>null</code>"
    },
    "price_level": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>场所价格水平</em><br>可取值：<code>inexpensive</code>、<code>moderate</code>、<code>expensive</code>、<code>very_expensive</code><br>如果没有价格水平信息，该值将为 <code>null</code>"
    },
    "rating_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "Int64"
      },
      "description": "<em>商家实体的评分分布</em><br>该对象显示用户评价的 1 星到 5 星评分数"
    },
    "people_also_search": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_PeopleAlsoSearch"
          }
        ]
      },
      "description": "<em>相关商家实体</em>"
    },
    "work_time": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_BusinessWorkHoursInfo"
        }
      ],
      "description": "<em>营业时间详情</em><br>与商家实体营业时间相关的信息"
    },
    "popular_times": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_PopularTimes"
        }
      ],
      "description": "<em>热门时段</em><br>与商家实体繁忙时段相关的信息"
    },
    "local_business_links": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BaseLocalBusinessLink"
          }
        ]
      },
      "description": "<em>与商家可用的互动</em><br>可直接从搜索结果与商家互动的选项列表"
    },
    "contact_info": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataContactInfo"
          }
        ]
      },
      "description": "<em>商家的可用联系方式</em><br>用于与商家联系的联系方式列表"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>搜索引擎结果的直接 URL</em><br>可用于确保我们提供了准确的结果"
    },
    "last_updated_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>数据最后更新的日期和时间</em><br>采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”<br>示例：<br><code>2023-01-26 09:03:15 +00:00</code>"
    },
    "first_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>我们的爬虫首次发现该商家信息元素的日期和时间</em><br>采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”<br>示例：<br><code>2023-03-11 10:04:11 +00:00</code>"
    },
    "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": "<em>任务数组</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResultInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>我们数据库中与你的请求相关的结果总数</em>",
      "format": "int64"
    },
    "count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>条目类型</em><br><code>items</code> 数组中的条目数",
      "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": "<em>遇到的条目类型</em><br><code>items</code> 数组中出现的搜索引擎结果类型；<br>可能的条目类型：<code>business_listing</code>"
    }
  }
}
```

### 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": "<em>结果数组</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BusinessDataContactInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataContactInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "元素类型"
    },
    "value": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>评分的值</em>"
    },
    "source": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>数据来源</em>"
    }
  }
}
```

### Response36Afe1097B20_BusinessDataServiceInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataServiceInfo`

```json
{
  "type": "object",
  "properties": {
    "category": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>商家类别</em><br>最能描述商家实体所提供服务的 Google My Business 通用类别"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>SERP 中元素的标题</em><br>收集结果所针对的商家实体的名称"
    },
    "snippet": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>商家实体的附加信息</em>"
    },
    "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": "<em>营业时间</em><br>本地商家的营业时间信息"
    }
  }
}
```

### Response36Afe1097B20_PeopleAlsoSearch

`#/components/schemas/Response36Afe1097B20_PeopleAlsoSearch`

```json
{
  "type": "object",
  "properties": {
    "cid": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>Google 定义的客户 ID</em><br>本地商家的唯一 ID<br>如需了解该标识符的更多信息，请参阅<a href=\"https://dataforseo.com/help-center/what-is-cid-place-id-feature-id\" target=\"_blank\" rel=\"noopener noreferrer\">这篇帮助中心文章</a>"
    },
    "feature_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>SERP 中元素的唯一标识符</em><br>如需了解该标识符的更多信息，请参阅<a href=\"https://dataforseo.com/help-center/what-is-cid-place-id-feature-id\" target=\"_blank\" rel=\"noopener noreferrer\">此帮助中心文章</a>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>SERP 中元素的标题</em><br>收集结果所针对的商家实体的名称"
    },
    "rating": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo"
        }
      ],
      "description": "<em>元素的评分 </em><br>基于评价并在 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": "<em>热门时段</em><br>本地商家每周各天繁忙时段的信息"
    }
  }
}
```

### 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": "<em>营业时间表</em>"
    },
    "current_status": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>商家的当前状态</em><br>指示商家是否营业"
    }
  }
}
```