SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场coldiq-search-enrich

coldiq-search-enrich

营销与增长

查看项目

更新于 10-16 02:06

技能介绍

用途

ColdIQ Search & Enrich 通过 ColdIQ 市场 API 调用 Lima Data，用于查找和丰富人物与公司信息，并支持规模化潜在客户挖掘。所有请求使用同一个 API 密钥和统一积分。Lima Data 的 /v1/limadata/* 端点覆盖查找、丰富、潜在客户和搜索；/v1/ai-ark/* 端点覆盖大型数据库搜索。

主要能力

查找邮箱与电话

  • 查找工作邮箱（姓名 + 域名）：POST /v1/limadata/find/work-email，1 积分，端点 ID limadata.find.work_email，未找到不收费。
  • 查找工作邮箱（LinkedIn URL）：POST /v1/limadata/find/work-email-linkedin，3 积分，端点 ID limadata.find.work_email_linkedin，适用于缺少域名时的回退。
  • 查找个人邮箱：POST /v1/limadata/find/personal-email，5 积分，端点 ID limadata.find.personal_email，未找到不收费。
  • 查找电话：POST /v1/limadata/find/phone，10 积分，端点 ID limadata.find.phone，未找到不收费。

丰富人物与公司

  • 丰富人物：POST /v1/limadata/enrich/person，1–5 积分，端点 ID limadata.enrich.person。LinkedIn 输入为 1 积分，姓名 + 公司为 2 积分，个人邮箱为 5 积分。
  • 丰富公司：POST /v1/limadata/enrich/company，1 积分，端点 ID limadata.enrich.company，返回公司画像、融资、技术栈和流量。

潜在客户搜索

  • 按筛选条件搜索人物：POST /v1/limadata/prospect/people/filter，25 积分，端点 ID limadata.prospect.people.filter，类似 Sales Navigator 风格，每页 25 条。
  • 按 Sales Navigator URL 搜索人物：POST /v1/limadata/prospect/people/search-url，25 积分，端点 ID limadata.prospect.people.search_url，可直接粘贴 Sales Navigator URL。
  • 搜索某公司的员工：POST /v1/limadata/prospect/employees，25 积分，端点 ID limadata.prospect.employees，支持职位、地点、资历筛选。
  • 按筛选条件搜索公司：POST /v1/limadata/prospect/companies/filter，25 积分，端点 ID limadata.prospect.companies.filter，支持公司画像筛选。

批量任务（异步）

  • 批量搜索人物：POST /v1/limadata/batch/prospect-people，1 积分/实体，端点 ID limadata.batch.prospect_people，规模化时更便宜，需轮询结果。
  • 批量获取人物资料：POST /v1/limadata/batch/people，1 积分/URL，端点 ID limadata.batch.people，将 LinkedIn URL 转为完整资料。
  • 获取批量结果：POST /v1/limadata/batch/results，免费，端点 ID limadata.batch.results，约每 60 秒轮询一次。

辅助与大规模搜索

  • 自动补全筛选值：POST /v1/limadata/references/autocomplete，免费，端点 ID limadata.references.autocomplete，用于解析职位、行业等筛选值。
  • 网页搜索：POST /v1/limadata/search/web，0.1 积分，端点 ID limadata.search.web，Google 网页搜索。
  • 大规模人物搜索：POST /v1/ai-ark/people，按结果计费，端点 ID ai_ark.people.search，覆盖 5 亿份资料，适合生成大型列表。
  • 大规模公司搜索：POST /v1/ai-ark/companies，按结果计费，端点 ID ai_ark.companies.search，覆盖 7000 万家公司。

使用方式

基础 URL：https://api.coldiq.com

认证：API 密钥请求头（具体请求头未经验证）。

积分：每次调用都会从 ColdIQ 余额中结算，可通过 /dashboard/credits 查看。查找类端点在未返回结果时不收费（free_if_not_found）。

查找邮箱（瀑布式）

按成本从低到高尝试，命中即停止。

  1. 尝试姓名 + 公司域名：POST /v1/limadata/find/work-email，1 积分。请求体示例：{ "full_name": "William Gates", "company_domain": "microsoft.com" }
  2. 如果缺少域名或第一步为空，回退到 LinkedIn URL：POST /v1/limadata/find/work-email-linkedin，3 积分。请求体示例：{ "linkedin_url": "https://linkedin.com/in/williamgates" }
  3. 最后尝试个人邮箱：POST /v1/limadata/find/personal-email，5 积分。

工作邮箱的查找率通常为 60–70%。发送前务必验证。

在目标公司搜索人物

  1. 先用自动补全解析精确筛选值（职位、行业），避免浪费 25 积分的一页：POST /v1/limadata/references/autocomplete，免费。
  2. 使用公司 + 职位 + 地点筛选运行实时搜索（每页 25 条结果）：POST /v1/limadata/prospect/people/filter，25 积分。请求体示例：

{ "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 积分。

如果想获取某公司的所有员工，使用员工查找：POST /v1/limadata/prospect/employees，25 积分。

批量搜索（大型列表）

对于超过几百条的列表，批量比实时搜索便宜 25 倍（1 积分/实体 vs 25 积分/页）。

提交批量任务（实体数量为 25 的倍数）：POST /v1/limadata/batch/prospect-people，1 积分/实体。请求体示例：

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

轮询直到完成（页面完成即可拉取，不必等待整个任务）：POST /v1/limadata/batch/results，免费。

状态流转：pending → processing → completed | failed。

若要将一批 LinkedIn 个人资料 URL 转为完整资料，使用：POST /v1/limadata/batch/people，1 积分/URL。

丰富

人物：选择一种输入（LinkedIn=1 积分，工作邮箱=1 积分，姓名+公司=2 积分，个人邮箱=5 积分）：POST /v1/limadata/enrich/person，1–5 积分。

公司：通过域名或 LinkedIn URL，返回公司画像、融资、技术栈、流量：POST /v1/limadata/enrich/company，1 积分。

适用场景

  • 需要特定公司的人员：limadata.prospect.people.filter，支持 Sales-Nav 风格筛选和批量。
  • 非常大的联系人列表：ai_ark.people.search，覆盖 5 亿份资料，按结果计费。
  • Apollo 特定筛选语义：apollo-search 技能，支持 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 条，但仍会消耗一页搜索积分。
  • 丰富前先去重，避免为同一人重复付费。
  • 缓存：人物数据 30 天（职位变动），公司数据 90 天（公司画像变化较慢）。
  • 认证请求头未经验证。
  • 部分端点（如 ai-ark 搜索）按结果计费，具体价格暂未提供。