# LinkedIn 职位搜索 API (linkedin.jobs)

- Canonical page: https://everyinfra.com/linkedin-api/jobs
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "linkedin", "action": "jobs", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=linkedin&action=jobs

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | search 为帖子关键词，profile_search 为当前职位头衔，jobs 为岗位搜索词或完整职位搜索 URL。搜人并不等同于按人物姓名或邮箱精确查询。 |
| location | not declared | no | not declared | profile_search 的人物所在地文本；jobs 中为岗位地点，keyword 已是完整 URL 时不再追加；person_profile 不按它筛选。 |
| limit | integer (1–200) | no | 20 | 这次调用最多返回的条数，整数，1–200；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| company_name | 公司名称。 |
| company_url | 公司主页链接。 |
| company_logo | 公司 logo。 |
| location | 地理位置描述，原文透传，格式随平台而异。 |
| salary | 薪酬信息。 |
| employment_type | 雇佣类型（全职/兼职/合同/实习）。 |
| seniority | 职级。 |
| applicant_count | 岗位已投递人数。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "linkedin",
  "action": "jobs",
  "params": {
    "keyword": "software engineer"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "linkedin",
        "action": "jobs",
        "params": {
            "keyword": "software engineer",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "linkedin",
  "action": "jobs",
  "results": [
    {
      "id": "•••",
      "url": "https://www.linkedin.com/jobs/view/software-development-engineer-ii-at-expedia-group-4469399031?position=17&pageNum=0&refId=Cp4vOjae6AB%2Bd%2FM%2B3qjsQg%3D%3D&trackingId=zH57%2BPs4uVLHK0FvilHeog%3D%3D",
      "title": "Software Development Engineer II",
      "text": "At Expedia Group, we help travelers explore the world, one journey at a time. As a global travel company powered by passionate people, trusted partnerships, and leading technology, we connect travelers, partners, and advertisers through our consumer brands, B2B network, and trave…",
      "company_name": "Expedia Group",
      "company_url": "https://www.linkedin.com/company/expediagroup?trk=public_jobs_jserp-result_job-search-card-subtitle",
      "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQH35rDiMFanuQ/company-logo_100_100/B4EaCgt37sGoAI-/0/1789402775480/expediagroup_logo?e=2147483647&v=beta&t=tTgqxIYsK7mUH_BfkjhzyHq_eH3V9cU7Q7FamrhMptM",
      "location": "Chicago, IL",
      "salary": "$111,000.00/yr - $155,500.00/yr",
      "employment_type": "Full-time",
      "seniority": "Not Applicable",
      "posted_at": "2026-09-24T00:00:00+00:00",
      "platform": "linkedin"
    },
    {
      "id": "•••",
      "url": "https://www.linkedin.com/jobs/view/software-engineer-ii-backend-platform-team-at-rippling-4463786876?position=18&pageNum=0&refId=Cp4vOjae6AB%2Bd%2FM%2B3qjsQg%3D%3D&trackingId=GWDyqCdQVVuCLrfoOsaOzg%3D%3D",
      "title": "Software Engineer II, Backend - Platform Team",
      "text": "About Rippling\n\nRippling gives businesses one place to run HR, IT, and Finance. It brings together all of the workforce systems that are normally scattered across a company, like payroll, expenses, benefits, and computers. For the first time ever, you can manage and automate ever…",
      "company_name": "Rippling",
      "company_url": "https://www.linkedin.com/company/rippling?trk=public_jobs_jserp-result_job-search-card-subtitle",
      "company_logo": "https://media.licdn.com/dms/image/v2/D4E0BAQGVw6UsjqtXGw/company-logo_100_100/B4EZlN73QeHIAQ-/0/1757949162831/rippling_logo?e=2147483647&v=beta&t=_-PZ3E8XmdCyc89UhLvip3soyI97bY1FRM89cZYXEiQ",
      "location": "Seattle, WA",
      "salary": "",
      "employment_type": "Full-time",
      "seniority": "Not Applicable",
      "posted_at": "2026-09-05T00:00:00+00:00",
      "platform": "linkedin"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md