# Linkedin — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search LinkedIn job listings by job type, experience level, workplace type, salary range, and date posted, then retrieve detailed information about specific positions. Build job boards, career tools, or recruitment dashboards with access to comprehensive filtering options across LinkedIn's public job listings.

**Category:** Jobs | **Website:** [www.linkedin.com/posts/ianrudowski_medtronic-roboticspinesurgery-mazorxse-activity-6651306249872818176-lNbK/](https://www.linkedin.com/posts/ianrudowski_medtronic-roboticspinesurgery-mazorxse-activity-6651306249872818176-lNbK/) | **Docs:** [parse.bot/marketplace/c0972802-fad3-41c4-a619-e58bb14d2eeb/linkedin-com-api](https://parse.bot/marketplace/c0972802-fad3-41c4-a619-e58bb14d2eeb/linkedin-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-linkedin-com-api-c0972802/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_filters

Returns all available filter options and their accepted values for use with search_jobs. No parameters required. Each filter includes the parameter name, a description, and a map of accepted codes to display labels.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-linkedin-com-api-c0972802/get_filters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_job_details

Fetch the full posting for a single job by its LinkedIn job ID. Returns the complete description, job criteria (seniority, employment type, job function, industries), applicant count, and apply URL when available. The job_id comes from search_jobs results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | LinkedIn job posting ID (numeric string from search_jobs results, e.g. 4406118990) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-linkedin-com-api-c0972802/get_job_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"<string>"}'
```

### search_jobs

Full-text search over LinkedIn's public job board. Supports filtering by job type, experience level, workplace type, salary range, and posting recency. Paginates in increments of 25 via the start parameter. Returns job cards with full description text; each result includes the complete job posting description fetched inline, eliminating the need for a separate get_job_details call for description content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `experience_level` | string | No | Experience level filter. |
| `job_type` | string | No | Employment type filter. |
| `keywords` | string | No | Search keywords (job title, skills, etc.) |
| `limit` | integer | No | Maximum number of results to return |
| `location` | string | No | Location to search in (city, state, country) |
| `salary` | string | No | Minimum salary filter. |
| `start` | integer | No | Pagination offset (increments of 25) |
| `time_period` | string | No | Time posted filter. |
| `workplace_type` | string | No | Workplace type filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-linkedin-com-api-c0972802/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"experience_level":"<string>","job_type":"<string>","keywords":"<string>","limit":"<integer>","location":"<string>","salary":"<string>","start":"<integer>","time_period":"<string>","workplace_type":"<string>"}'
```

### search_people

Search LinkedIn's public people directory by keywords. Splits keywords into first/last name path segments for the directory lookup. Returns people cards with name, profile picture, headline (current companies when available), location, and profile URL. Each page returns up to 50 results; use limit to control how many are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keywords` | string | Yes | Search keywords, typically a name or role (e.g. 'software developer', 'john smith'). |
| `limit` | integer | No | Maximum number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-linkedin-com-api-c0972802/search_people \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":"<string>","limit":"<integer>"}'
```