req_id、meta 和 documents。
前提条件
- 一个已开通 Business Search 权限的 Bright Data 账户。Business Search 目前处于早期访问阶段;如果尚未开通,请发送邮件至 sales@brightdata.com
第 1 步:获取并设置 API key
进入您的 Bright Data 账户中的用户设置页面并创建一个 API key,或使用已有的 key。API key 只在创建时显示一次,请复制并妥善保存。参见身份验证。 我们把 key 存入环境变量,避免出现在命令历史或被提交的文件中。下一步的请求会从该变量读取 key:第 2 步:发送公司搜索请求
我们使用 Instant 模式查找员工数在 50 到 500 之间的美国软件公司。view: "summary" 表示返回紧凑记录,而不是默认的 id_only:
req_id 开头。三个标签页都会打印该响应体。
如果响应体是 {"error":"Invalid token"} 且状态码为 HTTP 401,说明 key 缺失、无效或已过期。请检查第 1 步中导出的值。HTTP 403 表示该 key 对应的账户未激活,或尚未加入 Business Search 允许列表。请联系 sales@brightdata.com 申请开通权限。
第 3 步:读懂响应
成功的响应包含请求元数据和一个documents 数组。下面是一次真实请求返回的 10 条记录中的第一条,省略了 url 和 logo:
req_id、matched 数量和记录都会与此示例不同。索引每日刷新,因此结果在不同运行之间会变化。
req_id 标识本次请求。请保留它用于排查问题,并在提交工单时附上。
如何解读返回结果:
documents为空数组表示搜索已执行但没有匹配,这并不证明不存在这样的公司。meta.matched是本次搜索触及的匹配数下限,不是总数,且在不同运行之间会变化。meta.coverage_percent低于 100 表示索引的一部分未能及时响应,结果集是不完整的。