LinkedIn Extraction
Operations for extracting profiles from LinkedIn
Extract a Sales Navigator search or list
Extract every lead or account behind a Sales Navigator search URL, saved search URL, or lead/account list URL.
The URL is checked against Sales Navigator while you wait, so an unusable search is rejected immediately rather than failing later. Everything after that runs in the background: the response returns an extraction_id straight away, and you either poll GET /v1/extractions/{extraction_id}/ until its status is EXECUTED or supply a webhook_url and be notified when the results are ready. Large searches take several minutes.
Cost: 1 credit per lead extracted, plus 1 credit per email found when enrich_email is set. A search's true size is unknown until it has been paged through, so the request only needs a positive balance to start; the credits are debited when the results are ready.
Extract a Sales Navigator search or list › Request Body
linkedin_urlThe Sales Navigator URL to extract. Accepts a people or company search URL, a saved search URL, or a lead or account list URL. Copy it straight from your browser's address bar; it must be a linkedin.com/sales/... URL.
search_nameYour own name for this extraction. Shown in the Evaboot dashboard and returned by the list and detail endpoints, so use something you will recognize later.
Optional HTTPS URL to notify once the extraction finishes. It receives a POST carrying the same results as GET /v1/extractions/{extraction_id}/, so you do not have to poll. Leave it out to poll instead.
enrich_emailWhether to also find and verify a professional email address for each extracted lead. none skips enrichment, matching enriches only the leads that match your search filters, all enriches every extracted lead. Enrichment costs 1 extra credit per email found.
Extract a Sales Navigator search or list › Responses
Accepted
extraction_idIdentifier of the new extraction. Poll GET /v1/extractions/{extraction_id}/ with it to follow progress and collect the results; it is the same value the list endpoint returns as search_id.
successAlways true when the extraction was accepted.
messageHuman-readable confirmation that the job was queued.
statusStage the job was in when it was accepted.
countNumber of leads or accounts submitted, when known upfront. It is 0 for a search or list URL, whose real size is only known once Sales Navigator has been paged through.
Extract a single Sales Navigator profile
Extract one Sales Navigator lead or account and get the full record back in the response.
This is the only extraction endpoint that is synchronous: there is nothing to poll and no webhook to wire up, so it suits enriching a single record inside a live workflow. Expect it to take a few seconds. Use POST /v1/extractions/profiles/ for more than one profile at a time.
The returned prospect object carries the identity, role, tenure and company fields Evaboot collects, plus the email address and its verification status when enrich_email is set.
Cost: 1 credit, plus 1 more if an email is found through enrichment.
Extract a single Sales Navigator profile › Request Body
profile_idThe lead or account to extract, as a Sales Navigator URL (linkedin.com/sales/lead/...) or as a bare Sales Navigator id. Public linkedin.com/in/... profile URLs are not accepted.
enrich_emailWhether to also find and verify a professional email address for the extracted lead. none skips enrichment, matching enriches only a lead that matches your search filters, all always enriches. Enrichment costs 1 extra credit when an email is found.
Extract a single Sales Navigator profile › Responses
OK
extraction_idIdentifier of the extraction that produced this record. Use it with GET /v1/extractions/{extraction_id}/ to fetch the same result again later.
successAlways true when the profile was extracted.
The extracted record, as human-readable column names mapped to values: identity, role and tenure, company details, and the email address plus its verification status when enrichment was requested. Which columns are present depends on whether a lead or an account was extracted. Empty if nothing could be extracted.
Extract a list of Sales Navigator profiles
Extract a specific set of Sales Navigator leads or accounts, given their URLs or ids, without going through a search.
Use it when you already know exactly who you want: up to 2500 entries per request, all leads or all accounts, never a mix. Public linkedin.com/in/... profile URLs are rejected.
The work runs in the background: the response returns an extraction_id straight away, and you either poll GET /v1/extractions/{extraction_id}/ until its status is EXECUTED or supply a webhook_url and be notified when the results are ready.
Cost: 1 credit per profile submitted, plus 1 credit per email found when enrich_email is set. The whole batch is refused if your balance does not cover it.
Extract a list of Sales Navigator profiles › Request Body
profile_idsThe Sales Navigator leads or accounts to extract, as full URLs or as bare Sales Navigator ids. One batch must be either all leads or all accounts, and public linkedin.com/in/... profile URLs are not accepted. Between 1 and 2500 entries.
search_nameYour own name for this extraction. Shown in the Evaboot dashboard and returned by the list and detail endpoints.
Optional HTTPS URL to notify once the extraction finishes. It receives a POST carrying the same results as GET /v1/extractions/{extraction_id}/, so you do not have to poll.
enrich_emailWhether to also find and verify a professional email address for each extracted lead. none skips enrichment, matching enriches only the leads that match your search filters, all enriches every extracted lead. Enrichment costs 1 extra credit per email found.
Extract a list of Sales Navigator profiles › Responses
Accepted
extraction_idIdentifier of the new extraction. Poll GET /v1/extractions/{extraction_id}/ with it to follow progress and collect the results; it is the same value the list endpoint returns as search_id.
successAlways true when the extraction was accepted.
messageHuman-readable confirmation that the job was queued.
statusStage the job was in when it was accepted.
countNumber of leads or accounts submitted, when known upfront. It is 0 for a search or list URL, whose real size is only known once Sales Navigator has been paged through.
Get LinkedIn extraction job results
Fetch an extraction's status and, once it has finished, its extracted records. This is the endpoint you poll after creating an extraction, and it returns the same data a webhook_url would have delivered.
The status code tells you which of two payloads you get:
- 202: still running. You get the status and a
progresspercentage, and should poll again shortly. - 200: finished. You get the full payload including
prospects.
Each record maps human-readable column names to values: identity, role and tenure, company details, and the email address plus its verification status when the extraction was created with enrich_email. Which columns appear depends on whether leads or accounts were extracted.
For large extractions, page the records with the optional start and limit query parameters; total_count and has_more then describe the whole result set. Omit limit and every record is returned in one response.
Synchronous and free: reading results costs no credits.
path Parameters
extraction_idquery Parameters
startlimitGet LinkedIn extraction job results › Responses
OK
search_idIdentifier of the extraction you requested.
search_nameThe name you gave the extraction when you created it.
statusWhere the extraction stands. On this response it is EXECUTED when the results are complete, or FAILED / PAUSED when they are not.
extraction_typeHow the extraction was created: SEARCH, LIST, UPLOAD or SINGLE.
total_prospectsNumber of leads or accounts Sales Navigator reported before scraping. An estimate; use total_count for the number of records actually extracted.
progressCompletion percentage, 0 to 100. 100 once the extraction has finished successfully.
When the extraction was created (UTC).
When the extraction finished (UTC). null if it never finished.
failure_reasonShort machine-readable reason the extraction did not complete, for example insufficient_credits, auth_error, quota_exceeded or invalid_urls. Empty string when the extraction succeeded.
The extracted records, each a mapping of human-readable column names to values: identity, role and tenure, company details, and the email address plus its verification status when enrichment was requested. Which columns are present depends on whether leads or accounts were extracted.
startZero-based index of the first record returned.
Page size that was applied, echoing the limit you sent. null when you did not page and every record was returned.
returned_countNumber of records in prospects on this response.
total_countNumber of records this extraction produced in total, across all pages.
has_moreWhether records remain after this page. Request the next page with start = start + returned_count.
List LinkedIn extraction jobs
List the extractions on your account, newest first.
Returns a summary of each one (name, status, type, estimated size, creation date) rather than the extracted records; fetch those from GET /v1/extractions/{extraction_id}/. Page with start and limit (25 per page by default).
status narrows the list. It takes the lowercase job states pending, scheduled, processing, completed, paused and failed. Note that these are not the uppercase values the responses report.
Synchronous and free: listing costs no credits.
query Parameters
startlimitstatusList LinkedIn extraction jobs › Responses
OK
search_idIdentifier of the extraction. Pass it to GET /v1/extractions/{extraction_id}/ to fetch the results.
search_nameThe name you gave the extraction when you created it.
statusWhere the extraction stands: ACCEPTED (queued), SCHEDULED (waiting for its start date), EXECUTING (running), EXECUTED (finished, results available), PAUSED (waiting for credits) or FAILED.
extraction_typeHow the extraction was created: SEARCH (a search URL), LIST (a lead or account list URL), UPLOAD (a list of profiles) or SINGLE (one profile).
total_prospectsNumber of leads or accounts Sales Navigator reported for this search before scraping. An estimate, so it can differ from the number of records finally returned.
When the extraction was created (UTC).