coldiq-search-enrich

ColdIQ 経由の Lima Data 検索とエンリッチメント

人物や企業を見つけ、メールアドレス／電話番号／企業属性でエンリッチメントし、大規模に見込み客を開拓できます。すべて ColdIQ マーケットプレイス API 経由で、1 つのキーと統一されたクレジットを使用します。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 Navigator 形式、1 ページあたり 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/entity	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クレジットの1ページ分を無駄にしないよう、フィルター値（役職、業種）を正確に解決します。 → POST /v1/limadata/references/autocomplete · 無料 · limadata.references.autocomplete
2. 企業、役職、所在地のフィルターを指定して、見込み客をリアルタイムで検索します（1ページあたり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

1社の従業員全員を探しますか？従業員検索を使用します。 → POST /v1/limadata/prospect/employees · 25クレジット · limadata.prospect.employees

見込み客の一括検索（大量リスト）

数百件を超えるリストの場合、一括検索はリアルタイム検索より25倍安価です（エンティティあたり1クレジット、1ページあたり25クレジット）。

1. 一括検索を送信します（エンティティ数は25の倍数にしてください）。 → POST /v1/limadata/batch/prospect-people · 1エンティティあたり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

情報を補完する

• 人物 — 次の入力から1つ選択します（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 スキル	Apollo の65種類以上のフィルター／インテントトピック
既知の連絡先の情報を補完してメールを取得	limadata.find.work_email*	氏名＋ドメインは1クレジット、LinkedIn は3クレジット
企業情報を1回の呼び出しで取得	limadata.enrich.company	資金調達、売上、技術スタックをまとめて取得
ウェブ／AI 調査	limadata.search.web、limadata.research.ai_search	0.1～0.3クレジット

ヒント

• 役職の書式：「VP SEO」のように記述します。「VP, SEO」のように役職の接頭辞と役割の間にカンマを入れないでください。
• **まずオートコンプリートでフィルター値を解決してください。**役職のスペルを間違えると、検索結果が0件でも見込み客検索1ページ分の料金が発生します。
• 情報を補完する前に重複を排除してください（list-dedup を参照）。同じ人物に二重で料金を支払わずに済みます。
• **キャッシュ：**人物データは30日間（転職の可能性があるため）、企業データは90日間（企業情報の変化は緩やかなため）。