Linkedin Jobs Scraper

LinkedIn Scraper Actor Documentation

The LinkedIn Scraper Actor fetches detailed job listings from LinkedIn based on customizable parameters. This tool is ideal for recruiters, job seekers, and analysts looking to automate job data extraction.

---

Endpoint

POST /linkedin-scraper

---

Parameters

Parameter	Type	Description	Accepted Values	Example
keyword	string	The text to search for jobs.	Any text string.	"Software Developer"
location	string	The name of the city to filter job listings.	Any city name.	"Los Angeles"
dateSincePosted	string	The time range for job postings.	"past month", "past week", "24hr"	"past week"
jobType	string	Type of job position.	"full time", "part time", "contract", "temporary", "volunteer", "internship"	"full time"
remoteFilter	string	Filter jobs based on work mode.	"on site", "remote", "hybrid"	"remote"
salary	string	Minimum salary requirement.	"40000", "60000", "80000", "100000", "120000"	"60000"
experienceLevel	string	Experience level required for the job.	"internship", "entry level", "associate", "senior", "director", "executive"	"entry level"
limit	string	Number of jobs to return per page.	Any positive integer.	"10"
sortBy	string	Sorting preference for job listings.	"recent", "relevant"	"recent"
page	string	Page number for paginated results.	Any positive integer.	"1"

---

Response

The response is an array of job objects with detailed information about each job listing.

---

Sample JSON Response

1[
2  {
3    "jobPostingId": 4084852366,
4    "title": "[Full Remote] Frontend Developer",
5    "companyDetails": {
6      "companyId": "101069285",
7      "name": "Joinrs España",
8      "location": "Spain",
9      "companyLogo": "https://media.licdn.com/dms/image/v2/D4D0BAQFE_BjO9MTPBQ/company-logo_100_100/company-logo_100_100/0/1698999862186?e=1741219200&v=beta&t=MZsfRnU9rq4AKpAViKpKr5brVVWopqI6kxENtf1n_0w"
10    },
11    "description": "Esta posición está en el equipo de Semrush...",
12    "applyMethod": {
13      "companyApplyUrl": "https://www.joinrs.com/job-offers/274937/?utm_source=linkedin&utm_medium=job-offer-es&utm_campaign=274937-scraped"
14    },
15    "employmentStatus": "FULL_TIME",
16    "formattedExperienceLevel": "Entry level",
17    "workRemoteAllowed": true,
18    "formattedIndustries": [
19      "Software Development",
20      "IT System Custom Software Development"
21    ],
22    "listedAt": "2024-11-28T08:14:16.000Z",
23    "expireAt": "2025-01-24T13:52:08.000Z",
24    "salary": "Not specified"
25  },
26  {
27    "jobPostingId": 4072004791,
28    "title": "Software Engineer I",
29    "companyDetails": {
30      "companyId": "167280",
31      "name": "Eventbrite",
32      "location": "Spain",
33      "companyLogo": "https://media.licdn.com/dms/image/v2/C4E0BAQFZ9YEntlWNUQ/company-logo_100_100/company-logo_100_100/0/1630597894645/eventbrite_logo?e=1741219200&v=beta&t=xGmVDoTsS0Y6JeZUhpzvIpo6Hifq_xV_3Qmnlp6TEUE"
34    },
35    "description": "Eventbrite is seeking Full stack Software engineers...",
36    "applyMethod": {
37      "companyApplyUrl": "https://job-boards.greenhouse.io/eventbriteinc/jobs/4564760007?gh_src=sTBvdp"
38    },
39    "employmentStatus": "FULL_TIME",
40    "formattedExperienceLevel": "Entry level",
41    "workRemoteAllowed": true,
42    "formattedIndustries": [
43      "Software Development"
44    ],
45    "listedAt": "2024-11-11T13:06:37.000Z",
46    "expireAt": "2024-12-11T13:06:37.000Z",
47    "salary": "Not specified"
48  }
49]

---

Key Fields in Response

Field	Description
jobPostingId	Unique identifier for the job posting.
title	The job title.
companyDetails	Information about the hiring company, including name, location, and logo.
description	Detailed description of the job.
applyMethod	Information on how to apply, including the application URL.
employmentStatus	Employment type (e.g., full-time, part-time).
workRemoteAllowed	Indicates if the job allows remote work.
formattedExperienceLevel	The required experience level for the job.
formattedIndustries	The industries related to the job.
listedAt	The date and time when the job was listed.
expireAt	The expiration date for the job posting.
salary	The salary offered (if specified).

---

Error Codes

Code	Description
400	Invalid parameters supplied.
404	No job postings found based on the given criteria.
500	Internal server error.

---

Support

For support, please contact pintoflowpt@gmail.com.

Here’s a comprehensive FAQ section with 17 questions and answers tailored for SEO optimization. The content is structured to cover both user intent and relevant keywords for better search engine visibility.

---

Frequently Asked Questions

1. What does the keyword parameter do?

The keyword parameter allows users to specify the job title or relevant term they want to search for, such as "Software Developer" or "Project Manager."

---

2. Can I search for jobs in multiple cities using the location parameter?

Currently, the location parameter supports a single city name at a time, such as "Los Angeles" or "New York." To search in multiple cities, make separate requests for each city.

---

3. What are the accepted values for dateSincePosted?

The dateSincePosted parameter supports "past month", "past week", and "24hr". These filters allow you to find jobs posted within specific time frames.

---

4. How do I use the jobType parameter?

The jobType parameter filters jobs based on their nature, such as "full time", "part time", "contract", "temporary", "volunteer", or "internship". Use the value that matches your preference.

---

5. What does the remoteFilter parameter mean?

The remoteFilter parameter lets you filter jobs based on work arrangements:

• "on site" for office-based roles.
• "remote" for fully remote jobs.
• "hybrid" for a mix of remote and in-office work.

---

6. How do I specify a minimum salary with the salary parameter?

The salary parameter allows you to set a minimum salary threshold. For example, use "60000" to filter jobs offering at least $60,000 annually.

---

7. What experience levels can I search for using experienceLevel?

The experienceLevel parameter supports the following values:

• "internship"
• "entry level"
• "associate"
• "senior"
• "director"
• "executive"

---

8. Can I limit the number of results returned?

Yes, the limit parameter lets you specify the number of job listings per request. For instance, set "10" to get 10 results per page.

---

9. How does the sortBy parameter work?

The sortBy parameter allows you to order results by "recent" (newly posted jobs) or "relevant" (most closely matching your search).

---

10. What is the purpose of the page parameter?

The page parameter is used for pagination. For example, "1" fetches the first page of results, "2" fetches the second page, and so on.

---

11. Can I combine multiple filters in a single request?

Yes, you can combine parameters like keyword, location, salary, and others in a single API call for refined results.

---

12. What happens if I don’t include a parameter in my request?

If a parameter is omitted, the API will use default settings or return a broader range of results without filtering by that specific criterion.

---

13. Is there a limit to the number of API requests I can make?

API request limits depend on your subscription plan. Check your plan's documentation for details on request quotas.

---

14. Can I search for jobs without specifying a location?

Yes, omitting the location parameter will return jobs from all available locations.

---

15. How do I filter for remote-only jobs?

Set the remoteFilter parameter to "remote" to exclusively view remote job opportunities.

---

16. Does the API support international job searches?

Yes, the API supports job searches worldwide. Ensure that the location parameter is set to a valid city name.

---

17. Can I sort jobs by both relevance and recency?

Currently, the sortBy parameter accepts one value at a time. Choose either "relevant" or "recent" for sorting.

---

SEO-Optimized Content Additions

How to Find the Best Job Opportunities Using an API

Job search APIs are powerful tools for automating and streamlining job hunting. By specifying parameters like keyword, location, and experienceLevel, users can quickly narrow down listings that match their preferences. For remote job seekers, the remoteFilter is particularly beneficial, while those seeking higher salaries can leverage the salary parameter.

Why Use Advanced Filters in Job Search APIs

Advanced filters like dateSincePosted and jobType help you find roles tailored to your needs. Whether you’re a senior executive or an intern, these APIs ensure you don’t waste time browsing irrelevant listings.

Tips for Optimizing Your API Queries

1. Use specific keywords for better results.
2. Always set a limit to control the number of returned results.
3. Combine multiple filters like location and salary for precise searches.

Advantages of Remote Job Search APIs

With the rise of telecommuting, APIs offering filters for remote and hybrid jobs are invaluable. They provide instant access to opportunities worldwide, making it easier for job seekers to find flexible positions.

---