| action | 必填参数 | 可选参数 | 单次条数 | 模式 | 单价 | 返回字段 |
|---|---|---|---|---|---|---|
| search | keyword | — | 默认 50 · 最多 200 | 同步 | $1.39 / 千次 | id · url · title · company_name · location · experience · salary · currency · text · posted_at · platform |
| company_jobs | url | date_range, sort | 默认 20 · 最多 100 | 同步 | $1.39 / 千次 | id · url · title · company_name · company_url · location · experience · salary · currency · employment_type · work_mode · job_role · industry · functional_area · vacancy · apply_count · view_count · skills · text · posted_at · platform |
下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。
下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。
search使用 platform="naukri"、action="search" 调用“关键词搜索”能力；返回列表，默认 50 条、单次最多 200 条，主要包含 id、url、title、company_name、location、experience 等 11 个字段。
keyword必填Naukri 将按技能、职位名称或公司名称发现岗位，与之后的申请、补充问卷和公司站点跳转分开。本接口只读取岗位；官网提供的地点、薪资等筛选不会自动成为这里的公开参数。官方来源：Naukri：岗位搜索与申请流程不同来源核查：
company_jobs使用 platform="naukri"、action="company_jobs" 调用“公司职位”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、title、company_name、company_url、location 等 21 个字段。
url必填Naukri 说明部分职位需要转到公司网站申请，是否回复由雇主决定。读取公司岗位和 apply_count 不等于已经投递、获邀面试或取得申请状态。官方来源：Naukri：公司招聘页与实际投递入口来源核查：
date_range可选any_timelast_24_hourslast_30_dayslast_7_dayslast_90_days
sort可选newestrelevance
Naukri 原始字段名
EveryInfra 统一字段名
左边是 Naukri 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。
全站 89 个平台的当前目录中，这 5 个字段名只在 Naukri 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。
通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields
这里检索招聘职位；company_jobs 的公司标识不能用职位词代替。
以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer omg_你的KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"naukri","action":"search","params":{"keyword":"python developer"}}'
仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。
{ "id": null, "url": null, "title": null, "company_name": null, "location": null, "experience": null, "salary": null, "currency": null, "text": null, "posted_at": null, "platform": null }
以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。
按职位或技能词获取岗位列表，再回原始招聘页核对要求。
查看 search 的 keyword 参数 →用 company_jobs 与普通技能搜索区分，保留岗位所属公司及发布时间。
查看 company_jobs 的 sort 参数 →调用 POST /api/v1/social，请求体传 platform="naukri"、action 和 params。以 search 为例，必填 keyword，没有可选参数。这里检索招聘职位；company_jobs 的公司标识不能用职位词代替。 Naukri 共 2 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。
$1.39 / 千次，Naukri 全部 2 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Naukri 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。
Naukri 有 2 个列表接口，包括 search、company_jobs。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。
当前目录为 search 列出 id、url、title、company_name、location、experience 等 11 个字段名。按全站当前目录统计，5 个字段名只在 Naukri 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。
按职位或技能词获取岗位列表，再回原始招聘页核对要求。 keyword 填 Python developer 等职位词；普通 search 当前按相关性查找，没有开放 company_jobs 的 date_range / sort，也没有地点或薪资筛选参数。text 可能只是摘要，不保证完整职位描述。 salary / currency 应一起读取，薪资文字可能包含区间与计价周期，不能默认美元或月薪；experience 是经验要求，不是候选人的实际履历。posted_at 可能来自相对时间文字，跨时区或历史统计前需复核。 id / url 定位招聘条目，返回列表不证明职位仍开放；本接口不投递简历、不访问候选人库，也不提供录用保证。
用 company_jobs 与普通技能搜索区分，保留岗位所属公司及发布时间。 url 使用 Naukri 或 Naukrigulf 公司职位页；没有 tab 参数时追加 tab=jobs，已有其他 tab 不会自动修正。sort 使用 newest / relevance，date_range 是职位发布时间窗，不是公司成立时间。 vacancy、apply_count 与 view_count 分别描述计划空缺、投递和浏览计数，不是实际录用数或独立求职者数。skills 会合并不同技能组，不保留必需与其他技能的完整层级；text 最多整理 2,000 字符，不能称完整职位正文。 company_url 用于核对职位归属，但兼容站点相对路径的域名归一化仍待验证；即使引用官方投递流程，此接口也不具备申请、问卷或状态跟踪能力。
可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Naukri 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 2 个能力。无需信用卡。