Publisher Reviews API

Empower your digital marketing with LDE's Business Reviews API, the ultimate API-first integration partner for local SaaS marketing. Streamline reputation management, aggregate business review data, automate responses, and gain invaluable market insights. Trusted by industry leaders, our API offers seamless integration, scalable infrastructure, and flexible pricing for comprehensive reputation management solutions

原始信息汇总

数据集概述：Publisher Reviews API

• API 名称：Publisher Reviews API
• API 版本：1.0.0（当前版本）
• 定价模式：Freemium（免费增值），提供 BASIC 和 PRO 订阅方案
• 类别：商业软件 (Business Software)
• API 创建者：Local Data Exchange（订阅者：2）

---

核心功能

该 API 允许用户以编程方式从多个发布商（Publisher）处统一检索和管理客户评论。它能够将不同平台的评论和评分聚合为标准格式，简化情感分析、性能监控和反馈响应流程，无需分别与每个发布商进行集成。

---

使用场景

• 客户成功团队：可聚合来自多个发布商的评论至统一仪表板，便于监控反馈、分析情感并高效响应。
• 本地化 SaaS 营销：通过该 API 简化声誉管理、聚合商业评论数据、自动化回复，并获取市场洞察。

---

环境与认证

• 生产环境 URL：https://api.ldex.co/publisher-reviews
• 测试环境 URL：https://staging-api.ldex.co/publisher-reviews
• 认证方式：每个消息负载必须包含消费者的 API Key（放置在 data 数组中的 api_key 字段）

---

请求与响应机制

请求方式

• 用户将 JSON 格式的消息发送至 Amazon SQS 队列。
  • 生产队列：https://sqs.us-west-2.amazonaws.com/501388824769/request-reviews
  • 测试队列：https://sqs.us-west-2.amazonaws.com/501388824769/dev-request-reviews
• 请求消息中需指定 job 为 AppJobsRequestReviews，并包含 foreign_key（外部 ID）、lazy（超时限制布尔值）、business（商业信息）以及 publishers（待查询的发布商列表及其配置，如 profile_key、last_review_hashes、first_page_only、persona 等）。

响应方式

• 完成后，每个发布商的评论结果将分别放置在客户端专属的 SQS 队列中。
• 响应消息包含 foreign_key、batch_id、task_id、task_status、business 信息、publisher、profile_key、reviews_urls（评论文件 URL 列表）以及 histogram（评分直方图）。
• 每个评论条目包含 rating（评分）、review_hash（哈希值）、text（评论内容，Base64 编码）、posted_at、author_name（作者名，Base64 编码）等字段。

---

支持的任务状态码

状态码	含义
200	正常
400	未找到企业页面（可能 profile_key 错误）
401	未授权访问
404	未找到企业
422	无效的负载
429	因自动重试被发布商限制（请求过多）
450	检测到页面格式变更
451	发布商逆向加解密失败
452	城市和州的地理服务失败
460	企业无评论
461	企业无新评论
472	Google 的特殊案例失败
500	未知错误
503	服务不可用
504	处理超时
505	致命不可恢复错误（自动创建工单）
530	部分成功（部分评论可检索，部分失败）
532	内部状态，表示任务属于一个大组（正在检索大量评论）

---

支持的发佈商列表

该 API 支持超过 50 家发布商，包括但不限于：Airbnb、Angies List、Apartmentratings、Apartments.com、Avvo、BBB、Carfax、Care.com、Caring.com、Citysearch、Clearsurance、Dealerrater、Edmunds、Expedia、Facebook、Foursquare、Gayot、Glassdoor、Golfnow、Greatschools、Grubhub、Healthgrades、HomeAdvisor、HomeStars、Houzz、Indeed、Judysbook、Lawyers、Google Maps、OpenTable、Orbitz、RateMDs、RealSelf、Superpages、The Knot、Travelocity、Tripadvisor、Trustpilot、Vitals、VRBO、WebMD、Weddingwire、Wellness、Yellowpages、Yelp、Zillow、Zocdoc、Zomato 等。

注意事项：

• 客户端仅能消费其被授权的特定发布商数据。
• Foursquare 已弃用其网站和 App，无法拉取新的评论。
• Zillow 的某些 URL 模式（如 zillow.com/b/、zillow.com/homes/ 等）不提供公寓评论。

---

自定义搜索：Presence Search

• 用户可提交 social_profile: True 配置，以查找指定发布商上是否存在企业档案，而非拉取具体评论。
• 响应中不会包含 reviews_urls 和 histogram。

---

错误处理

• 若处理请求时出错，错误消息将以 JSON 格式放入客户端专属 SQS 队列。
• 错误消息包含 error（包含错误码和描述）以及原始 payload。
• 支持的错误码：400（错误请求）、401（未认证）。