# LinkedIn Job Info

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/linkedin/job/info` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/linkedin-job-info |

## Description

Dive into LinkedIn job data and trends for in-depth labor market insights.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/linkedin/job/info' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by job ID. Customer Success Manager at Rokt

```json
{
  "id": 3795872581,
  "title": "Customer Success Manager",
  "address": {
    "city": "City of New York",
    "state": "New York",
    "county": null,
    "country": "United States",
    "country_code": "US"
  },
  "job_url": "https://www.linkedin.com/jobs/view/3795872581",
  "industry": [
    "advertising-services",
    "technology",
    "information-and-internet"
  ],
  "location": "New York, NY",
  "functions": [
    "Customer Service"
  ],
  "list_date": "4 days ago",
  "recruiter": {
    "headline": "Talent Acquisition at Rokt",
    "full_name": "Anais",
    "profile_url": "https://www.linkedin.com/in/x"
  },
  "company_url": "https://www.linkedin.com/company/rokt",
  "company_logo": "https://media.licdn.com/dms/image/D4E0BAQE7AmEYtqhs9g/company-logo_100_100/0/1706546290679/rokt_logo",
  "company_name": "Rokt",
  "employment_type": "Full-time",
  "job_description": "Unlock your inner voice. Join a team of diverse individuals who thrive by conquering new frontiers...",
  "seniority_level": "Mid-Senior level",
  "total_applicants": 200,
  "compensation_salary": "$90,000.00/yr - $110,000.00/yr"
}
```

## Documentation

## Overview
Retrieve full details for a specific LinkedIn job posting using its ID or URL. Returns job title, description, location, employment type, seniority level, recruiter info, and salary range.

## Quickstart
```
GET https://api.piloterr.com/v2/linkedin/job/info?query=4390885746
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | LinkedIn job ID or full job posting URL |

## Main use cases
- Scrape job descriptions at scale to build NLP training datasets or skill extraction pipelines
- Monitor specific job openings for competitive intelligence
- Enrich ATS systems with structured job data including recruiter information
- Power job aggregator products centralizing LinkedIn postings