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>
Docs: https://liveapi.generect.com
Setup
Requires GENERECT_API_KEY environment variable. Get a key at https://beta.generect.com
Endpoints
Search Leads by ICP
INLINECODE3
Find people by ICP filters. Returns enriched LinkedIn profiles with job history, education, skills.
CODEBLOCK0
Key filters: job_title, location, industry, company_headcount_range, seniority_level, job_function (arrays). company_name is a string (not array). At least one of company_name, company_link, or company_id is required.
Note: This endpoint queries LinkedIn in real-time and can take 15-60+ seconds to respond.
Response: { "amount": N, "leads": [...] } — each lead has full_name, headline, job_title, company_name, company_website, linkedin_url, jobs[], educations[], skills[].
Count Leads by ICP
INLINECODE24
Estimate the number of leads matching ICP filters (same body as search, no results returned).
Search Companies by ICP
INLINECODE25
Find companies by ICP. Returns company profiles with headcount, industry, location, funding.
CODEBLOCK1
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.
Count Companies by ICP
INLINECODE44
Estimate the number of companies matching ICP filters.
Get Lead by LinkedIn URL
INLINECODE45
CODEBLOCK2
Returns full enriched profile for a specific LinkedIn URL.
Get Company by LinkedIn URL
INLINECODE46
CODEBLOCK3
Returns full company profile for a specific LinkedIn company URL.
Email Finder (Generate Email)
INLINECODE47
AI-powered email discovery from name + domain. Generated emails are automatically validated.
CODEBLOCK4
Response: INLINECODE48
Email Validator
INLINECODE49
CODEBLOCK5
Response: INLINECODE50
Get User Info
INLINECODE51
Returns current user info and balance.
Get Transactions
INLINECODE52
Returns list of API usage transactions.
Usage via curl
CODEBLOCK6
MCP Server (Alternative)
Generect also provides an MCP server for AI tool integrations:
- - Remote: INLINECODE53
- Local:
npx -y generect-ultimate-mcp@latest with env INLINECODE55
Tools: search_leads, search_companies, generate_email, get_lead_by_url, INLINECODE60
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 finder 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驱动的邮箱发现。
基础URL： https://api.generect.com
认证： Authorization: Token APIKEY>
文档： https://liveapi.generect.com
设置
需要GENERECTAPIKEY环境变量。在 https://beta.generect.com 获取密钥。
接口
按ICP搜索线索
POST /api/linkedin/leads/by_icp/
通过ICP筛选条件查找人员。返回包含工作经历、教育背景、技能的丰富LinkedIn个人资料。
json
{
job_title: [CEO, CTO],
location: [United States],
industry: [Software Development],
companyheadcountrange: [11-50, 51-200],
page: 1,
per_page: 10
}
关键筛选条件：jobtitle、location、industry、companyheadcountrange、senioritylevel、jobfunction（数组）。companyname为字符串（非数组）。至少需要提供companyname、companylink或company_id中的一项。
注意： 此接口实时查询LinkedIn，响应时间可能需要15-60秒以上。
响应：{ amount: N, leads: [...] } — 每条线索包含fullname、headline、jobtitle、companyname、companywebsite、linkedin_url、jobs[]、educations[]、skills[]。
按ICP统计线索数量
POST /api/linkedin/leads/count/
估算符合ICP筛选条件的线索数量（请求体与搜索相同，不返回结果）。
按ICP搜索公司
POST /api/linkedin/companies/by_icp/
通过ICP筛选条件查找公司。返回包含员工规模、行业、地点、融资信息的公司资料。
json
{
industry: [Software Development],
location: [San Francisco],
headcount_range: [51-200],
page: 1,
per_page: 10
}
关键筛选条件：industry、location、headcountrange、companytype、foundedyearmin、foundedyearmax、keyword。
响应：{ amount: N, companies: [...] } — 每条包含name、domain、industry、headcountrange、headcountexact、location、description、linkedinlink、website、foundedyear。
按ICP统计公司数量
POST /api/linkedin/companies/count/
估算符合ICP筛选条件的公司数量。
通过LinkedIn URL获取线索
POST /api/linkedin/leads/by_link/
json
{ url: https://www.linkedin.com/in/username/ }
返回指定LinkedIn URL的完整丰富个人资料。
通过LinkedIn URL获取公司
POST /api/linkedin/companies/by_link/
json
{ url: https://www.linkedin.com/company/company-name/ }
返回指定LinkedIn公司URL的完整公司资料。
邮箱查找（生成邮箱）
POST /api/linkedin/email_finder/
AI驱动的邮箱发现，基于姓名+域名。生成的邮箱会自动验证。
json
[
{
first_name: John,
last_name: Doe,
domain: example.com
}
]
响应：{ email: ..., result: valid|risky|invalid, catchall: bool, validemail: ..., source: ..., mx_domain: ... }
邮箱验证器
POST /api/linkedin/email_validator/
json
[{ email: john@example.com }]
响应：{ result: valid|invalid|risky, catchall: bool, mxdomain: ..., exist: yes|no }
获取用户信息
GET /api/linkedin/user/me/
返回当前用户信息和余额。
获取交易记录
GET /api/linkedin/transactions/
返回API使用交易记录列表。
通过curl使用
bash
curl -X POST https://api.generect.com/api/linkedin/leads/by_icp/ \
-H Authorization: Token $GENERECTAPIKEY \
-H Content-Type: application/json \
-d {jobtitle:[VP Sales],location:[United States],perpage:5}
MCP服务器（替代方案）
Generect还提供用于AI工具集成的MCP服务器：
- - 远程：mcp-remote https://mcp.generect.com/mcp --header Authorization: Bearer Token APIKEY
- 本地：npx -y generect-ultimate-mcp@latest 并设置环境变量 GENERECTAPI_KEY
工具：searchleads、searchcompanies、generateemail、getleadbyurl、health
提示
- - 响应中的amount: -1表示无法获取精确数量；请迭代翻页直到返回空结果
- 线索接口为实时接口 — 每次请求实时查询LinkedIn（可能需要5-15秒）
- 邮箱查找器使用AI排列组合+验证；valid结果可安全发送
- 结合线索搜索→邮箱生成，构建完整的客户开发流程
- 根据API密钥层级存在速率限制
