# Apollo.io B2B Leads Search & Contact Formatter (`litezero/apollo-leads-formatter`) Actor

Search and extract Apollo.io B2B leads, executive job titles, verified company domains, LinkedIn profiles, corporate email patterns, and employee size tiers.

- **URL**: https://apify.com/litezero/apollo-leads-formatter.md
- **Developed by:** [LiteZero](https://apify.com/litezero) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.45 / 1,000 item scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🚀 Apollo.io B2B Leads Search & Contact Formatter

> Production-grade, high-speed B2B executive lead extraction and enrichment tool. Extracts real executive profiles, corporate email patterns, verified domains, LinkedIn search URLs, and employee size tiers from **Apollo.io Official API** or **Zero-Key Public B2B Discovery Engine**.

***

### 🥊 Why This Actor Beats the Competition

| Feature | ⚡ This Actor (apollo-leads-formatter) | 🐌 Legacy Scrapers |
|---|:---:|:---:|
| **Dual Engine Mode** | **Direct Apollo.io API + Zero-Key Discovery Engine** | Broken HTML scrapers requiring session cookies |
| **Pricing Model** | **Pay-Per-Result ($3.50/1k)** | Heavy monthly rental ($50–$150/mo) |
| **Platform Compute** | **100% FREE (Bundled in PPR)** | Buyer pays extra compute hours & memory |
| **Speed** | **Sub-second direct HTTP (100+ items/sec)** | 5–15 seconds per page via slow browser automation |
| **Data Authenticity** | **Real verified B2B executives & domains** | Dummy placeholder / synthetic data |
| **Email Enrichment** | **Corporate pattern matrix & status validation** | Often missing or invalid syntax |

***

### 🛠️ How to Use

#### Method 1: Apify Web Console (No-Code GUI)

1. Navigate to the Actor page on the [Apify Console](https://console.apify.com/actors/cfJg8ryW3x2cGysuV).
2. Enter your target `Target Executive Job Title / Role` (e.g. `VP of Sales`, `Chief Revenue Officer`, `CTO`).
3. (Optional) Filter by `targetCompany`, `companyDomains`, or `industry`.
4. (Optional) Enter your official `apolloApiKey` for direct Apollo.io database unlock.
5. Click **Start** and download your dataset in JSON, CSV, or Excel format.

#### Method 2: Python SDK

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {
    "jobTitle": "VP of Sales",
    "targetCompany": "Stripe",
    "maxItems": 20
}

run = client.actor("litezero/apollo-leads-formatter").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

#### Method 3: Node.js SDK

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('litezero/apollo-leads-formatter').call({
    jobTitle: 'VP of Sales',
    targetCompany: 'HubSpot',
    maxItems: 20
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Method 4: REST API (cURL)

```bash
curl -X POST "https://api.apify.com/v2/acts/litezero~apollo-leads-formatter/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jobTitle": "Chief Technology Officer", "industry": "SaaS & CRM", "maxItems": 20}'
```

***

### 📥 Input Parameters

| Parameter | Type | Required | Default | Description |
|---|:---:|:---:|:---:|---|
| `jobTitle` | `String` | **Yes** | `"VP of Sales"` | Target executive job title or role (e.g. `VP of Sales`, `Chief Revenue Officer`, `CTO`, `Founder`). |
| `targetCompany` | `String` | No | `""` | Filter by specific company name (e.g. `Stripe`, `HubSpot`, `Snowflake`). |
| `companyDomains` | `Array[String]` | No | `[]` | Filter by corporate domains (e.g. `["stripe.com", "hubspot.com"]`). |
| `industry` | `String` | No | `"All"` | Filter by industry sector (e.g. `SaaS & CRM`, `Fintech & Payments`, `Artificial Intelligence`). |
| `location` | `String` | No | `"All"` | Filter by city, state, or country (e.g. `United States`, `San Francisco`). |
| `maxItems` | `Integer` | No | `20` | Maximum number of leads to extract (1 to 1000). |
| `apolloApiKey` | `String` (Secret) | No | `""` | Official Apollo.io API key for live Apollo database queries. |

***

### 📤 Output Data Dictionary & Sample JSON

Every extracted record conforms to standard B2B CRM and enrichment formats:

```json
{
  "fullName": "Eileen O'Mara",
  "firstName": "Eileen",
  "lastName": "O'Mara",
  "title": "Chief Revenue Officer",
  "headline": "Chief Revenue Officer at Stripe",
  "companyName": "Stripe",
  "companyDomain": "stripe.com",
  "companyWebsite": "https://stripe.com",
  "linkedinUrl": "https://www.linkedin.com/search/results/all/?keywords=Eileen%20O%27Mara%20Stripe",
  "corporateEmail": "eileen.omara@stripe.com",
  "emailPatterns": [
    "eileen.omara@stripe.com",
    "eileen@stripe.com",
    "eomara@stripe.com",
    "eileeno@stripe.com"
  ],
  "emailStatus": "corporate_pattern_verified",
  "seniorityLevel": "C-Level / Founder",
  "department": "Sales & Revenue",
  "city": "San Francisco",
  "state": "California",
  "country": "United States",
  "companySize": "7,000+ employees",
  "industry": "Fintech & Payments",
  "source": "apollo_leads_engine",
  "scrapedAt": "2026-10-07T16:00:00.000Z"
}
```

***

### 💡 Top Commercial Use Cases

1. **B2B Outbound Campaigns:** Instant email pattern discovery and LinkedIn prospecting lists for SDRs and sales teams.
2. **Account-Based Marketing (ABM):** Build complete decision-maker buying committees for target account lists.
3. **CRM Enrichment:** Automatically enrich missing domains, job titles, and emails for enterprise accounts.
4. **AI & RAG Pipeline Ingestion:** Fuel enterprise sales AI agents with fresh, structured executive data.

***

*Maintained under Apify Creator Account `litezero`. Built in full compliance with Apify Store quality guidelines.*

# Actor input Schema

## `jobTitle` (type: `string`):

Target job title or executive role (e.g. 'VP of Sales', 'Chief Revenue Officer', 'Chief Technology Officer', 'Head of Marketing', 'Founder').

## `targetCompany` (type: `string`):

Filter leads by a specific company name (e.g. 'Stripe', 'HubSpot', 'Snowflake', 'Datadog', 'Salesforce'). Leave empty for all companies.

## `companyDomains` (type: `array`):

Filter leads by specific corporate domains (e.g. \['stripe.com', 'hubspot.com']). Leave empty for all domains.

## `industry` (type: `string`):

Filter leads by industry sector.

## `location` (type: `string`):

Filter by city, state, or country (e.g. 'United States', 'San Francisco', 'New York', 'California').

## `maxItems` (type: `integer`):

Maximum number of leads to extract (1 to 1000).

## `apolloApiKey` (type: `string`):

Your official Apollo.io API key (from Apollo Settings > Integrations > API Keys). If provided, queries Apollo's live database directly with full contact unlock. If omitted, uses high-accuracy B2B public directory discovery and pattern verification.

## Actor input object example

```json
{
  "jobTitle": "VP of Sales",
  "targetCompany": "",
  "companyDomains": [],
  "industry": "All",
  "location": "All",
  "maxItems": 20
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "jobTitle": "VP of Sales",
    "targetCompany": "",
    "location": "All"
};

// Run the Actor and wait for it to finish
const run = await client.actor("litezero/apollo-leads-formatter").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "jobTitle": "VP of Sales",
    "targetCompany": "",
    "location": "All",
}

# Run the Actor and wait for it to finish
run = client.actor("litezero/apollo-leads-formatter").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "jobTitle": "VP of Sales",
  "targetCompany": "",
  "location": "All"
}' |
apify call litezero/apollo-leads-formatter --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,litezero/apollo-leads-formatter"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/cfJg8ryW3x2cGysuV/builds/w2g7oqZpxcFmLghJv/openapi.json