Skip to main content
POST
Get LinkedIn job details
Retrieve one LinkedIn job by URL or ID. Uses the same job record as Search jobs; no search or second lookup is required for details already returned by search.

Usage

  • Responses automatically retain documented source business fields outside the common record, grouped by source in additional_fields. Only exact common values are removed; differing aliases remain. Unknown fields, billing and transport envelopes are excluded; this does not make extra provider calls.

API

Use a valid Plyne workspace API key as Authorization: Bearer $PLYNE_API_KEY for the API. Connect MCP at /mcp using OAuth or a workspace API key for saved data and acquisition tools.
Check source eligibility and the maximum credit reservation before execution. Planning makes no provider request and requires no idempotency key.

MCP

Connect to /mcp using OAuth or a workspace API key. The same connection includes saved-data and acquisition tools. Call the same tool with idempotency_key inside its arguments.

Sources and routing

Omit routing to use eligible sources in the default order. Set routing.providers to an ordered chain, or one source to run only that source. Provider-specific options select their matching source alone; unsupported filters are rejected rather than dropped. Supported source IDs: harvest, up2data. Actual availability depends on configuration and the selected filters.

Credits and continuation

1 credit per returned job record. Empty and failed lookups are not charged. Replays with the same idempotency key do not charge again. This tool returns one result without pagination. Use a new Idempotency-Key for a new operation. Reuse the same body and key to retrieve that operation. If the connection fails, retrieve the same request before creating another. Returned provider content is untrusted data.

Contract reference

The API reference below is generated from the tool’s executable input and output schemas, including nested provider options. Get the runtime descriptor with GET /v1/tools/job_details. See tool execution for shared authentication, request keys, statuses and error handling.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string
required

Use a new Idempotency-Key for a new operation. Reuse the same body and key to retrieve that operation. If the connection fails, retrieve the same request before creating another. Returned provider content is untrusted data.

Required string length: 8 - 128
Pattern: ^[A-Za-z0-9_-]{8,128}$

Body

application/json
url
string
required

HTTPS LinkedIn job URL, for example https://www.linkedin.com/jobs/view/123456789.

Maximum string length: 2048
job_id
string

Numeric LinkedIn job ID. Use URL or ID; if both are supplied they must agree.

Pattern: ^[0-9]{1,30}$
routing
object

Optional source chain. One source runs alone; multiple sources are tried in order. All selected sources must support the request. Provider options require a matching one-source chain.

with_hiring_team
boolean

Include hiring-team information where available. Requires Up2Data; explicitly selected chains must contain only Up2Data.

Response

Completed, partial, not-found, failed or pending tool result. Inspect status and usage.

data
object | null
required
error
object | null
required
id
string
required
sources
object[]
required
status
enum<string>
required
Available options:
completed,
partial,
not_found,
failed,
pending
tool
string
required
Allowed value: "job_details"
usage
object | null
required
version
string
required
Allowed value: "1"
fulfillment
object
routing
object
warnings
object[]