LinkedIn Extraction

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 progress percentage, 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. limit=0 returns the status, progress and counts with an empty prospects list.

Synchronous and free: reading results costs no credits.

get/v1/extractions/{extraction_id}/

Request

  • Base URL: https://api.evaboot.com
  • URL: https://api.evaboot.com/v1/extractions/{extraction_id}/
  • Auth: HTTP bearer

Path parameters

extraction_idstring required

Query parameters

startinteger
limitinteger nullable

Response

OK

search_idstring required

Identifier of the extraction you requested.

search_namestring

The name you gave the extraction when you created it.

statusstring

Where the extraction stands. On this response it is EXECUTED when the results are complete, or FAILED / PAUSED when they are not.

extraction_typestring

How the extraction was created: SEARCH, LIST, UPLOAD or SINGLE.

total_prospectsinteger

Number of leads or accounts Sales Navigator reported before scraping. An estimate; use total_count for the number of records actually extracted.

progressinteger

Completion percentage, 0 to 100. 100 once the extraction has finished successfully.

created_atstring nullable

When the extraction was created (UTC).

completed_atstring nullable

When the extraction finished (UTC). null if it never finished.

failure_reasonstring

Short 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.

prospectsobject[]

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.

startinteger

Zero-based index of the first record returned.

limitinteger nullable

Page size that was applied, echoing the limit you sent. null when you did not page and every record was returned.

returned_countinteger

Number of records in prospects on this response.

total_countinteger

Number of records this extraction produced in total, across all pages.

has_moreboolean

Whether records remain after this page. Request the next page with start = start + returned_count.

Example response

{
  "search_id": "ext-12345",
  "search_name": "Tech Startup CEOs",
  "status": "EXECUTED",
  "extraction_type": "SEARCH",
  "total_prospects": 150,
  "progress": 100,
  "created_at": "2023-01-01 12:00:00+00:00",
  "completed_at": "2023-01-01 12:04:31+00:00",
  "failure_reason": "insufficient_credits",
  "prospects": [
    {
      "Company Name": "TechCorp Inc",
      "Current Job": "Senior Software Engineer",
      "Email": "alex.johnson@techcorp.com",
      "Email Status": "safe",
      "Full Name": "Alex Johnson"
    }
  ],
  "limit": 100,
  "returned_count": 100,
  "total_count": 143,
  "has_more": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.