Apify Integration

Overview

Apify is a web scraping and automation platform where you can build, deploy, and run Actors (serverless cloud programs). Integrate BounceRaptor email verification into your Apify Actors to clean email lists as part of your scraping and automation pipelines.

Prerequisites

Step 1: Get Your API Key

Go to Settings → API Keys in your BounceRaptor dashboard and create a new API key labeled "Apify Integration". Save it — you'll need it as an environment variable in your Actor.

Step 2: Create an Apify Actor

Create a new Actor in the Apify Console. Here's a minimal Node.js Actor that verifies a list of emails:

import { Actor } from 'apify';

await Actor.init();

const input = await Actor.getInput();
const emails = input.emails || [];

const results = [];
for (const email of emails) {
  const resp = await fetch('https://bounceraptor.com/api/v1/verify-email/', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.BOUNCERAPTOR_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ email }),
  });
  const data = await resp.json();
  results.push(data);
}

await Actor.pushData(results);
await Actor.exit();

Step 3: Configure Environment Variables

In your Actor's Settings → Environment variables, add:

BOUNCERAPTOR_API_KEY=your_api_key_here

Step 4: Define Input Schema

Add an input schema to your Actor so users can pass email lists. Create .actor/input_schema.json:

{
  "title": "BounceRaptor Email Verifier",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "emails": {
      "title": "Email Addresses",
      "type": "array",
      "description": "List of email addresses to verify",
      "editor": "json",
      "items": { "type": "string" }
    }
  },
  "required": ["emails"]
}

Step 5: Deploy and Run

Deploy your Actor with apify push and run it from the Apify Console or via the API. Pass your email list as input:

{
  "emails": [
    "[email protected]",
    "[email protected]",
    "[email protected]"
  ]
}

Python Alternative

Prefer Python? Here's the same Actor using the Apify Python SDK:

from apify import Actor
import httpx
import os

async def main():
    async with Actor:
        actor_input = await Actor.get_input()
        emails = actor_input.get('emails', [])
        api_key = os.environ['BOUNCERAPTOR_API_KEY']

        results = []
        async with httpx.AsyncClient() as client:
            for email in emails:
                resp = await client.post(
                    'https://bounceraptor.com/api/v1/verify-email/',
                    headers={'Authorization': f'Bearer {api_key}'},
                    json={'email': email}
                )
                results.append(resp.json())

        await Actor.push_data(results)

Use Cases

• Lead generation pipelines: Verify scraped emails before adding them to your CRM
• Scheduled list cleaning: Run verification Actors on a schedule to keep email lists clean
• Data enrichment workflows: Combine email scraping with verification in a single Apify workflow