POST 公司搜索

POST

/api/company/search

请求参数

Header 参数

Body 参数application/json

示例

{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "hunter",
      "apollo",
      "rocketreach",
      "map",
      "ecommerce"
    ],
    "byok": {
      "apollo_api_key": "<YOUR_APOLLO_KEY>",
      "hunter_api_key": "<YOUR_HUNTER_KEY>",
      "rocketreach_api_key": "<YOUR_ROCKETREACH_KEY>",
      "storelead_api_key": "<YOUR_STORELEAD_KEY>",
      "serper_api_key": "<YOUR_SERPER_KEY>",
      "snov_client_id": "<YOUR_SNOV_CLIENT_ID>",
      "snov_client_secret": "<YOUR_SNOV_CLIENT_SECRET>"
    }
  },
  "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
      }
    ],
    "revenue_ranges": [
      {
        "min": 1000000,
        "max": 50000000
      }
    ]
  },
  "funding": {
    "amount_min": 500000,
    "amount_max": 15000000
  },
  "similar_to": {
    "domain": "notion.so"
  },
  "ecommerce": {
    "enabled": true,
    "platforms": [
      "shopify"
    ],
    "rank_platform": {
      "rank_min": 1,
      "rank_max": 50000,
      "percentile_min": 0,
      "percentile_max": 1
    },
    "rank_global": {
      "rank_min": 1,
      "rank_max": 200000,
      "percentile_min": 0,
      "percentile_max": 1
    }
  },
  "local_search": {
    "enabled": true,
    "location": "@30.27,-97.74,11z",
    "language": "en",
    "place_id": "",
    "cid": ""
  },
  "response": {
    "include_provider_raw": false
  }
}

请求示例代码

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": [
      "hunter",
      "apollo",
      "rocketreach",
      "map",
      "ecommerce"
    ],
    "byok": {
      "apollo_api_key": "<YOUR_APOLLO_KEY>",
      "hunter_api_key": "<YOUR_HUNTER_KEY>",
      "rocketreach_api_key": "<YOUR_ROCKETREACH_KEY>",
      "storelead_api_key": "<YOUR_STORELEAD_KEY>",
      "serper_api_key": "<YOUR_SERPER_KEY>",
      "snov_client_id": "<YOUR_SNOV_CLIENT_ID>",
      "snov_client_secret": "<YOUR_SNOV_CLIENT_SECRET>"
    }
  },
  "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
      }
    ],
    "revenue_ranges": [
      {
        "min": 1000000,
        "max": 50000000
      }
    ]
  },
  "funding": {
    "amount_min": 500000,
    "amount_max": 15000000
  },
  "similar_to": {
    "domain": "notion.so"
  },
  "ecommerce": {
    "enabled": true,
    "platforms": [
      "shopify"
    ],
    "rank_platform": {
      "rank_min": 1,
      "rank_max": 50000,
      "percentile_min": 0,
      "percentile_max": 1
    },
    "rank_global": {
      "rank_min": 1,
      "rank_max": 200000,
      "percentile_min": 0,
      "percentile_max": 1
    }
  },
  "local_search": {
    "enabled": true,
    "location": "@30.27,-97.74,11z",
    "language": "en",
    "place_id": "",
    "cid": ""
  },
  "response": {
    "include_provider_raw": false
  }
}'

返回响应

🟢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-18 17:51:40

04 业务数据（Bearer 填 apiKey）

POST 公司 enrich