coldiq-search-enrich

通过 ColdIQ 查找和丰富 Lima Data 数据

查找人员和公司，补充其电子邮件、电话和公司概况信息，并大规模开发潜在客户——所有操作均通过 ColdIQ 市场 API 完成，只需一个密钥并使用统一额度。Lima Data 的 /v1/limadata/* 端点涵盖查找、丰富、潜在客户开发和搜索；/v1/ai-ark/* 则用于搜索大型数据库。

ColdIQ 市场端点

任务	方法	路径	额度	端点 ID	备注
查找工作电子邮件（姓名 + 域名）	POST	/v1/limadata/find/work-email	1	limadata.find.work_email	未找到则免费
查找工作电子邮件（LinkedIn URL）	POST	/v1/limadata/find/work-email-linkedin	3	limadata.find.work_email_linkedin	缺少域名时的备用方案
查找个人电子邮件	POST	/v1/limadata/find/personal-email	5	limadata.find.personal_email	未找到则免费
查找电话	POST	/v1/limadata/find/phone	10	limadata.find.phone	未找到则免费
丰富人员信息	POST	/v1/limadata/enrich/person	1–5	limadata.enrich.person	LinkedIn=1，姓名+公司=2，个人电子邮件=5
丰富公司信息	POST	/v1/limadata/enrich/company	1	limadata.enrich.company	公司概况、融资、技术、流量
按筛选条件开发人员潜在客户	POST	/v1/limadata/prospect/people/filter	25	limadata.prospect.people.filter	类似 Sales Nav，每页 25 条
通过 SN URL 开发人员潜在客户	POST	/v1/limadata/prospect/people/search-url	25	limadata.prospect.people.search_url	粘贴 Sales Navigator URL
开发公司员工潜在客户	POST	/v1/limadata/prospect/employees	25	limadata.prospect.employees	可按职位、地点和资历筛选
按筛选条件开发公司潜在客户	POST	/v1/limadata/prospect/companies/filter	25	limadata.prospect.companies.filter	公司概况筛选条件
批量开发人员潜在客户（异步）	POST	/v1/limadata/batch/prospect-people	1/实体	limadata.batch.prospect_people	大规模操作成本更低；轮询获取结果
批量获取人员资料（异步）	POST	/v1/limadata/batch/people	1/URL	limadata.batch.people	LinkedIn URL → 个人资料
获取批量结果	POST	/v1/limadata/batch/results	免费	limadata.batch.results	每隔约 60 秒轮询一次
自动补全筛选值	POST	/v1/limadata/references/autocomplete	免费	limadata.references.autocomplete	解析职位、行业等
网络搜索	POST	/v1/limadata/search/web	0.1	limadata.search.web	Google 网络搜索
大规模人员搜索	POST	/v1/ai-ark/people	按结果计费	ai_ark.people.search	5 亿份个人资料；适用于大型名单
大规模公司搜索	POST	/v1/ai-ark/companies	按结果计费	ai_ark.companies.search	7,000 万家公司

快速参考

• 基础 URL： https://api.coldiq.com
• 身份验证： API 密钥请求头（参见 resources/auth.md — 请求头尚未验证）
• 额度： 每次调用都会从你的 ColdIQ 余额中扣除；通过 /dashboard/credits 查看
• 不收费： 查找端点未返回结果时（free_if_not_found）

查找电子邮件（瀑布式）

从最便宜的方式开始。找到结果后即停止。

1. 尝试使用姓名 + 公司域名。 → POST /v1/limadata/find/work-email · 1 个额度 · limadata.find.work_email

   { "full_name": "William Gates", "company_domain": "microsoft.com" }
   

2. 如果缺少域名或第 1 步没有结果，则改用 LinkedIn URL。 → POST /v1/limadata/find/work-email-linkedin · 3 个额度 · limadata.find.work_email_linkedin

   { "linkedin_url": "https://linkedin.com/in/williamgates" }
   

3. 最后再尝试个人电子邮件。 → POST /v1/limadata/find/personal-email · 5 个额度 · limadata.find.personal_email

工作电子邮件的查找成功率通常为 60–70%。发送前务必验证（参见 contact-enrichment）。

发掘目标公司的潜在人选

1. 解析精确的筛选值（职位、行业），避免浪费一页（25 个点数）。 → POST /v1/limadata/references/autocomplete · 免费 · limadata.references.autocomplete
2. 使用公司、职位和地点筛选条件，实时发掘潜在人选（每页 25 条结果）。 → POST /v1/limadata/prospect/people/filter · 25 点数 · limadata.prospect.people.filter

   {
     "filters": [
       {"filter_type": "company", "operator": "in", "values": ["https://linkedin.com/company/microsoft"]},
       {"filter_type": "current_title", "operator": "in", "values": ["Chief Marketing Officer"]},
       {"filter_type": "location", "operator": "in", "values": ["San Francisco Bay Area"]}
     ],
     "page": 1
   }
   

常见筛选类型： company、current_title、seniority（Owner / Partner、 CXO、Vice President、Director、Senior）、location、industry、company_headcount （1-10 … 10,001+）、function、recently_changed_jobs。

已经有 Sales Navigator 搜索 URL？跳过筛选条件构建： → POST /v1/limadata/prospect/people/search-url · 25 点数 · limadata.prospect.people.search_url

想查找某家公司的所有员工？使用员工查找工具： → POST /v1/limadata/prospect/employees · 25 点数 · limadata.prospect.employees

批量发掘潜在人选（大型列表）

对于数百条以上的列表，批量处理比实时发掘便宜 25 倍（每个实体 1 点数，而非每页 25 点数）。

1. 提交批量任务（实体数量必须是 25 的倍数）。 → POST /v1/limadata/batch/prospect-people · 每个实体 1 点数 · limadata.batch.prospect_people

   { "name": "CMOs at target companies", "filters": [ ... ], "entity_count": 2500,
     "notification_url": "https://your-webhook.com/batch-complete" }
   

2. 轮询直至状态为 completed（页面完成后立即获取，无需等待整个任务结束）。 → POST /v1/limadata/batch/results · 免费 · limadata.batch.results

状态流转：pending → processing → completed | failed。通用轮询循环请参阅 resources/async-job-pattern.md。

要将 LinkedIn 个人资料 URL 列表转换为完整个人资料，请使用 → POST /v1/limadata/batch/people · 每个 URL 1 点数 · limadata.batch.people

丰富数据

• 人员 — 选择一种输入（LinkedIn = 1 点数、工作邮箱 = 1 点数、姓名 + 公司 = 2 点数、个人邮箱 = 5 点数）： → POST /v1/limadata/enrich/person · 1–5 点数 · limadata.enrich.person
• 公司 — 根据域名或 LinkedIn URL 查询；返回公司基本信息、融资、技术栈和流量： → POST /v1/limadata/enrich/company · 1 点数 · limadata.enrich.company

何时使用 Lima Data、ai-ark 或 Apollo

需求	最佳选择	原因
特定公司的人员	limadata.prospect.people.filter	类似 Sales Navigator 的筛选条件，支持批量处理
超大型人员列表	ai_ark.people.search	5 亿份个人资料，按结果计费
Apollo 特有的筛选语义	apollo-search skill	Apollo 的 65+ 项筛选条件 / 意向主题
丰富已知联系人 → 邮箱	limadata.find.work_email*	姓名 + 域名 1 点数，LinkedIn 3 点数
一次调用获取公司基本信息	limadata.enrich.company	同时提供融资、收入和技术栈信息
网络 / AI 研究	limadata.search.web、limadata.research.ai_search	0.1–0.3 点数

提示

• 职位格式： 使用 “VP SEO”，而非 “VP, SEO”（前缀和职位之间不加逗号）。
• 先解析筛选值，使用自动补全功能——拼错职位会直接返回 0 条结果， 但仍会消耗一页潜在人选查询额度。
• 丰富数据前先去重（参见 list-dedup），避免为同一个人重复付费。
• 缓存： 人员数据缓存 30 天（职位会变动），公司数据缓存 90 天（公司基本信息变化较慢）。