GET
/api/v4/reviews/site-config列出账户的评价来源
返回该账户可用的评价平台。所有套餐均可使用 Google Maps 和 Facebook,Growth 和 Enterprise 套餐可使用 Yelp。
参数
此端点不接受任何参数。
响应
200Account-level review source catalog.
{ "data": { "interactionSiteConfig": [ { "site": "Google", "siteUrl": "maps.google.com" }, { "site": "Facebook", "siteUrl": "facebook.com" }, { "site": "Yelp", "siteUrl": "yelp.com" } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
返回该账户根据其订阅有权使用的完整评价来源平台目录。上方响应是 Launch 套餐账户的实时目录,具体的网站集合取决于套餐和所属行业。
使用场景:配置地点前验证 name 值
siteUrl 字段是评价 API 中其他所有地方使用的规范网站标识符。连接地点的 Google 和 Facebook 资料后,系统会自动填充评价来源,无需手动添加或编辑。使用此目录可查找互动列表端点上有效的 siteUrls 筛选值。
使用场景:构建“连接您的评价”用户界面
为返回的每个网站渲染一行,以便地点所有者粘贴其在各个平台上的资料 URL。将此账户范围的目录(可连接的来源)与列出地点的评价来源(某个地点已连接的来源)配合使用,以展示已连接和可用的来源。
此端点不接受任何参数,作用范围为单个账户,因此多次调用的结果保持稳定;请缓存结果,无需为每个地点重新获取。此端点受账户速率限制约束;遇到 429 时,请根据 Retry-After 响应头进行退避重试。
Request
curl -X GET 'https://listingsapi.com/api/v4/reviews/site-config' \ -H "Authorization: API $LISTINGSAPI_KEY"