Apollo Person Phone & Email Enrichment

A professional Apify Actor that enriches person data by retrieving fresh contact phone numbers and emails directly from Apollo.io. This actor acts as a bridge between your workflow and Apollo's enrichment services, providing real-time phone and email data for person records.

Features

• ✅ Real-time Data: All information is retrieved fresh from Apollo
• ✅ Cost-Efficient: Only successful responses are counted and charged
• ✅ Error Handling: Failed requests are logged but not charged
• ✅ Rate Limiting: Built-in random delays (5-10 seconds) between requests to prevent API throttling
• ✅ Individual Results: Each successful enrichment is saved as a separate dataset item for accurate result counting
• ✅ Complete Contact Data: Retrieves both phone numbers and email addresses in a single API call

Input

The Actor accepts an array of Apollo person IDs through the input schema:

{
  "ids": [
    "610a3877f35a960001595fbc",
    "610a3877f35a960001595fbd",
    "610a3877f35a960001595fbe"
  ]
}

Input Schema

• ids (array, required): An array of Apollo person IDs to enrich
  • Each ID should be a valid Apollo person identifier
  • Empty or invalid IDs will be skipped

Output

The Actor outputs each successfully enriched person as a separate dataset item:

{
  "id": "610a3877f35a960001595fbc",
  "phone_numbers": [
    {
      "number": "+1234567890",
      "type": "mobile",
      "status": "verified"
    }
  ],
  "contact_emails": [
    {
      "email": "person@example.com",
      "type": "work",
      "status": "verified"
    }
  ]
}

Output Format

Each dataset item contains:

• id: The Apollo person ID
• phone_numbers: Array of contact phone number objects with phone numbers and metadata
• contact_emails: Array of contact email objects with email addresses and metadata

Note: Only successful API responses are saved to the dataset. Failed requests are logged but not included in the output, ensuring you're only charged for successful enrichments.

How It Works

1. Input Processing: The Actor receives an array of Apollo person IDs
2. API Enrichment: For each ID, the Actor calls the Apollo API to retrieve fresh phone and email data
3. Success Validation: Only responses with success: true are processed and saved
4. Rate Limiting: Random delays (5-10 seconds) are applied between requests to respect API rate limits
5. Data Storage: Each successful enrichment is saved as an individual dataset item

Pricing & Billing

• Charges: You are only charged for successful API responses
• Failed Requests: Failed or unsuccessful API calls are not charged
• Result Counting: Each successful enrichment counts as one result in Apify
• Transparent Billing: The Actor acts as a bridge - Apollo charges per successful result, and this cost is passed through transparently

Usage Example

Basic Usage

1. Prepare your input with Apollo person IDs:

   {
     "ids": ["person-id-1", "person-id-2", "person-id-3"]
   }
   

2. Run the Actor with your input

3. Access enriched data from the dataset:

   • Each successful enrichment appears as a separate dataset item
   • Failed requests are logged but not saved
   • Both phone numbers and emails are included in each result

Expected Processing Time

• Processing time depends on the number of IDs
• Each request includes a 5-10 second delay to respect rate limits
• For 100 IDs, expect approximately 8-17 minutes of processing time

Error Handling

The Actor handles errors gracefully:

• HTTP Errors: Network and HTTP errors are caught and logged
• API Failures: Unsuccessful API responses (success: false) are logged but not saved
• Invalid IDs: Empty or invalid IDs are skipped with a warning
• No Charges: Failed requests do not result in charges

Logs

The Actor provides detailed logging:

• ✅ Success indicators for successful enrichments
• ❌ Error indicators for failed requests
• ⏳ Delay notifications showing wait times between requests
• 📊 Summary of total successful enrichments

Technical Details

• Built with: Apify SDK v3
• Language: JavaScript (Node.js)
• API Endpoint: Apollo.io enrichment API (via bridge service)
• Rate Limiting: Random delays between 5-10 seconds
• Data Format: JSON

Resources

• Apify SDK Documentation
• Apify Platform Documentation
• Apify Actors Guide

Support

For issues, questions, or feature requests, please refer to the Actor's support channels or contact the maintainer.

---

Note: This Actor requires valid Apollo person IDs. Ensure you have the correct identifiers before running the enrichment process. This actor retrieves both phone numbers and email addresses, making it ideal for comprehensive contact data enrichment.