ScraperCity logo

Integration Guide

ScraperCity + n8n

Pull leads from the Lead Database API using the HTTP Request node. n8n handles pagination natively, so you can pull thousands of leads and route them anywhere in a single workflow.

Workflow Overview

Schedule TriggerHTTP RequestSplit Out ItemsGoogle Sheets / CRM / Email Tool

The HTTP Request node calls the Lead Database API with pagination. Split Out Items breaks the response array into individual lead records. Then you route each lead to your destination.

Setup

1

Create a credential for your API key

In n8n, go to Credentials and create a new one:

Credential Type:Header Auth
Name:Authorization
Value:Bearer YOUR_API_KEY

Using Header Auth instead of the predefined Bearer type ensures the authorization header is included on every paginated request.

2

Add an HTTP Request node

Method:GET
URL:https://app.scrapercity.com/api/v1/database/leads
Authentication:Generic Credential Type > Header Auth
3

Add query parameters

Under “Send Query Parameters,” add your search filters:

title = CTO
country = United States
hasEmail = true
limit = 100
page = 1

You can use any combination: title, seniority, department, industry, country, state, city, companyName, companyDomain, companySize, minEmployees, maxEmployees, hasEmail, hasPhone.

4

Enable pagination

Click “Add Option” and select “Pagination.” Configure it:

Pagination Mode:Update a Parameter in Each Request
Type:Query
Name:page
Value:{{ $pageCount + 1 }}

Set the stop condition:

Max Pages:{{ $response.body.pagination.totalPages }}

$pageCount starts at 0. Adding 1 means the first request sends page=1, the second sends page=2, and so on until totalPages.

5

Split the response array

After the HTTP Request node, add a “Split Out” node:

Field To Split Out:data

Each lead becomes a separate item. Downstream nodes receive fields like email, first_name, title, company_name, linkedin_url.

6

Route leads to your destination

Connect the Split Out node to wherever you want the leads: Google Sheets, HubSpot, Salesforce, Instantly, Smartlead, EmailBison, a Slack notification, or any other n8n node.

Available Fields per Lead

After the Split Out node, reference fields with expressions like {{ $json.email }}:

first_namelast_namefull_nameemailpersonal_emailmobile_numbertitleheadlinesenioritydepartmentcompany_namecompany_domaincompany_industrycompany_sizecompany_linkedinlinkedin_urlcitystatecountry

FAQ

Get API access to the Lead Database: