Apollo.io Integration

Paste an Apollo URL — Superkabe replays the search via the official Apollo API and imports contacts as leads.

What this integration does

  • URL-paste import. Paste any app.apollo.io people-search, saved-search, or saved-list URL. Superkabe parses the filters, previews the result count, and pulls contacts via Apollo's official /v1/mixed_people/search endpoint.
  • Credit-aware. Personal-email reveal is opt-in. With reveal off, Superkabe pulls profile data only — credits flow only when reveal is on (~1 credit per contact via Apollo's /v1/people/bulk_match).
  • Capped + idempotent. Set a hard cap per import (default ceiling 50,000 — Apollo's own per-search max). Re-running the same URL upserts on email — you won't get duplicate leads.
  • Resumable. Imports paginate one page per tick. If the worker restarts mid-job, the cursor + page counter pick back up exactly where it left off.

Connect Apollo

  1. In Apollo, go to Settings → Integrations → API and create a new API key. Apollo requires a paid plan with API access (Professional or higher) for the search endpoints to return data — the free tier returns 403.
  2. Copy the key. In Superkabe: Dashboard → Integrations → Apollo.io → Connect Apollo. Paste the key and click Connect. Superkabe validates against /v1/auth/health and stores the key encrypted at rest (AES-256-GCM).
  3. Once connected, click Manage import on the connection card to open the import wizard.

Run an import

  1. In Apollo, build a search the way you normally would. Copy the URL straight from your browser's address bar.
  2. Paste it into the Superkabe import wizard and click Preview. Superkabe parses the filters, shows you a human-readable summary, and runs a 1-record search to estimate the total count (no credits consumed for the preview).
  3. Optionally pick a target campaign and tighten the cap. Decide whether to reveal personal emails (toggle off if you only need profile data).
  4. Click Start import. The job is queued and the worker pulls one page per tick (~100 contacts/tick). The recent-imports table updates live.

Supported Apollo URL shapes

  • https://app.apollo.io/#/people?personTitles[]=…&personLocations[]=… — live people-search filters
  • https://app.apollo.io/#/people?searchId=… — saved search by ID
  • https://app.apollo.io/#/people-search/lists/show/<listId> — saved contact list

Filters Superkabe recognizes today: titles, seniorities, person + organization locations, departments, industries, employee-count ranges, funding stages, technologies, keywords. Anything Superkabe can't map is logged and ignored — you'll see exactly which filters were applied in the preview.

Limits + safety

  • Per-search cap. Apollo's own ceiling is 50,000 records per search — Superkabe enforces this defensively. The wizard's cap field clamps to that.
  • Rate-limits. Apollo returns 429 with Retry-After when a per-minute / per-hour / per-day budget is exceeded. Superkabe honors the header once before failing the page.
  • Disconnect wipes the key. Clicking Disconnect on the connection card overwrites api_key_encrypted with an empty value and cancels any in-flight imports. Imported leads stay; only the connection is removed.

Privacy + compliance

When you import from Apollo, you're responsible for ensuring you have a lawful basis to email the contacts you're pulling — Superkabe is the processor, you're the controller. Imported leads enter the same lifecycle as Clay/CSV-ingested leads: validation, suppression checks, unsubscribe handling, and CAN-SPAM / CASL / GDPR enforcement at send-time.

Apollo's data terms also require that you stop emailing a contact if they unsubscribe. Superkabe's suppression list does this automatically — every unsubscribe / hard-bounce / spam-complaint flips the lead's unsubscribed_at globally for your workspace, across all campaigns.