Which Instantly API version does this use?

The V2 API. Instantly deprecated V1 in 2025. V2 uses Bearer token authentication at api.instantly.ai.

Can I map ScraperCity fields to Instantly custom variables?

Yes. When you POST leads to Instantly, include a custom_variables object with any key-value pairs. Map ScraperCity fields like title, company_name, or industry to use them as merge tags in your sequences.

What happens if a lead already exists in Instantly?

Instantly deduplicates by email address within a campaign. If the email already exists, the lead will not be added again.

ScraperCity + Instantly - Load Leads Directly into Campaigns

The Pipeline

ScraperCity API

GET leads

Your Script

Transform fields

Instantly V2 API

POST leads to campaign

You query the ScraperCity Lead Database for contacts matching your ICP, then POST those contacts to an Instantly campaign. Instantly picks them up and starts sending your sequence. No CSV exports, no manual uploads.

What You Need

ScraperCity API Key

From app.scrapercity.com/dashboard/api-docs. Requires the $649/mo plan.

Instantly API Key (V2)

From your Instantly workspace: Settings > Integrations > API. Create a key with the leads:create scope.

Instantly Campaign ID

Open your campaign in Instantly, copy the ID from the URL or use the GET /api/v2/campaigns endpoint.

A script runner

curl, Python, Node.js, n8n, or any tool that can make HTTP requests.

Step by Step

Pull leads from ScraperCity

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.

Push leads into an Instantly campaign

For each lead, POST to the Instantly V2 leads endpoint. You can send them one at a time or in batches:

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"
    }
  }'

Field mapping reference

Map ScraperCity response fields to Instantly lead fields:

email→email

first_name→first_name

last_name→last_name

company_name→company_name

company_domain→website

mobile_number→phone

title→custom_variables.title

linkedin_url→custom_variables.linkedin

company_industry→custom_variables.industry

city + state→custom_variables.location

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

Ways to Automate This

Bash/Python script on a cron

Write a script that pulls from ScraperCity, transforms the data, and POSTs to Instantly. Run it daily or weekly. This is the simplest approach for recurring campaigns.

n8n workflow

Use the HTTP Request node to pull from ScraperCity (with pagination), then a second HTTP Request node to POST each lead to Instantly. Schedule the workflow to run on any interval.

Claude Code

Tell Claude Code: "Pull 500 CTOs from ScraperCity and load them into my Instantly campaign [ID]. Map title and company to custom variables." It will write and run the script for you.

ScraperCity + Instantly