ScraperCity + Instantly

curl -s "https://app.scrapercity.com/api/v1/database/leads?title=CTO&country=United%20States&hasEmail=true&limit=100" \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY"

Returns up to 100 leads with email, name, title, company, and LinkedIn. Paginate with &page=2, &page=3, etc. The Lead Database returns up to 100,000 leads per day.

You can filter by title, industry, country, state, city, companySize, and more to narrow your ICP before pulling. Only pull contacts you intend to contact - tight targeting improves reply rates and keeps your Instantly sender reputation healthy.

For each lead, POST to the Instantly V2 leads endpoint. You can send them one at a time or loop through your list:

curl -X POST "https://api.instantly.ai/api/v2/leads" \
  -H "Authorization: Bearer $INSTANTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign": "YOUR_CAMPAIGN_ID",
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Smith",
    "company_name": "TechCorp",
    "website": "techcorp.com",
    "custom_variables": {
      "title": "CTO",
      "linkedin": "https://linkedin.com/in/johnsmith"
    }
  }'

The endpoint returns the created lead object on success (HTTP 200). If the email already exists in the campaign, Instantly skips it silently - no error is thrown.

Map ScraperCity response fields to Instantly lead fields:

Any field you put in custom_variables is available as a merge tag in your Instantly sequences. Use {{title}}, {{industry}}, or {{location}} in your email copy to personalize at scale.

This script pulls one page of leads from ScraperCity and loads them all into an Instantly campaign. Extend with a loop over pages for larger batches.

import os
import requests
import time

SCRAPERCITY_KEY = os.environ["SCRAPERCITY_API_KEY"]
INSTANTLY_KEY   = os.environ["INSTANTLY_API_KEY"]
CAMPAIGN_ID     = os.environ["INSTANTLY_CAMPAIGN_ID"]

# 1. Pull leads from ScraperCity
sc_resp = requests.get(
    "https://app.scrapercity.com/api/v1/database/leads",
    headers={"Authorization": f"Bearer {SCRAPERCITY_KEY}"},
    params={"title": "VP of Sales", "country": "United States", "hasEmail": "true", "limit": 100}
)
sc_resp.raise_for_status()
leads = sc_resp.json().get("data", [])
print(f"Fetched {len(leads)} leads from ScraperCity")

# 2. Push each lead into Instantly
success, skipped, errors = 0, 0, 0
for lead in leads:
    payload = {
        "campaign": CAMPAIGN_ID,
        "email":        lead.get("email"),
        "first_name":   lead.get("first_name"),
        "last_name":    lead.get("last_name"),
        "company_name": lead.get("company_name"),
        "website":      lead.get("company_domain"),
        "custom_variables": {
            "title":    lead.get("title"),
            "linkedin": lead.get("linkedin_url"),
            "industry": lead.get("company_industry"),
        }
    }
    resp = requests.post(
        "https://api.instantly.ai/api/v2/leads",
        headers={
            "Authorization": f"Bearer {INSTANTLY_KEY}",
            "Content-Type": "application/json"
        },
        json=payload
    )
    if resp.status_code == 200:
        success += 1
    elif resp.status_code == 429:
        # Rate limit hit - back off and retry once
        time.sleep(2)
        retry = requests.post(
            "https://api.instantly.ai/api/v2/leads",
            headers={"Authorization": f"Bearer {INSTANTLY_KEY}", "Content-Type": "application/json"},
            json=payload
        )
        if retry.status_code == 200:
            success += 1
        else:
            errors += 1
    else:
        errors += 1

print(f"Done: {success} added, {errors} errors")

Store your keys in environment variables, not in the script itself. Never hardcode API credentials in source files.