generect-api

搜索 B2B 潜在客户和公司，通过 Geneect Live API 查找/验证电子邮件。当用户需要按职位/公司/行业查找人员、按 ICP 搜索公司、从名称+域生成商业电子邮件或验证电子邮件地址时使用。涵盖潜在客户开发、勘探、丰富和电子邮件发现工作流程。

# Generect Live API

Real-time B2B data from LinkedIn, Crunchbase, and AI-powered email discovery.

**Base URL:** `https://api.generect.com`
**Auth:** `Authorization: Token <GENERECT_API_KEY>`

## Setup

Requires `GENERECT_API_KEY` environment variable. Get a key at https://beta.generect.com

## Endpoints

### Search Leads
`POST /api/v1/leads/by_icp/`

Find people by ICP filters. Returns enriched LinkedIn profiles with job history, education, skills.

```json
{
  "job_title": ["CEO", "CTO"],
  "location": ["United States"],
  "industry": ["Software Development"],
  "company_headcount_range": ["11-50", "51-200"],
  "page": 1,
  "per_page": 10
}
```

Key filters: `job_title`, `location`, `industry`, `company_headcount_range`, `company_name`, `seniority_level`, `job_function`. All accept arrays.

Response: `{ "amount": N, "leads": [...] }` — each lead has `full_name`, `headline`, `job_title`, `company_name`, `company_website`, `linkedin_url`, `jobs[]`, `educations[]`, `skills[]`.

### Search Companies
`POST /api/v1/companies/by_icp/`

Find companies by ICP. Returns company profiles with headcount, industry, location, funding.

```json
{
  "industry": ["Software Development"],
  "location": ["San Francisco"],
  "headcount_range": ["51-200"],
  "page": 1,
  "per_page": 10
}
```

Key filters: `industry`, `location`, `headcount_range`, `company_type`, `founded_year_min`, `founded_year_max`, `keyword`.

Response: `{ "amount": N, "companies": [...] }` — each has `name`, `domain`, `industry`, `headcount_range`, `headcount_exact`, `location`, `description`, `linkedin_link`, `website`, `founded_year`.

### Get Lead by LinkedIn URL
`POST /api/v1/leads/by_url/`

```json
{ "url": "https://www.linkedin.com/in/username/" }
```

Returns full enriched profile for a specific LinkedIn URL.

### Generate Email
`POST /api/v1/email_generator/`

AI-powered email discovery from name + domain.

```json
{
  "first_name": "John",
  "last_name": "Doe",
  "domain": "example.com"
}
```

Response: `{ "email": "...", "result": "valid|risky|invalid", "catch_all": bool }`

### Validate Email
`POST /api/v1/email_validator/`

```json
{ "email": "john@example.com" }
```

Response: `{ "result": "valid|invalid|risky", "catch_all": bool, "mx_domain": "...", "exist": "yes|no" }`

## Usage via curl

```bash
curl -X POST https://api.generect.com/api/v1/leads/by_icp/ \
  -H "Authorization: Token $GENERECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_title":["VP Sales"],"location":["United States"],"per_page":5}'
```

## MCP Server (Alternative)

Generect also provides an MCP server for AI tool integrations:
- Remote: `mcp-remote https://mcp.generect.com/mcp --header "Authorization: Bearer Token API_KEY"`
- Local: `npx -y generect-ultimate-mcp@latest` with env `GENERECT_API_KEY`

Tools: `search_leads`, `search_companies`, `generate_email`, `get_lead_by_url`, `health`

## Tips

- `amount: -1` in response means exact count unavailable; iterate pages until empty
- Leads endpoint is live — each request queries LinkedIn in real-time (may take 5-15s)
- Email generator uses AI permutations + validation; `valid` results are safe to send
- Combine lead search → email generation for full prospecting pipeline
- Rate limits apply per API key tier

---

## 中文说明

# Generect Live API

来自 LinkedIn、Crunchbase 的实时 B2B 数据，以及 AI 驱动的电子邮件发现。

**Base URL:** `https://api.generect.com`
**Auth:** `Authorization: Token <GENERECT_API_KEY>`

## 设置

需要 `GENERECT_API_KEY` 环境变量。在 https://beta.generect.com 获取密钥

## 端点

### 搜索潜在客户
`POST /api/v1/leads/by_icp/`

通过 ICP 筛选条件查找人员。返回包含工作经历、教育背景和技能的丰富 LinkedIn 资料。

```json
{
  "job_title": ["CEO", "CTO"],
  "location": ["United States"],
  "industry": ["Software Development"],
  "company_headcount_range": ["11-50", "51-200"],
  "page": 1,
  "per_page": 10
}
```

关键筛选条件：`job_title`、`location`、`industry`、`company_headcount_range`、`company_name`、`seniority_level`、`job_function`。均接受数组。

响应：`{ "amount": N, "leads": [...] }` — 每个潜在客户包含 `full_name`、`headline`、`job_title`、`company_name`、`company_website`、`linkedin_url`、`jobs[]`、`educations[]`、`skills[]`。

### 搜索公司
`POST /api/v1/companies/by_icp/`

通过 ICP 查找公司。返回包含员工人数、行业、地点和融资情况的公司资料。

```json
{
  "industry": ["Software Development"],
  "location": ["San Francisco"],
  "headcount_range": ["51-200"],
  "page": 1,
  "per_page": 10
}
```

关键筛选条件：`industry`、`location`、`headcount_range`、`company_type`、`founded_year_min`、`founded_year_max`、`keyword`。

响应：`{ "amount": N, "companies": [...] }` — 每个包含 `name`、`domain`、`industry`、`headcount_range`、`headcount_exact`、`location`、`description`、`linkedin_link`、`website`、`founded_year`。

### 通过 LinkedIn URL 获取潜在客户
`POST /api/v1/leads/by_url/`

```json
{ "url": "https://www.linkedin.com/in/username/" }
```

返回指定 LinkedIn URL 的完整丰富资料。

### 生成电子邮件
`POST /api/v1/email_generator/`

基于姓名 + 域的 AI 驱动电子邮件发现。

```json
{
  "first_name": "John",
  "last_name": "Doe",
  "domain": "example.com"
}
```

响应：`{ "email": "...", "result": "valid|risky|invalid", "catch_all": bool }`

### 验证电子邮件
`POST /api/v1/email_validator/`

```json
{ "email": "john@example.com" }
```

响应：`{ "result": "valid|invalid|risky", "catch_all": bool, "mx_domain": "...", "exist": "yes|no" }`

## 通过 curl 使用

```bash
curl -X POST https://api.generect.com/api/v1/leads/by_icp/ \
  -H "Authorization: Token $GENERECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_title":["VP Sales"],"location":["United States"],"per_page":5}'
```

## MCP 服务器（替代方案）

Generect 还提供用于 AI 工具集成的 MCP 服务器：
- 远程：`mcp-remote https://mcp.generect.com/mcp --header "Authorization: Bearer Token API_KEY"`
- 本地：`npx -y generect-ultimate-mcp@latest`，配合 env `GENERECT_API_KEY`

工具：`search_leads`、`search_companies`、`generate_email`、`get_lead_by_url`、`health`

## 提示

- 响应中的 `amount: -1` 表示无法获得精确计数；逐页迭代直至为空
- 潜在客户端点是实时的 — 每个请求都会实时查询 LinkedIn（可能需要 5-15 秒）
- 电子邮件生成器使用 AI 排列组合 + 验证；`valid` 结果可安全发送
- 将潜在客户搜索 → 电子邮件生成结合，构成完整的勘探流程
- 速率限制按 API 密钥层级适用