# LinkedIn / LinkedIn Job

Fetch a public LinkedIn job posting by URL: title, company, location, and summary.

```
GET /api/v1/linkedin/job
```

Auth: `Authorization: Bearer <SOCIFY_KEY>`  
Credits: 2 credits per request

## Parameters

| Name | Required | Description | Example |
|------|----------|-------------|---------|
| `url` | yes | LinkedIn job URL. | `https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804?_l=en` |

## Example

```bash
curl -s 'https://trysocify.com/api/v1/linkedin/job?url=https%3A%2F%2Fwww.linkedin.com%2Fjobs%2Fview%2Fsoftware-engineer-at-epic-3986111804%3F_l%3Den' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| `job_title` | string | Job title. |
| `company_name` | string | Company name. |
| `job_location` | string | Location. |
| `job_employment_type` | string | Employment type. |
| `job_seniority_level` | string | Seniority. |
| `job_summary` | string | Description summary. |
| `job_num_applicants` | number | Applicant count, when available. |
## Sample response

Successful lookups wrap the payload in `{ ok, platform, resource, params, data, meta }`. `data` is shown below.

```json
{
  "ok": true,
  "platform": "linkedin",
  "resource": "job",
  "params": {
    "url": "https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804?_l=en"
  },
  "data": {
    "company_name": "Walmart",
    "job_base_pay_range": "$16.00/hr - $29.00/hr",
    "job_employment_type": "Part-time",
    "job_location": "Fayetteville, NC",
    "job_num_applicants": 25,
    "job_posting_id": "4385163817",
    "job_seniority_level": "Entry level",
    "job_title": "Pharmacy Technician",
    "url": "https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804?_l=en"
  },
  "meta": {
    "credits_charged": 2,
    "latency_ms": 420,
    "platform": "linkedin",
    "resource": "job",
    "path": "/api/v1/linkedin/job"
  }
}
```

## Links

- HTML docs: https://trysocify.com/docs/api/linkedin/job
- SEO page: https://trysocify.com/linkedin/job
- OpenAPI: https://trysocify.com/openapi.json
- Catalog: https://trysocify.com/catalog.json