Apollo Install & Auth
Overview
Set up Apollo.io API client and configure authentication credentials for B2B sales intelligence access.
Prerequisites
-
Node.js 18+ or Python 3.10+
-
Package manager (npm, pnpm, or pip)
-
Apollo.io account with API access
-
API key from Apollo dashboard (Settings > Integrations > API)
Instructions
Step 1: Install SDK/HTTP Client
set -euo pipefail
Node.js (using axios for REST API)
npm install axios dotenv
Python
pip install requests python-dotenv
Step 2: Configure Authentication
Set environment variable
export APOLLO_API_KEY="your-api-key"
Or create .env file
echo 'APOLLO_API_KEY=your-api-key' >> .env
Step 3: Create Apollo Client
// apollo-client.ts import axios from 'axios'; import dotenv from 'dotenv';
dotenv.config();
export const apolloClient = axios.create({ baseURL: 'https://api.apollo.io/v1', headers: { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache', }, params: { api_key: process.env.APOLLO_API_KEY, }, });
Step 4: Verify Connection
async function verifyConnection() { try { const response = await apolloClient.get('/auth/health'); console.log('Apollo connection:', response.status === 200 ? 'OK' : 'Failed'); # HTTP 200 OK } catch (error) { console.error('Connection failed:', error.message); } }
Output
-
HTTP client configured with Apollo base URL
-
Environment variable or .env file with API key
-
Successful connection verification output
Error Handling
Error Cause Solution
401 Unauthorized Invalid API key Verify key in Apollo dashboard
403 Forbidden Insufficient permissions Check API plan and permissions
429 Rate Limited Exceeded quota Implement backoff, check usage
Network Error Firewall blocking Ensure outbound HTTPS to api.apollo.io
Examples
TypeScript Setup
import axios, { AxiosInstance } from 'axios';
interface ApolloClientConfig { apiKey: string; baseURL?: string; }
export function createApolloClient(config: ApolloClientConfig): AxiosInstance { return axios.create({ baseURL: config.baseURL || 'https://api.apollo.io/v1', headers: { 'Content-Type': 'application/json', }, params: { api_key: config.apiKey, }, }); }
const client = createApolloClient({ apiKey: process.env.APOLLO_API_KEY!, });
Python Setup
import os import requests from dotenv import load_dotenv
load_dotenv()
class ApolloClient: def init(self, api_key: str = None): self.api_key = api_key or os.environ.get('APOLLO_API_KEY') self.base_url = 'https://api.apollo.io/v1'
def _request(self, method: str, endpoint: str, **kwargs):
url = f"{self.base_url}/{endpoint}"
params = kwargs.pop('params', {})
params['api_key'] = self.api_key
return requests.request(method, url, params=params, **kwargs)
client = ApolloClient()
Resources
-
Apollo API Documentation
-
Apollo Dashboard
-
Apollo API Rate Limits
Next Steps
After successful auth, proceed to apollo-hello-world for your first API call.