# Xing 职位搜索 API (xing.jobs)

- Canonical page: [https://everyinfra.com/xing-api/jobs](https://everyinfra.com/xing-api/jobs?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "xing", "action": "jobs", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

XING 职位搜索按 `keyword` 检索职位，岗位名或技能词都可以，每条职位带公司、地点、薪酬、雇佣类型、职业层级、远程选项、投递链接、有效期和雇主评分。它回答「XING 上现在有哪些岗位在招、给多少钱」，适合做招聘市场调研、薪酬摸底和岗位监测。

`keyword` 搜的是招聘岗位，不是个人会员。结果里的 `remote_option` 标出远程办公选项，`valid_through` 是岗位有效期截止日，做岗位监测时可以按它剔掉已过期的岗位。已经知道某个职位的链接，直接用职位详情读它，两边返回的字段相同。

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | jobs 的岗位或技能关键词，用于 XING 职位检索；不是个人会员搜索。 |
| discipline | not declared | no | not declared | jobs 的专业职能名称，自由文本，必须匹配目标 XING 界面语言中的分类标签，例如 Technology；不是任意技能关键词。 |
| employment_type | not declared | no | not declared | jobs 的雇佣类型，可传单值或数组：FULL_TIME 全职、PART_TIME 兼职、INTERN 实习、CONTRACTOR 合同、FREELANCE 自由职业、TEMPORARY 临时、OTHER 其他；未知取值会被忽略。 |
| location | not declared | no | not declared | jobs 的目标城市，建议明确填写；未指定时默认搜索 Berlin，而不是整个德语区。 |
| radius | integer | no | not declared | jobs 围绕 location 的搜索半径，整数公里；默认 10，传 0 等同于不传。 |
| salary_max | integer | no | not declared | jobs 的最高年度薪酬过滤，单位 EUR，非负整数，0 不限制；未注明税前还是税后，不是月薪或平台调用价格。 |
| salary_min | integer | no | not declared | jobs 的最低年度薪酬过滤，单位 EUR，非负整数，0 不限制；不能把小时费率直接填入。 |
| limit | integer (1–100) | no | 20 | 这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| company | 公司名称。 |
| company_url | 公司主页链接。 |
| location | 地理位置描述，原文透传，格式随平台而异。 |
| country | 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。 |
| salary_min | 薪酬区间下限。 |
| salary_max | 薪酬区间上限。 |
| salary_median | 薪酬中位数。 |
| salary_currency | 薪酬币种。德语区岗位多为 EUR，比数字前先看它。 |
| employment_type | 雇佣类型（全职/兼职/合同工）。 |
| career_level | 职业层级（实习/专业人员/管理层等）。 |
| discipline | 专业领域分类，XING 的德语区职能体系。 |
| industry | 所属行业。 |
| remote_option | 远程办公选项。 |
| company_size | 公司规模区间。 |
| apply_url | 投递链接。 |
| valid_through | 岗位有效期截止日。 |
| keywords | 关键词标签。 |
| language | 内容语言代码（如 zh、en），由平台判定，可能不准。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| description | 简介或描述，通常比 text 短。 |
| kununu_rating | kununu 雇主评分。kununu 是 XING 旗下的雇主点评站，相当于德语区的 Glassdoor。 |
| 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": "xing",
  "action": "jobs",
  "params": {
    "keyword": "Data 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": "xing",
        "action": "jobs",
        "params": {
            "keyword": "Data 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": "xing",
  "action": "jobs",
  "results": [
    {
      "id": "158133174.cf01fc",
      "url": "https://www.xing.com/jobs/berlin-data-engineer-158133174",
      "title": "Data Engineer (m/w/d)",
      "company": "Wall GmbH",
      "location": "Berlin",
      "salary_min": 49000,
      "salary_max": 67500,
      "salary_median": 58000,
      "salary_currency": "EUR",
      "employment_type": "Full-time",
      "posted_at": "2026-09-25T05:42:21+00:00",
      "platform": "xing"
    },
    {
      "id": "157534514.7aa1ec",
      "url": "https://www.xing.com/jobs/berlin-data-engineer-all-genders-berlin-157534514",
      "title": "Data Engineer (all genders) Berlin",
      "company": "Instaffo GmbH",
      "location": "Berlin",
      "salary_min": 55000,
      "salary_max": 75500,
      "salary_median": 62500,
      "salary_currency": "EUR",
      "employment_type": "Full-time",
      "posted_at": "2026-09-16T00:08:33+00:00",
      "platform": "xing"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 不填 `location` 会搜哪里？

默认搜索 Berlin，而不是整个德语区，所以想查别的城市必须明确填写 `location`。`radius` 是围绕这个城市的搜索半径，整数公里，默认 10，传 0 等同于不传。

### 薪酬过滤怎么填？

`salary_min` 和 `salary_max` 都是年度薪酬，单位 EUR，填非负整数，0 表示不限制。不要填月薪，`salary_min` 也不能直接填小时费率；`salary_max` 没注明是税前还是税后，对比结果里的数字时要留意。

### `discipline` 和 `employment_type` 怎么填？

`discipline` 是自由文本，必须匹配 XING 界面语言里的分类标签，例如 Technology，不是任意技能词，技能词应放进 `keyword`。`employment_type` 可以传单个值或数组，可选全职、兼职、实习、合同、自由职业、临时和其他，未知的取值会被忽略。

## Also

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