公开网页与企业联系人搜索

本页提供两项彼此独立的能力：根据查询词搜索公开网页资料，以及根据企业官网域名搜索联系人。它们不会自动生成包含财务、竞品等所有维度的完整企业调研报告。

两个接口都创建异步任务，结果通过任务对象返回。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"
  }'

成功任务的 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"
  }'

成功任务的 item.result 示例：

JSON复制
{
  "status": "done",
  "domain": "example.com",
  "company_name": "Example Inc.",
  "contacts": [
    {
      "email": "[email protected]",
      "status": "valid",
      "position": "VP Supply Chain",
      "first_name": "Alex",
      "last_name": "Morgan",
      "full_name": "Alex Morgan",
      "linkedin_url": "https://www.linkedin.com/in/example/"
    }
  ],
  "nodes": [
    {
      "id": "contact:[email protected]",
      "kind": "person",
      "title": "VP Supply Chain",
      "name": "Alex Morgan",
      "email": "[email protected]",
      "status": "valid",
      "linkedin_url": "https://www.linkedin.com/in/example/",
      "department": "Supply Chain",
      "seniority": "vp",
      "sort_order": 1
    }
  ],
  "edges": [
    {
      "from": "contact:[email protected]",
      "to": "department:supply-chain",
      "relation": "member_of",
      "confidence": 0.8,
      "sort_order": 1
    }
  ],
  "note": "The hierarchy is inferred from available contact titles and is not a verified reporting structure."
}

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

返回可用联系人时，result.status 为 done；搜索已完成但没有可用联系人时为 no_result。no_result 是成功的空结果，不能作为判断企业规模、透明度或质量的依据。