RevorRevor

企业研究 API

企业研究 API 包含公开网页搜索和企业联系人搜索。两个接口都创建异步任务，结果通过任务对象返回。Idempotency-Key 可选；需要安全重试时建议发送并复用同一个值。

可选发送 Prefer: wait=20。如果任务在等待窗口内结束，接口直接返回 HTTP 200；否则返回 HTTP 202，调用方继续轮询 /api/v2/jobs/{id}。

公开网页研究

POST/api/v2/research/public-web
cURL
curl -X POST "https://revor.ai/api/v2/research/public-web" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait=20" \
  -d '{
    "queries": ["Banbros Commercial Inc company profile"],
    "search_limit": 5,
    "category": "company",
    "include_domains": [],
    "user_location": "US"
  }'
字段类型必填限制
queriesstring[]是1-2 条；每条最多 500 字符。
search_limitinteger否每条 query 返回 1-10 个来源，默认 10。
categorystring否company、news、financial report、people、personal site。
include_domainsstring[]否最多 5 个域名。
user_locationstring否两位国家代码，例如 US。

成功任务的 item.result：

JSON
{
  "status": "complete",
  "queries": ["Banbros Commercial Inc company profile"],
  "searched_queries": 1,
  "results_per_query": 5,
  "results": [
    {
      "query": "Banbros Commercial Inc company profile",
      "sources": [
        {
          "url": "https://example.com/company",
          "title": "Company Profile",
          "published_date": null,
          "author": null,
          "image": null,
          "highlights": ["..."],
          "text": "..."
        }
      ]
    }
  ],
  "errors": []
}

单个 query 失败而其他 query 成功时，status 可能为 partial，失败项记录在 errors。每个来源正文会被限制长度，...[truncated] 表示该来源的正文已按返回长度裁剪。

企业联系人搜索

POST/api/v2/research/contacts

必须使用已确认的企业官网域名，不要使用公司名称或 LinkedIn URL 替代 domain。

cURL
curl -X POST "https://revor.ai/api/v2/research/contacts" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait=20" \
  -d '{
    "domain": "example.com",
    "positions": ["procurement", "supply chain", "purchasing"],
    "limit": 20,
    "locale": "en"
  }'
字段类型必填限制
domainstring是官网域名；会移除协议和 www.。
positionsstring[]否最多 30 个职位关键词，每项最多 80 字符。
limitinteger否1-50，默认 20。
localestring否en 或 zh，默认 en。

成功任务的 item.result 包含：

  • status、domain、company_name；
  • contacts：邮箱、职位、姓名和 LinkedIn URL；
  • nodes / edges：根据职位推断的组织关系；
  • note：结果边界说明。

组织层级是根据可用职位信息推断的，不是经过企业确认的正式汇报关系。上游联系人数据按原始结果返回，API 不猜测或修正身份。