（瀑布流）企业搜索

POST

/api/company/search

公司搜索（CompanySearchService + parseCompanySearchAdvanced）。

顶层字段	说明
`page` / `per_page`	分页；服务端规范化
`waterfall`	`mode`、`source_order`、`byok`（自备密钥，见实现）
`company`	`names`、`domains`、`keywords`（仅 `include`）、`description_query` 等
`industry`	仅 `include`；亦可简写顶层 `industry: string[]` / 单字符串
`technologies`	`include` / `exclude`（Hunter 仍用 exclude；Apollo 仅 include）
`location`	`country_code`、`cities`、`states`、`regions`、`countries`
`size`	`employee_ranges`、`revenue_ranges`、`funding_ranges`
`funding`	`amount_min`、`amount_max`
`similar_to`	`domain` 或 `name`
`ecommerce`	StoreLead 电商筛选
`local_search`	Google Maps
`response`	`include_provider_raw`

请求参数

Header 参数

Body 参数application/json

示例

{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "apollo",
      "hunter",
      "rocketreach",
      "map",
      "storelead"
    ]
  },
  "company": {
    "names": [
      "Acme"
    ],
    "domains": [
      "stripe.com"
    ],
    "keywords": {
      "include": [
        "fintech"
      ]
    }
  },
  "industry": {
    "include": [
      "Computer Software"
    ]
  },
  "technologies": {
    "include": [
      "react"
    ],
    "exclude": [
      "wordpress"
    ]
  },
  "location": {
    "country_code": [
      "US"
    ],
    "cities": [
      "San Francisco"
    ],
    "states": [
      "California"
    ]
  },
  "size": {
    "employee_ranges": [
      {
        "min": 51,
        "max": 200
      }
    ]
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/company/search' \
--header 'Authorization: Bearer {{apiKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "apollo",
      "hunter",
      "rocketreach",
      "map",
      "storelead"
    ]
  },
  "company": {
    "names": [
      "Acme"
    ],
    "domains": [
      "stripe.com"
    ],
    "keywords": {
      "include": [
        "fintech"
      ]
    }
  },
  "industry": {
    "include": [
      "Computer Software"
    ]
  },
  "technologies": {
    "include": [
      "react"
    ],
    "exclude": [
      "wordpress"
    ]
  },
  "location": {
    "country_code": [
      "US"
    ],
    "cities": [
      "San Francisco"
    ],
    "states": [
      "California"
    ]
  },
  "size": {
    "employee_ranges": [
      {
        "min": 51,
        "max": 200
      }
    ]
  }
}'

返回响应

🟢200成功

application/json

Body

示例

{
  "success": true,
  "request_id": "req_xxx",
  "companies": [],
  "meta": {
    "total_results": 0,
    "page": 1,
    "per_page": 10,
    "has_more": false,
    "billing": {
      "credits_charged": 0,
      "byok_used": false,
      "platform_credits_charged": 0
    },
    "waterfall": {
      "mode": "first_match",
      "source_hit": null,
      "sources_attempted": [],
      "sources_skipped": [],
      "latency_ms": 0
    },
    "post_filtered": false
  },
  "error": null
}

🟠400请求有误

🟠401未认证

🟠402需要付款

🟠403权限不足

🟠409冲突

🟠429请求过多

修改于 2026-04-15 12:42:33

（智能体）任务数据

（瀑布流）企业详情