接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
24 小时趋势
30 天趋势
职位详情:返回单个对象;主要字段 id、url、title、company、company_url、location。
请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 xing,action 填 job_detail。 单价 $1.39 / 千次(每次 $0.001389),失败和空结果都不收费。 同步返回;慢任务可在请求体加 "mode": "async",先拿 job_id 再轮询。
XING 职位详情按职位链接 url 读一条职位:职位名称、公司和公司主页、地点、薪酬区间和中位数、雇佣类型、职业层级、专业领域、行业、远程选项、公司规模、投递链接、有效期,以及 kununu_rating 雇主评分。它回答「这个岗位具体是什么条件、给多少钱、在哪里投」,适合德语区招聘市场的研究和岗位库补全。
url 要用 /jobs/ 开头的职位链接;/profile/ 开头的是会员档案链接,两种对象不可混用。职位搜索返回的字段和这里相同,所以已经有职位链接时直接读这一页,不必再去搜索。还没有链接、想按关键词找岗位时,用职位搜索。
AI 提示词
#请帮我用 EveryInfra 的「Xing 职位详情」接口(xing/job_detail)写一个数据采集脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 xing,action 填 job_detail,参数放在 params 里。
- 必填参数:
- url:job_detail 使用 /jobs/ 职位链接,profile 使用 /profile/ 会员档案链接;两种对象不可混用。
- 返回一个对象,主要字段:id、url、title、company(公司名称)、company_url(公司主页链接)、location、country、salary_min(薪酬区间下限)、salary_max(薪酬区间上限)、salary_median(薪酬中位数)、salary_currency(薪酬币种)、employment_type(雇佣类型(全职/兼职/合同工));一共 24 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=xing。
- 示例请求体:
{
"platform": "xing",
"action": "job_detail",
"params": {
"url": "https://www.xing.com/pages/sap"
}
}
- 计费:$1.39 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | xing | 平台标识,固定值。 |
action | body | string | 是 | job_detail | 能力标识,固定值。 |
url | body.params | string | 是 | - | job_detail 使用 /jobs/ 职位链接,profile 使用 /profile/ 会员档案链接;两种对象不可混用。 |
代码示例
#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": "job_detail",
"params": {
"url": "https://www.xing.com/pages/sap"
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
响应示例
#{ "id": "req_…", "platform": "xing", "action": "job_detail", "results": { "id": "30276.2e5e9c", "url": "https://www.xing.com/pages/sap", "industry": "Software", "description": "Als weltweit führender Anbieter von Anwendungen und KI für Unternehmen sitzt SAP an der Schnittstelle zwischen Wirtschaft und Technologie. Seit über 50 Jahren vertrauen Unternehmen darauf, dass SAP sie durch die Zusammenführung geschäftskritischer Abläufe in Finanzwesen, Beschaff…", "platform": "xing" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
返回字段
#业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
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)。 |
常见问题
#url 填职位链接还是会员档案链接?
#填 /jobs/ 开头的职位链接。/profile/ 开头的会员档案链接不能用在这里,两种对象不可混用;想找职位,先走职位搜索,从结果里取每条的 url。
薪酬数字怎么读?
#salary_min、salary_max 和 salary_median 是区间下限、上限和中位数,对比数字之前先看 salary_currency,德语区岗位多为 EUR;salary_median 是中位数,不是平均数。币种不同的岗位,数字不要直接比较。
kununu_rating 是什么评分?
#kununu 是 XING 旗下的雇主点评站,kununu_rating 是这家雇主在 kununu 上的评分,相当于德语区的 Glassdoor。它评价的是雇主,不是这条职位本身。
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。