Skip to main content
本快速开始用 cURL、Python 或 Node.js 运行一次公司搜索,并读懂响应的三个部分: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:
请求返回 HTTP 200,响应体以 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 表示索引的一部分未能及时响应,结果集是不完整的。

你完成了什么,以及接下来做什么

我们发送了一次自然语言公司搜索,并读懂了返回的记录。接下来可以在 什么是 Business Search中判断你需要大规模候选集还是排序精选列表。然后参照 Business Search 查询语法编写第一个结构化查询。