Get a company's LinkedIn jobs listings by using Proxycurl's Jobs API
Tags: jobs, linkedin, proxycurl
Published: 2022-10-28 21:29:57

## Table of Content

- Introduction
- Endpoints Concerned with Proxycurl's Jobs API
- - Job Listing Endpoint
- - Job Profile Endpoint
- Conclusion

## Introduction
Proxycurl makes it simple to build data-driven applications and web scraping simple by providing simple but powerful APIs that make working with/getting information about a person or a company as simple as possible.

Today, we are going to look into Proxycurl's Jobs API. The Job API makes it simple to fetch a list of jobs posted by a company on LinkedIn and also get structured data from a LinkedIn job profile.

## Endpoints Concerned with Proxycurl's Jobs API
 Proxycurl has two endpoints which are under Jobs API, the two endpoints are:
- Job listing endpoint
- Job profile endpoint

### **1. Job Listing Endpoint**
This endpoint accepts the *search_id *of the company as its parameter (which is a required parameter) and sends back a list of jobs posted by the company. The *search_id* parameter can be gotten from Proxycurl's Company Profile API.

Request example using JavaScript's fetch API:
```
const parameters = new URLSearchParams({
  search_id: "1035"
});

fetch("https://nubela.co/proxycurl/api/v2/linkedin/company/job?" + parameters, {
  method: "GET",
  headers: {
    Authorization: "Bearer <your API key>"
  }
});

``` 

Request example using Python's requests package:
```
import requests

response = requests.get("https://nubela.co/proxycurl/api/v2/linkedin/company/job",
      params = {
          'search_id': "1035"
      },
      headers={'Authorization': 'Bearer <your API key>'})
```

The response will contain a job array/list, next_page_no, next_page_api_url, previous_page_no, previous_page_api_url, where each element of the job array/list is an object/dictionary that contains the following:

company: The company name.

company_url: The company's URL.

job_title: The job title.

job_url: The job's title.

list_date: Date the job was published.

location: The location associated with the Job.

Example response:

```
{
    "job": [
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Security Analyst (DART) - Detection and Response Team",
            "job_url": "https://www.linkedin.com/jobs/view/3099474469",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Technology Specialists BizApps",
            "job_url": "https://www.linkedin.com/jobs/view/3073299528",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Customer Success Management IC4",
            "job_url": "https://www.linkedin.com/jobs/view/3088297589",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Web Sales \u0026 Customer Support Advisor - Consumer Customers",
            "job_url": "https://www.linkedin.com/jobs/view/3073408044",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Digital Advisor",
            "job_url": "https://www.linkedin.com/jobs/view/3091944620",
            "list_date": null,
            "location": "Manchester, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Digital Advisor",
            "job_url": "https://www.linkedin.com/jobs/view/3091945492",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Meeting Room Global Black Belt Sales Professional",
            "job_url": "https://www.linkedin.com/jobs/view/3073695907",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Customer Success Manager - Modern Work",
            "job_url": "https://www.linkedin.com/jobs/view/3092059527",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Business Administrator",
            "job_url": "https://www.linkedin.com/jobs/view/3073292283",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Account Delivery Management IC6",
            "job_url": "https://www.linkedin.com/jobs/view/3073466352",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Executive Producer-Xbox Publishing",
            "job_url": "https://www.linkedin.com/jobs/view/3089096967",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Digital Advisor",
            "job_url": "https://www.linkedin.com/jobs/view/3091944622",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Full Time Opportunities - AI Researcher",
            "job_url": "https://www.linkedin.com/jobs/view/2982837417",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Escalation Engineer Technical Support - Azure/Telco",
            "job_url": "https://www.linkedin.com/jobs/view/3095506397",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Intune Support Engineer",
            "job_url": "https://www.linkedin.com/jobs/view/3073267700",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Customer Success Account Mgmt - Application Development",
            "job_url": "https://www.linkedin.com/jobs/view/3085586525",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Security Analyst (DART) - Detection and Response Team",
            "job_url": "https://www.linkedin.com/jobs/view/3099476216",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Researcher in User Experience Design",
            "job_url": "https://www.linkedin.com/jobs/view/3073409764",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Product Manager",
            "job_url": "https://www.linkedin.com/jobs/view/3097096699",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Internship opportunities: Confidential Computing",
            "job_url": "https://www.linkedin.com/jobs/view/3043459039",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Internship opportunities: Machine Learning for Visual Communication",
            "job_url": "https://www.linkedin.com/jobs/view/3037128666",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Solution Area Specialists Cyber Security",
            "job_url": "https://www.linkedin.com/jobs/view/3073693634",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Studio Discipline Lead",
            "job_url": "https://www.linkedin.com/jobs/view/3094117901",
            "list_date": null,
            "location": "London, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Studio Discipline Lead",
            "job_url": "https://www.linkedin.com/jobs/view/3094119661",
            "list_date": null,
            "location": "Reading, England, United Kingdom"
        },
        {
            "company": "Microsoft",
            "company_url": "https://www.linkedin.com/company/microsoft",
            "job_title": "Studio Discipline Lead",
            "job_url": "https://www.linkedin.com/jobs/view/3094124026",
            "list_date": null,
            "location": "Cambridge, England, United Kingdom"
        }
    ],
    "next_page_api_url": "http://proxycurl-web.127.0.0.1.nip.io:5002/proxycurl-dev/proxycurl-dev/api/v2/linkedin/company/job?pagination=eyJwYWdlIjogMX0\u0026search_id=1035",
    "next_page_no": 1,
    "previous_page_api_url": null,
    "previous_page_no": null
}
``` 
### **2. Job Profile Endpoint**
The job profile endpoint is used to get more information about a specific job that is posted. This endpoint accepts a URL parameter which is the URL of the LinkedIn Job Profile to target and returns the following in its response:

linkedin_internal_id: The identifier concerned with a specific job.

job_description: The job description of the jon concerned with the internal identifier.

apply_url: The URL to apply for the job.

title: The job title.

location: The location for the job.

company: The name of the company issuing the job.

seniority_level: The level of experience/competence expected of the candidates applying for the job.

industry: The industry the job is concerned with.

employment_type: The employment type (part-time or full-time)

job_functions: Things expected of the applicants.

total_applicants: Total number of applicants that have applied.


Request example using JavaScript's fetch API:
```
const parameters = new URLSearchParams({
  url: "https://www.linkedin.com/jobs/view/3046202003"
});

fetch("https://nubela.co/proxycurl/api/linkedin/job?" + parameters, {
  method: "GET",
  headers: {
    Authorization: "Bearer <your API key>"
  }
});

``` 

Request example using Python's requests package:
```
import requests

response = requests.get("https://nubela.co/proxycurl/api/linkedin/job",
      params = {
          "url": "https://www.linkedin.com/jobs/view/3046202003"
      },
      headers={'Authorization': 'Bearer <your API key>'})
```

Sample response:

```
{
    "apply_url": null,
    "company": {
        "logo": "https://media-exp1.licdn.com/dms/image/C4D0BAQHiNSL4Or29cg/company-logo_400_400/0/1519856215226?e=1661385600\u0026v=beta\u0026t=rUecQpduLPDavL3JswjLsJAUNgSu1Q2l3JS5sGp8nHk",
        "name": "Google",
        "url": "https://www.linkedin.com/company/google"
    },
    "employment_type": "Full-time",
    "industry": [
        "Internet"
    ],
    "job_description": "This role may also be located in our Playa Vista, CA campus.\n\nNote: By applying to this position you will have an opportunity to share your preferred working location from the following: Redwood City, CA, USA; Ann Arbor, MI, USA; Chicago, IL, USA; New York, NY, USA; Los Angeles, CA, USA.\n\nMinimum qualifications:\nBachelor\u2019s degree in Engineering, Computer Science, Information Systems, Statistics, Economics, Mathematics, Finance, a related quantitative field, or equivalent practical experience.2 years of experience in business intelligence, data engineering, data modeling, or using analytics with SQL.Experience with programming languages (e.g. Python).Experience partnering or working with stakeholders across organizational boundaries.\n\nPreferred qualifications:\n4 years of experience designing and building scalable data pipelines to enable data-driven business selections.Experience in statistical tools (e.g., R, SPSS, MATLAB, etc.).Experience in machine learning models (e.g., scikit-learn, TensorFlow, etc.).Knowledge of commercial and other reporting tools and technologies (e.g., Tableau, QlikView, D3, Microstrategy, BusinessObjects, Cognos, etc.).Ability to manage multiple projects, and communicate findings/reports to stakeholders and non-techincal audiences. Excellent verbal and written communication skills.\n\nAbout The Job\n\nAs a Data Engineer, you will use an analytical, data-driven approach to drive understanding of business changes. You will build data pipelines that enable engineers, analysts, and other stakeholders across the organization. You will also build data models to deliver insightful analytics while ensuring data integrity.\n\nWhen our millions of advertisers and publishers are happy, so are we! Our Google Customer Solutions (GCS) team of entrepreneurial, enthusiastic and client-focused members are the \"human face\" of Google, helping entrepreneurs both individually and broadly build their online presence and grow their businesses. We are dedicated to growing the unique needs of advertising companies. Our teams of strategists, analysts, advisers and support specialists collaborate closely to spot and analyze customer needs and trends. In collaboration, we create and implement business plans broadly for all types of businesses.\n\nResponsibilities\n\nBuild data pipelines, reports, best practices, and frameworks that enable analysts and stakeholders across the organization.Recognize and adopt best practices in developing pipelines and analytical insights, including data integrity, test design, analysis, validation, and documentation.Design and develop scalable and actionable solutions that provide insights to help advertisers grow.Work with stakeholders to understand feature and tool gaps and innovate on behalf of our customers.\n\nGoogle is proud to be an equal opportunity workplace and is an affirmative action employer. We are committed to equal employment opportunity regardless of race, color, ancestry, religion, sex, national origin, sexual orientation, age, citizenship, marital status, disability, gender identity or Veteran status. We also consider qualified applicants regardless of criminal histories, consistent with legal requirements. See also Google\u0027s EEO Policy and EEO is the Law. If you have a disability or special need that requires accommodation, please let us know by completing our Accommodations for Applicants form .",
    "job_functions": [],
    "linkedin_internal_id": "3046202003",
    "location": null,
    "seniority_level": null,
    "title": "Data Engineer, Google Customer Solutions",
    "total_applicants": null
}
``` 

## Conclusion
With Proxycurl's Jobs API, you can confidently get data about a job listing and get more information about a specific job. Find out more here: [https://nubela.co/blog/linkdb-an-exhaustive-dataset-of-linkedin-members-and-companies/](https://nubela.co/blog/linkdb-an-exhaustive-dataset-of-linkedin-members-and-companies/)