# Get job

Read a public job fragment, optionally supplementing explicit fields from one identity-checked full job page. Reports missing fields, source conflicts and partial supplemental failures.

- Platform: [LinkedIn](https://docs.upscrape.com/docs/platforms/linkedin)
- Capability ID: `linkedin.job.get`
- Cost: 1 credit per request
- Maximum runtime: 60 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "include_structured_data": true,
    "url": "https://www.linkedin.com/jobs/view/4419969671"
  },
  "capability": "linkedin.job.get"
}'
```

## Input


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `include_structured_data` | `boolean` | No | Default: `false`. |
| `url` | `string` | Yes | LinkedIn job URL in canonical or slugged form, or a bare numeric job id. |

### Example input

```json
{
  "include_structured_data": true,
  "url": "https://www.linkedin.com/jobs/view/4419969671"
}
```

## Response

Successful output is returned in `results[0].data`.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This example shows one response. Values and optional fields vary with the data available.

```json
{
  "applicant_count": null,
  "benefits": "Paid leave",
  "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQEfAZWzerj03w/company-logo_100_100/B4EZdkPGXYGcAQ-/0/1749733370529/general_motors_logo?e=2147483647&v=beta&t=[redacted:token]",
  "company_name": "General Motors",
  "company_url": "https://www.linkedin.com/company/general-motors",
  "coverage": {
    "limitations": [
      "Only fields rendered by LinkedIn's logged-out job detail fragment are returned.",
      "Applicant identity and authenticated application state are unavailable."
    ],
    "missing_fields": [
      "applicant_count",
      "apply_url",
      "salary"
    ],
    "source": "linkedin_public_job_detail",
    "status": "partial_public",
    "truncated_fields": []
  },
  "description": "Job Description As a Senior Software Engineer – Go (Golang), you will design, develop, and deliver high-performance middleware and application software solutions supporting GM’s next-generation in-vehicle infotainment platforms and connected vehicle systems. You will play a critical role in building scalable, reliable, and efficient systems that enable advanced user experiences, vehicle integratio…",
  "description_length": 6473,
  "direct_apply": false,
  "employment_type": "Full-time",
  "experience_level": "Not Applicable",
  "industry": "Motor Vehicle Manufacturing, Appliances, Electrical, and Electronics Manufacturing, and IT Services and IT Consulting",
  "job_id": "4419969671",
  "locality": "Warren, MI",
  "posted_at_precision": "unknown",
  "posted_text": "2 weeks ago",
  "requests_attempted": 2,
  "salary": "150000 - 190000 USD YEAR",
  "salary_details": {
    "amount": null,
    "currency": "USD",
    "max": 190000,
    "min": 150000,
    "period": "YEAR",
    "source": "job_posting_jsonld.baseSalary"
  },
  "structured_data": {
    "conflicts": [],
    "status": "enriched"
  },
  "title": "Senior Software Engineer – Go (Golang)",
  "url": "https://www.linkedin.com/jobs/view/4419969671"
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `applicant_count` | `null` | null |
| `benefits` | `string` | Paid leave |
| `company_logo` | `string` | https://media.licdn.com/dms/image/v2/D4E0BAQEfAZWzerj03w/company-logo_1… |
| `company_name` | `string` | General Motors |
| `company_url` | `string` | https://www.linkedin.com/company/general-motors |
| `coverage` | `object` | 5 fields |
| `coverage.limitations` | `array` | 2 items |
| `coverage.missing_fields` | `array` | 3 items |
| `coverage.source` | `string` | linkedin_public_job_detail |
| `coverage.status` | `string` | partial_public |
| `coverage.truncated_fields` | `array` | 0 items |
| `description` | `string` | Job Description As a Senior Software Engineer – Go (Golang), you will d… |
| `description_length` | `integer` | 6473 |
| `direct_apply` | `boolean` | false |
| `employment_type` | `string` | Full-time |
| `experience_level` | `string` | Not Applicable |
| `industry` | `string` | Motor Vehicle Manufacturing, Appliances, Electrical, and Electronics Ma… |
| `job_id` | `string` | 4419969671 |
| `locality` | `string` | Warren, MI |
| `posted_at_precision` | `string` | unknown |
| `posted_text` | `string` | 2 weeks ago |
| `requests_attempted` | `integer` | 2 |
| `salary` | `string` | 150000 - 190000 USD YEAR |
| `salary_details` | `object` | 6 fields |
| `salary_details.amount` | `null` | null |
| `salary_details.currency` | `string` | USD |
| `salary_details.max` | `integer` | 190000 |
| `salary_details.min` | `integer` | 150000 |
| `salary_details.period` | `string` | YEAR |
| `salary_details.source` | `string` | job_posting_jsonld.baseSalary |
| `structured_data` | `object` | 2 fields |
| `structured_data.conflicts` | `array` | 0 items |
| `structured_data.status` | `string` | enriched |
| `title` | `string` | Senior Software Engineer – Go (Golang) |
| `url` | `string` | https://www.linkedin.com/jobs/view/4419969671 |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)