通过

Yelp （独立出版商） （预览版）

Yelp 连接器允许你从 32 个国家/地区的数百万家企业获得最佳本地内容、兴趣点和用户评论。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name 艾哈迈德·纳贾尔
Email ahmadn82@hotmail.com
连接器元数据
发布者 艾哈迈德·纳贾尔
网站 https://www.yelp.com/
隐私策略 https://terms.yelp.com/privacy/

创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
Yelp API 密钥 securestring 提供 Yelp API 密钥作为“Bearer API_KEY” True

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

搜索企业

按术语（关键字）、类别、位置、价格级别等搜索企业。当你对 biz 有常规信息（如名称和位置，但不知道地址）时，请使用此作。
搜索商务电话

根据提供的电话号码返回企业列表。 如果只有电话号码或对其他匹配条件不太有信心，请使用此作。
查找业务匹配

查找与确切输入位置匹配的 Yelp 业务。 使用此作将来自其他源的业务数据与 Yelp 业务匹配。
自动完成

为企业、搜索关键字和类别提供自动完成建议。
获取业务详细信息

获取丰富的业务数据，如姓名、地址、电话号码、照片、Yelp 评级、价格水平和作小时数。
获取评论

最多获得三个企业评论摘录。

搜索企业

操作 ID:
BusinessSearch

按术语（关键字）、类别、位置、价格级别等搜索企业。当你对 biz 有常规信息（如名称和位置，但不知道地址）时，请使用此作。

参数

名称 密钥 必需 类型 说明
术语（关键字）
 term True string

搜索词，例如“restaurants”。 术语也可能是业务名称。
位置
 location True string

搜索企业时使用的地理区域。 例如纽约、纽约
Latitude
 latitude double

要搜索的位置的纬度。
Longtitude
 longtitude double

要搜索附近位置的经度。
半径
 radius integer

建议的搜索半径（以米为单位）。 （最大值：40000米）
类别
 categories string

（请参阅 https://bit.ly/3jnraj5）
区域设置
 locale string

默认en_US。 （请参阅 https://bit.ly/3lwvIWU）
限度
 limit integer

要返回的业务结果数。 默认值 （20）。 最大值（50）
Offset
 offset integer

按此金额抵消返回的业务结果列表。
排序依据
 sort_by string

对搜索算法的建议，即结果的排序依据。
立即打开
 open_now boolean

（Default=false）。 如果设置为 true，则仅返回现在打开的企业。

返回

名称 路径 类型 说明
Total
 total integer

根据搜索条件查找的业务 Yelp 总数。 有时，该值可能超过 1000。 在这种情况下，你仍只能使用多个查询和“限制”和“偏移”参数的组合获取多达 1000 家企业。
企业
 businesses array of object

根据搜索条件找到的业务 Yelp 列表。
Rating
 businesses.rating float

此业务评级（值范围为 1、1.5...4.5, 5).
价格
 businesses.price string

业务的价格水平。 值是 $、$、$$ 和 $$$$ 之一。
电话
 businesses.phone string

业务的电话号码。
ID
 businesses.id string

此业务的唯一 Yelp ID。
别名
 businesses.alias string

此业务的唯一 Yelp 别名。 可以包含 unicode 字符。 示例：“yelp-san-francisco”
已关闭
 businesses.is_closed boolean

业务是否已（永久）关闭
categories
 businesses.categories array of object

与此业务关联的类别标题和别名对的列表。
别名
 businesses.categories.alias string

类别的别名，在特定类别中搜索业务时，请使用别名而不是标题。
title
 businesses.categories.title string

用于显示目的的类别标题。
审阅计数
 businesses.review_count integer

此业务的评论数。
Name
 businesses.name string

此业务的名称。
URL
 businesses.url string

Yelp 上的业务页的 URL。
Latitude
 businesses.coordinates.latitude float

此业务的纬度。
Longitude
 businesses.coordinates.longitude float

此业务的经度。
图像 URL
 businesses.image_url string

此业务的照片 URL。
City
 businesses.location.city string

此业务的城市
国家
 businesses.location.country string

此业务的国家/地区代码。 （ISO 3166-1 alpha-2）
地址 2
 businesses.location.address2 string

此业务的街道地址继续。
地址 3
 businesses.location.address3 string

此业务的街道地址继续。
State
 businesses.location.state string

此业务的状态代码。 ISO 3166-2（有几个例外）
地址 1
 businesses.location.address1 string

此业务的街道地址。
邮政编码
 businesses.location.zip_code string

此业务的邮政编码。
距离
 businesses.distance float

距离搜索位置的距离（以米为单位）。 无论区域设置如何，这都会返回计量。
事务
 businesses.transactions array of string

注册业务的 Yelp 事务列表。 当前支持的值是取件、交付和restaurant_reservation。
Latitude
 region.center.latitude double

地图边界中心的纬度位置。
Longitude
 region.center.longitude double

地图边界中心的经度位置。

搜索商务电话

操作 ID:
PhoneSearch

根据提供的电话号码返回企业列表。 如果只有电话号码或对其他匹配条件不太有信心，请使用此作。

参数

名称 密钥 必需 类型 说明
电话
 phone True string

要搜索的业务的电话号码。 （如 +14159083801）
区域设置
 locale string

默认en_US。 （请参阅 https://bit.ly/3lwvIWU）

返回

名称 路径 类型 说明
总
 total integer

总
企业
 businesses array of object

企业
分级
 businesses.rating float

分级
price
 businesses.price string

price
phone
 businesses.phone string

phone
id
 businesses.id string

id
别名
 businesses.alias string

别名
categories
 businesses.categories array of object

categories
别名
 businesses.categories.alias string

别名
title
 businesses.categories.title string

title
review_count
 businesses.review_count integer

review_count
姓名
 businesses.name string

姓名
网址
 businesses.url string

网址
latitude
 businesses.coordinates.latitude float

latitude
longitude
 businesses.coordinates.longitude float

longitude
image_url
 businesses.image_url string

image_url
is_closed
 businesses.is_closed boolean

is_closed
城市
 businesses.location.city string

城市
country
 businesses.location.country string

country
地址2
 businesses.location.address2 string

地址2
address3
 businesses.location.address3 string

address3
状态
 businesses.location.state string

状态
地址1
 businesses.location.address1 string

地址1
zip_code
 businesses.location.zip_code string

zip_code
事务
 businesses.transactions array of string

事务

查找业务匹配

操作 ID:
BusinessMatch

查找与确切输入位置匹配的 Yelp 业务。 使用此作将来自其他源的业务数据与 Yelp 业务匹配。

参数

名称 密钥 必需 类型 说明
Name
 name True string

企业名称。 最大长度为 64;只允许数字、字母、空格和 ！#$%&+、./：？@'。
地址 1
 address1 True string

业务地址的第一行。 最大长度为 64;仅允许数字、字母、空格和 /#>。。 允许空字符串“”;这将专门匹配没有街道地址的某些服务企业。
地址 2
 address2 string

业务地址的第二行。 最大长度为 64;仅允许数字、字母、空格和 /#>。。
地址 3
 address3 string

业务地址的第三行。 最大长度为 64;仅允许数字、字母、空格和 /#>。。
City
 city True string

商业之城。 最大长度为 64;仅数字、字母、空格和 。（） 是允许的。
State
 state True string

此业务的 ISO 3166-2（有几个例外）状态代码。 最大长度为 3。
国家
 country True string

此业务的 ISO 3166-1 alpha-2 国家/地区代码。 最大长度为 2。
Latitude
 latitude double

业务 WGS84 纬度（以十进制度为单位）。 必须介于 -90 和 +90 之间。
Longitude
 longitude double

业务 WGS84 经度（以十进制度为单位）。 必须介于 -180 和 +180 之间。
电话
 phone string

只能以数字（例如，016703080）或（b）格式（仅在 （+35316703080）之后（+35316703080）格式的国际格式的企业的电话号码。 最大长度为 32。
邮政编码
 zip_code string

此业务的邮政编码。
Yelp 业务 ID
 yelp_business_id string

业务的唯一 Yelp 标识符（如果可用）。 在查找匹配业务时用作提示。
限度
 limit integer

要返回的最大业务结果数。 默认情况下，它将返回 3。 最小值为 1，最大值为 10。
匹配阈值
 match_threshold integer

指定是否应将匹配质量阈值应用于匹配的企业。 必须是“none”、“default”或“strict”之一。 none：不应用任何匹配质量阈值;将返回所有潜在的业务匹配项。 默认值：应用匹配质量阈值，以便仅返回非常匹配的企业。 strict：应用非常严格的匹配质量阈值。

返回

名称 路径 类型 说明
array of object
姓名
 name string

姓名
地址1
 location.address1 string

地址1
地址2
 location.address2 string

地址2
address3
 location.address3 string

address3
城市
 location.city string

城市
状态
 location.state string

状态
zip_code
 location.zip_code string

zip_code
country
 location.country string

country
latitude
 coordinates.latitude float

latitude
longitude
 coordinates.longitude float

longitude
phone
 phone string

phone
id
 id string

id
别名
 alias string

别名

自动完成

操作 ID:
Autocomplete

为企业、搜索关键字和类别提供自动完成建议。

参数

名称 密钥 必需 类型 说明
文本
 text True string

要返回自动完成建议的文本。
Latitude
 latitude True double

如果需要获取企业的自动完成建议，则为必需。 查找业务自动完成建议的位置的纬度。
Longitude
 longitude True double

如果需要获取企业的自动完成建议，则为必需。 要查找业务自动完成建议的位置的经度。
区域设置
 locale string

默认en_US。 （请参阅 https://bit.ly/3lwvIWU）

返回

名称 路径 类型 说明
条款
 terms array of object

条款
文本消息
 terms.text string

文本消息
企业
 businesses array of object

企业
姓名
 businesses.name string

姓名
id
 businesses.id string

id
文本消息
 businesses.text string

文本消息
categories
 categories array of object

categories
别名
 categories.alias string

别名
title
 categories.title string

title

获取业务详细信息

操作 ID:
BusinessDetails

获取丰富的业务数据，如姓名、地址、电话号码、照片、Yelp 评级、价格水平和作小时数。

参数

名称 密钥 必需 类型 说明
ID
 id True string

此业务的唯一 Yelp ID。
区域设置
 locale string

默认en_US。 （请参阅 https://bit.ly/3lwvIWU）

返回

名称 路径 类型 说明
id
 id string

id
别名
 alias string

别名
姓名
 name string

姓名
image_url
 image_url string

image_url
is_claimed
 is_claimed boolean

is_claimed
is_closed
 is_closed boolean

is_closed
网址
 url string

网址
phone
 phone string

phone
display_phone
 display_phone string

display_phone
review_count
 review_count integer

review_count
categories
 categories array of object

categories
别名
 categories.alias string

别名
title
 categories.title string

title
分级
 rating float

分级
地址1
 location.address1 string

地址1
地址2
 location.address2 string

地址2
address3
 location.address3 string

address3
城市
 location.city string

城市
zip_code
 location.zip_code string

zip_code
country
 location.country string

country
状态
 location.state string

状态
display_address
 location.display_address array of string

display_address
cross_streets
 location.cross_streets string

cross_streets
latitude
 coordinates.latitude float

latitude
longitude
 coordinates.longitude float

longitude
photos
 photos array of string

photos
price
 price string

price
小时
 hours array of object

小时
开启
 hours.open array of object

开启
is_overnight
 hours.open.is_overnight boolean

is_overnight
开始
 hours.open.start string

开始
end
 hours.open.end string

end
日
 hours.open.day integer

日
hours_type
 hours.hours_type string

hours_type
is_open_now
 hours.is_open_now boolean

is_open_now
事务
 transactions array of

事务
special_hours
 special_hours array of object

special_hours
date
 special_hours.date string

date
is_closed
 special_hours.is_closed string

is_closed
开始
 special_hours.start string

开始
end
 special_hours.end string

end
is_overnight
 special_hours.is_overnight boolean

is_overnight

获取评论

操作 ID:
Reviews

最多获得三个企业评论摘录。

参数

名称 密钥 必需 类型 说明
ID
 id True string

此业务的唯一 Yelp ID。
区域设置
 locale string

默认en_US。 （请参阅 https://bit.ly/3lwvIWU）

返回

名称 路径 类型 说明
评审
 reviews array of object

评审
id
 reviews.id string

id
分级
 reviews.rating integer

分级
id
 reviews.user.id string

id
profile_url
 reviews.user.profile_url string

profile_url
image_url
 reviews.user.image_url string

image_url
姓名
 reviews.user.name string

姓名
文本消息
 reviews.text string

文本消息
time_created
 reviews.time_created string

创建时间
网址
 reviews.url string

网址
总
 total integer

总
possible_languages
 possible_languages array of string

可能的语言