# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/linkedin-web/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/linkedin-web/get-filters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/linkedin-web/get-job-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/linkedin-web/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/linkedin-web/search-people \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keywords":"<string>","limit":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.