Download the contacts of a scraper (CSV)

GET
/linkedin-scrappers/{id}/download

Returns the CSV of a scraper as a string in data (a JSON response, not a file). Separator ;, first line = column names, UTF-8 without BOM, values quoted only when needed. Large extractions give large responses (several MB).

It can be called while the extraction runs: you get what has been collected so far.

format: 1 = only contacts with an email (requires a finished enrichment with at least one email), 2 = only contacts without an email (all contacts if the scraper was never enriched), 3 = all contacts.

People columns (Sales Navigator and classic searches): id, firstName, lastName, fullName, location, isPremium, openProfile, linkedinUrlProfile, summary, title, company, companyId, companyLocation, companyDescription, companySize, estimatedMinRevenue, estimatedMaxRevenue, industry, description, companyPage, companyWebsite, type. id is the Sales Navigator profile key and can contain commas. Fields that LinkedIn does not provide stay empty (classic searches fill fewer columns).

After an email enrichment the file is rewritten in this order: id, email_emelia, qualification_emelia, gender_emelia, firstName, lastName, fullName, location, isPremium, openProfile, linkedinUrlProfile, phone_number_emelia, phone_qualification_emelia, phone_country_emelia, summary, title, company, companyId, companyLocation, companyDescription, companySize, estimatedMaxRevenue, estimatedMinRevenue, industry, description, companyPage, companyWebsite, domain_emelia, type.

Account search columns (companies): id, companyName, companyPage, companyDescription, companySize, employeeCountRange, industry, companyWebsite, companyLocation, yearFounded, type, estimatedMinRevenue, estimatedMaxRevenue.

Once a scraper is done, its contacts are also imported automatically into an Emelia list (convertedListId), that you can manage with the Lists endpoints.

Authorization

apiKey
Authorization<token>

Your 48 character API key, sent as is (a Bearer prefix is tolerated). Create it at https://v3.emelia.io/settings/api.

In: header

Path Parameters

id*string

Scrapper id (_id returned by POST /linkedin-scrappers or GET /linkedin-scrappers). 24 hexadecimal characters.

Match^[0-9a-fA-F]{24}$

Query Parameters

format*integer

1 = contacts with an email only, 2 = contacts without an email only, 3 = all contacts.

Value in

  • 1
  • 2
  • 3

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/linkedin-scrappers/66f1a2b3c4d5e6f7a8b9c0d1/download?format=3" \  -H "Authorization: YOUR_API_KEY"

{  "success": true,  "data": "id;firstName;lastName;fullName;location;isPremium;openProfile;linkedinUrlProfile;summary;title;company;companyId;companyLocation;companyDescription;companySize;estimatedMinRevenue;estimatedMaxRevenue;industry;description;companyPage;companyWebsite;type\nACwAAA1b2c3dEFg,NAME_SEARCH,xY1z;Jane;Doe;Jane Doe;Lyon, Auvergne-Rhone-Alpes, France;true;false;https://www.linkedin.com/in/ACwAAA1b2c3dEFg;;CTO;Acme;1234567;Lyon, France;Acme builds reusable rockets.;51-200;10;50;Aerospace;;https://www.linkedin.com/company/acme-example;https://acme.example;Privately Held\nACwAAB9z8y7xWVu,NAME_SEARCH,aB2c;John;Roe;John Roe;Paris, Ile-de-France, France;false;false;https://www.linkedin.com/in/ACwAAB9z8y7xWVu;;Chief Technology Officer;Globex;7654321;Paris, France;Globex makes widgets.;11-50;1;5;Software Development;;https://www.linkedin.com/company/globex-example;https://globex.example;Privately Held"}