LinkedInDumper: dump employee information from LinkedIn Voyager API

by ddos · October 23, 2025

LinkedInDumper

Python 3 script to dump company employees from LinkedIn Voyager API.

The results contain firstname, lastname, position (title), location, and a user’s profile link. Only 2 API calls are required to retrieve all employees if the company does not have more than 10 employees. Otherwise, we have to paginate through the API results. With the –email-format CLI flag one can define a Python string format to auto-generate email addresses based on the retrieved first and last name.

Limitations

LinkedIn will allow only the first 1,000 search results to be returned when harvesting contact information. You may also need a LinkedIn premium account when you reached the maximum allowed queries for visiting profiles with your freemium LinkedIn account.

Furthermore, not all employee profiles are public. The results vary depending on your used LinkedIn account and whether you are befriended with some employees of the company to crawl or not. Therefore, it is sometimes not possible to retrieve the firstname, lastname and profile url of some employee accounts. The script will not display such profiles, as they contain default values such as “LinkedIn” as firstname and “Member” in the lastname. If you want to include such private profiles, please use the CLI flag –include-private-profiles. Although some accounts may be private, we can obtain the position (title) as well as the location of such accounts. Only firstname, lastname and profile URL are hidden for private LinkedIn accounts.

Finally, LinkedIn users are free to name their profile. An account name can therefore consist of various things such as saluations, abbreviations, emojis, middle names etc. I tried my best to remove some nonsense. However, this is not a complete solution to the general problem. Note that we are not using the official LinkedIn API. This script gathers information from the “unofficial” Voyager API.

How-To

Sign in to www.linkedin.com and retrieve your li_at session cookie value e.g. via developer tools. I recommend not using your real LinkedIn account.
Specify the cookie value either persistently in the python script’s variable li_at or temporarily via the CLI flag –cookie
Browse your company on LinkedIn and note the url. Must be something like https://www.linkedin.com/company/apple
Clone the repo: git clone https://github.com/l4rm4nd/LinkedInDumper.git
Install requirements via pip install -r requirements.txt
Run the Python script and enjoy the results

Use

[pastacode lang=”bash” manual=”usage%3A%20linkedindumper.py%20%5B-h%5D%20–url%20%3Clinkedin-url%3E%20%5B–cookie%20%3Ccookie%3E%5D%20%5B–quiet%5D%20%5B–include-private-profiles%5D%20%5B–include-contact-infos%5D%20%5B–jitter%5D%20%5B–email-format%20%3Cmail-format%3E%5D%20%5B–output-json%20%3Cjson-file%3E%5D%20%5B–output-csv%20%3Ccsv-file%3E%5D%0A%0Aoptions%3A%0A%20%20-h%2C%20–help%20%20%20%20%20%20%20%20%20%20%20%20show%20this%20help%20message%20and%20exit%0A%20%20–url%20%3Clinkedin-url%3E%20%20A%20LinkedIn%20company%20url%20-%20https%3A%2F%2Fwww.linkedin.com%2Fcompany%2F%3Ccompany%3E%0A%20%20–cookie%20%3Ccookie%3E%20%20%20%20%20LinkedIn%20’li_at’%20session%20cookie%0A%20%20–include-private-profiles%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20Show%20private%20accounts%20too%0A%20%20–include-contact-infos%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20Query%20each%20employee%20individually%20and%20retrieve%20contact%20infos%0A%20%20–jitter%20%20%20%20%20%20%20%20%20%20%20%20%20%20Add%20a%20random%20jitter%20to%20HTTP%20requests%20to%20bypass%20rate%20limiting%0A%20%20–email-format%20%3Cmail-format%3E%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20Python%20string%20format%20for%20emails%3B%20for%20example%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20–email-format%20’%7B0%7D.%7B1%7D%40example.com’%20–%3E%20john.doe%40example.com%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20–email-format%20’%7B0%5B0%5D%7D.%7B1%7D%40example.com’%20–%3E%20j.doe%40example.com%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20–email-format%20’%7B1%7D%40example.com’%20–%3E%20doe%40example.com%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20–email-format%20’%7B0%7D%40example.com’%20–%3E%20john%40example.com%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20–email-format%20’%7B0%5B0%5D%7D%7B1%5B0%5D%7D%40example.com’%20–%3E%20jd%40example.com%0A%20%20–output-json%20%3Cjson-file%3E%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20Store%20results%20in%20json%20output%20file%0A%20%20–output-csv%20%3Ccsv-file%3E%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20Store%20results%20in%20csv%20output%20file%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20″ message=”” highlight=”” provider=”manual”/]

Source: https://github.com/l4rm4nd/