# 公司数据 关键词搜索 API (company_data.search)

- Canonical page: https://everyinfra.com/company-data-api/search
- Endpoint: POST /api/v1/social with {"platform": "company_data", "action": "search", "params": {...}}
- Price: $0.003194 per call ($3.19 per 1,000 requests); failed and empty results are not charged
- Returns: list, default 10, max 10 per call
- Mode: sync; add "mode": "async" for slow tasks

公司数据关键词搜索用一句话描述要找的公司，最多 500 字，一次返回 10 家。每家除名称、主域名和简介外，还有组织类型 `organization_type`、经营状态 `operating_status`、行业 `industries`、成立年份、总部位置、员工数、收入估计和融资情况，可用来搭建目标公司名单。

`country` 用两位国家码限定总部国家，如 US、GB、IE；`employees_min` 和 `employees_max` 限定员工数，区间有交集就算。`employee_count` 在只有区间时没有。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=company_data&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 用一句话描述要找的公司，最多 500 字，例如 payment infrastructure companies in Ireland；一次返回 10 家。 |
| country | not declared | no | not declared | 只要总部在这个国家的公司，两位国家码，例如 US、GB、IE（search）。 |
| employees_max | integer | no | not declared | 员工数上限（search）。 |
| employees_min | integer | no | not declared | 员工数下限（search）；员工数是区间时有交集就算。 |
| limit | integer (1–10) | no | 10 | 这次调用最多返回的条数，整数，1–10；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| domain | 公司主域名，例如 stripe.com。 |
| description | 简介或描述，通常比 text 短。 |
| organization_type | 组织类型（search），例如 privately_held、public_company。 |
| operating_status | 经营状态（search），例如 active。 |
| industries | 所属行业列表（search）。 |
| founded_year | 成立年份（search）。 |
| hq_country_code | 总部国家两位代码（search）。 |
| hq_region | 总部所在省州（search）。 |
| hq_city | 总部城市（search）。 |
| hq_street_address | 总部街道地址（search）。 |
| hq_postal_code | 总部邮编（search）。 |
| employee_count | 员工数（search）；只有区间时没有。 |
| employees_min | 员工数区间下限（search）。 |
| employees_max | 员工数区间上限（search）。 |
| revenue_min_usd | 年收入估计下限，美元（search）。 |
| revenue_max_usd | 年收入估计上限，美元（search）。 |
| funding_total_usd | 累计融资额，美元（search）；没有融资记录时没有。 |
| funding_round_count | 融资轮数（search）。 |
| funding_stage | 融资阶段（search），例如 seed、series_a、no_funding_yet。 |
| latest_round | 最近一轮融资（search）：type、date、amount_usd。 |
| funding_rounds | 全部融资轮次（search），每轮有 type、date、amount_usd。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "company_data",
  "action": "search",
  "params": {
    "keyword": "payment infrastructure companies in Ireland"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "company_data",
        "action": "search",
        "params": {
            "keyword": "payment infrastructure companies in Ireland",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "company_data",
  "action": "search",
  "results": [
    {
      "name": …,
      "domain": …,
      "description": …,
      "organization_type": …,
      "operating_status": …,
      "industries": …,
      "founded_year": …,
      "hq_country_code": …,
      "hq_region": …,
      "hq_city": …,
      "hq_street_address": …,
      "hq_postal_code": …,
      "employee_count": …,
      "employees_min": …,
      "employees_max": …,
      "revenue_min_usd": …,
      "revenue_max_usd": …,
      "funding_total_usd": …,
      "funding_round_count": …,
      "funding_stage": …,
      "latest_round": …,
      "funding_rounds": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### `keyword` 怎么写才找得准？

按「一句话描述」写：什么类型的公司、在哪个地区，例如 payment infrastructure companies in Ireland，最多 500 字。它描述的是想找的那类公司，不是按品牌名匹配；已知品牌名或域名时，用品牌检索更直接。

### 员工数筛选怎么算区间？

`employees_min` 是下限，`employees_max` 是上限，可以只传一个。公司的员工数本身是区间时，只要与你给的范围有交集就算命中。返回里 `employee_count` 是具体员工数，区间在 `employees_min` 和 `employees_max`。

### 融资信息有哪些，没有融资记录怎么办？

`funding_stage` 如 seed、series_a、no_funding_yet；`funding_round_count` 是轮数，`latest_round` 是最近一轮，`funding_rounds` 是全部轮次，每轮有类型、日期和融资额（美元）。没有融资记录时没有 `funding_total_usd`，按缺失处理，别当成 0。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=company_data
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md