Apollo Hello World

概要

Apollo.io のコア機能を実証する最小限の実行例 - 人物検索とコンタクトデータの充実化

前提条件

• apollo-install-auth セットアップを完了している
• 有効な API 認証情報が設定されている
• 開発環境が準備できている

手順

ステップ 1: エントリファイルを作成する

hello world の例用に新しいファイルを作成します。

ステップ 2: クライアントをインポートして初期化する

import axios from 'axios';

const apolloClient = axios.create({
  baseURL: 'https://api.apollo.io/v1',
  headers: { 'Content-Type': 'application/json' },
  params: { api_key: process.env.APOLLO_API_KEY },
});

ステップ 3: 人物を検索する

async function searchPeople() {
  const response = await apolloClient.post('/people/search', {
    q_organization_domains: ['apollo.io'],
    page: 1,
    per_page: 10,
  });

  console.log('Found contacts:', response.data.people.length);
  response.data.people.forEach((person: any) => {
    console.log(`- ${person.name} (${person.title})`);
  });
}

searchPeople().catch(console.error);

出力

• Apollo クライアント初期化を含む動作するコードファイル
• コンタクトデータを含む成功した API レスポンス
• コンソール出力:

Found contacts: 10
- John Smith (VP of Sales)
- Jane Doe (Account Executive)
...

エラーハンドリング

エラー	原因	解決方法
401 Unauthorized	無効な API キー	APOLLO_API_KEY 環境変数を確認してください
422 Unprocessable	無効なリクエスト本体	リクエストペイロードの形式を確認してください
429 Rate Limited	リクエストが多すぎる	待機してエクスポーネンシャルバックオフで再試行してください
Empty Results	マッチするコンタクトなし	検索条件を広げてください

例

TypeScript 例 - 人物検索

import axios from 'axios';

const client = axios.create({
  baseURL: 'https://api.apollo.io/v1',
  params: { api_key: process.env.APOLLO_API_KEY },
});

interface Person {
  id: string;
  name: string;
  title: string;
  email: string;
  organization: { name: string };
}

async function main() {
  // Search for people at a company
  const { data } = await client.post('/people/search', {
    q_organization_domains: ['stripe.com'],
    person_titles: ['engineer', 'developer'],
    page: 1,
    per_page: 5,
  });

  console.log('People Search Results:');
  data.people.forEach((person: Person) => {
    console.log(`  ${person.name} - ${person.title} at ${person.organization?.name}`);
  });
}

main().catch(console.error);

Python 例 - 企業の充実化

import os
import requests

APOLLO_API_KEY = os.environ.get('APOLLO_API_KEY')
BASE_URL = 'https://api.apollo.io/v1'

def enrich_company(domain: str):
    response = requests.get(
        f'{BASE_URL}/organizations/enrich',
        params={
            'api_key': APOLLO_API_KEY,
            'domain': domain,
        }
    )
    return response.json()

if __name__ == '__main__':
    company = enrich_company('apollo.io')
    org = company.get('organization', {})
    print(f"Company: {org.get('name')}")
    print(f"Industry: {org.get('industry')}")
    print(f"Employees: {org.get('estimated_num_employees')}")

リソース

• Apollo People Search API
• Apollo Organization API
• Apollo API Examples

次のステップ

開発ワークフローセットアップのために apollo-local-dev-loop に進んでください。