Lead Generation

LinkedIn Profiles

LinkedIn profiles as structured people — headline, location, current role, work history, education and skills.

linkedin-profileslinkedinlead-generationenrichmentpeople

89 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/linkedin-profiles/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 89 rows, this download costs 1 credit when the data is fresh enough, or 2 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/linkedin-profiles/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "linkedinUrls": [        "https://www.linkedin.com/in/janedoe"      ],      "mode": "cached",      "skipExisting": true,      "refreshOlderThanDays": 0    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

linkedinUrls
string[]
LinkedIn profile URLs
Paste a list — one URL per line, or comma separated. Each profile is one request and one credit, so the run costs as many credits as there are new URLs.
Default
none
Example
https://www.linkedin.com/in/janedoe
mode
enum
Data freshness
Cached answers from the provider index. Live re-scrapes the profile and is asynchronous: the run submits a job and polls until it resolves. Live needs a paid plan — on a free trial key it answers 403 and the run stops.
Default
cached
Allowed values
cached
live
skipExisting
boolean
Skip URLs already stored
Every fetch costs a credit whether or not the row is new, so a re-run of the same list is free only with this on.
Default
true
refreshOlderThanDays
number
Re-fetch rows older than (days)
Only applies when skipping stored URLs. Zero never re-fetches; 30 re-fetches a stored profile once it is a month old.
Default
0
Range
0 to 3650
maxProfiles
number
Max profiles per run
A ceiling on credits spent. URLs beyond it are left untouched and reported as remaining.
Default
100
Range
1 to 10000

Advanced

concurrency
number
Parallel requests
The API takes one URL per request. Keep this at or below your per-minute rate limit divided by the delay below.
Default
1
Range
1 to 10
requestDelayMs
number
Delay between requests (ms)
Paces each worker. 6500ms with one worker stays under a 10 requests/minute key. A 429 is retried at the reset time the API reports, so this is a courtesy pace, not the only guard.
Default
6500
Range
0 to 120000
maxRetries
number
Retries per URL
Applies to rate limits and 5xx. A 404, a GDPR block and an invalid URL are recorded and never retried.
Default
3
Range
0 to 10
maxDurationSeconds
number
Max run duration (seconds)
Rate limits make a long list slow: 100 profiles at 10 per minute is ten minutes. Whatever is unfinished is reported and can be re-run.
Default
900
Range
10 to 21600
livePollIntervalMs
number
Live poll interval (ms)
Live mode only. Polling the job is free and does not count against the rate limit.
Default
2000
Range
500 to 30000
livePollTimeoutSeconds
number
Live poll timeout (seconds)
Live mode only. Most jobs resolve in seconds, but a busy target can take minutes.
Default
120
Range
5 to 1800
apiKey
string
API key override
Defaults to REVERSE_CONTACT_API_KEY.
Default
none

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "linkedinUrls": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "LinkedIn profile URLs",      "description": "Paste a list — one URL per line, or comma separated. Each profile is one request and one credit, so the run costs as many credits as there are new URLs.",      "default": [],      "examples": [        "https://www.linkedin.com/in/janedoe"      ]    },    "mode": {      "type": "string",      "enum": [        "cached",        "live"      ],      "title": "Data freshness",      "description": "Cached answers from the provider index. Live re-scrapes the profile and is asynchronous: the run submits a job and polls until it resolves. Live needs a paid plan — on a free trial key it answers 403 and the run stops.",      "default": "cached"    },    "skipExisting": {      "type": "boolean",      "title": "Skip URLs already stored",      "description": "Every fetch costs a credit whether or not the row is new, so a re-run of the same list is free only with this on.",      "default": true    },    "refreshOlderThanDays": {      "type": "number",      "minimum": 0,      "maximum": 3650,      "title": "Re-fetch rows older than (days)",      "description": "Only applies when skipping stored URLs. Zero never re-fetches; 30 re-fetches a stored profile once it is a month old.",      "default": 0    },    "maxProfiles": {      "type": "number",      "minimum": 1,      "maximum": 10000,      "title": "Max profiles per run",      "description": "A ceiling on credits spent. URLs beyond it are left untouched and reported as remaining.",      "default": 100    },    "concurrency": {      "type": "number",      "minimum": 1,      "maximum": 10,      "title": "Parallel requests",      "description": "The API takes one URL per request. Keep this at or below your per-minute rate limit divided by the delay below.",      "default": 1    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 120000,      "title": "Delay between requests (ms)",      "description": "Paces each worker. 6500ms with one worker stays under a 10 requests/minute key. A 429 is retried at the reset time the API reports, so this is a courtesy pace, not the only guard.",      "default": 6500    },    "maxRetries": {      "type": "number",      "minimum": 0,      "maximum": 10,      "title": "Retries per URL",      "description": "Applies to rate limits and 5xx. A 404, a GDPR block and an invalid URL are recorded and never retried.",      "default": 3    },    "maxDurationSeconds": {      "type": "number",      "minimum": 10,      "maximum": 21600,      "title": "Max run duration (seconds)",      "description": "Rate limits make a long list slow: 100 profiles at 10 per minute is ten minutes. Whatever is unfinished is reported and can be re-run.",      "default": 900    },    "livePollIntervalMs": {      "type": "number",      "minimum": 500,      "maximum": 30000,      "title": "Live poll interval (ms)",      "description": "Live mode only. Polling the job is free and does not count against the rate limit.",      "default": 2000    },    "livePollTimeoutSeconds": {      "type": "number",      "minimum": 5,      "maximum": 1800,      "title": "Live poll timeout (seconds)",      "description": "Live mode only. Most jobs resolve in seconds, but a busy target can take minutes.",      "default": 120    },    "apiKey": {      "type": "string",      "maxLength": 2000,      "title": "API key override",      "description": "Defaults to REVERSE_CONTACT_API_KEY."    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/linkedin-profiles/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "linkedinUrls": [        "https://www.linkedin.com/in/janedoe"      ],      "mode": "cached",      "skipExisting": true,      "refreshOlderThanDays": 0    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
background_url	string	96%
certifications	array	56%
city	string	94%
connections_count	number	92%
country	string	96%
country_code	string	96%
current_company_linkedin_id	string	96%
current_company_location	string	62%
current_company_name	string	100%
current_title	string	100%
education	array	99%
experience	array	100%
fetch_mode	string	100%
first_name	string	100%
followers_count	number	96%
full_name	string	100%
has_premium	boolean	96%
has_verification_badge	boolean	96%
headline	string	100%
is_in_remembrance	boolean	96%
is_open_to_work	boolean	96%
languages	array	37%
last_name	string	100%
member_id	string	96%
photo_url	string	96%
provider_person_id	string	96%
public_id	string	100%
raw_location	string	79%
recommendations_count	number	25%
skills	array	91%
state	string	70%
summary	string	74%
account_created_at	date	90%
created_at	date	100%
current_position_started_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
source_updated_at	date	100%
updated_at	date	100%
_id	string	100%