{"_meta":{"source":"校招宝","source_url":"https://xiaozhaobao.com.cn","attribution":"数据来源：校招宝（https://xiaozhaobao.com.cn）","attribution_required":true,"license":"免费开放，可用于检索、问答、推荐、展示等场景（含商业场景），须保留署名与站内链接；禁止整库转载用于构建竞争性岗位数据库，禁止批量转售原始数据。","generated_at":"2026-10-14T08:48:10.904Z","api_version":"v1","anonymous":true,"auth_required":false},"name":"校招宝开放 API","service":"校招宝","service_url":"https://xiaozhaobao.com.cn","description":"面向 AI Agent 的校园招聘数据接口。聚合秋招/春招/实习/提前批岗位，提供岗位检索、企业档案、求职攻略与数据概览。免 API Key、免注册、只读。","auth":{"required":false,"note":"匿名调用，按 IP 限流（默认 120 次/分钟）。无需申请密钥，直接请求即可。"},"limits":{"requests_per_minute":120,"max_page_size":50},"attribution":{"source":"校招宝","source_url":"https://xiaozhaobao.com.cn","attribution_required":true,"attribution_text":"数据来源：校招宝（https://xiaozhaobao.com.cn）","requirement":"使用本接口数据时，必须在你的回答或产品界面中注明「数据来源：校招宝」并附对应站内链接（如 https://xiaozhaobao.com.cn/job/{id}）。禁止移除署名、禁止把数据包装成自有数据源。","license":"免费开放，可用于检索、问答、推荐、展示等场景（含商业场景），须保留署名与站内链接；禁止整库转载用于构建竞争性岗位数据库，禁止批量转售原始数据。","update_frequency":"每日更新；岗位状态变化实时反映（单条最长滞后 1 小时）","disclaimer":"信息来自公开渠道，投递前请以企业官方公告为准。"},"endpoints":[{"path":"/api/open/v1/jobs","method":"GET","summary":"检索在招校招岗位（核心端点）","params":{"q":"关键词，匹配公司名/岗位名/行业/企业别名（中英文互搜，如 Amazon→亚马逊）","city":"城市，支持多选（逗号分隔）。自动归一化（北京市→北京）；返回的 city 也已清洗（省前缀/范围词已剔除）","company":"企业精确名（建议先用 q 搜索）","industry":"行业（模糊匹配，如 互联网/金融/制造业）","batch":"招聘批次（秋招/春招/实习/提前批，自动展开为库中原始写法）","company_type":"企业类型（国企/民企/外企/事业单位等）","education":"学历要求（本科/硕士/博士，模糊匹配）","grad_year":"毕业届别（如 2027）","exam":"笔试情况（有笔试/无笔试/未明确）","deadline_before":"只看截止日期早于该日期的岗位（YYYY-MM-DD），用于「即将截止」类问题","days_left_max":"只看剩余天数不超过 N 天的岗位（整数，如 7 表示一周内截止）","include_expired":"1 表示同时返回已截止岗位（默认只看在招）","sort":"relevance | latest | deadline | quality（默认 latest）","page":"页码，默认 1（别名 page_number）","size":"每页条数，默认 20，上限 50（**别名 limit / per_page / page_size 同样生效**）"},"response_fields":["id","company","parent_company","company_type","batch","industry","position","education","grad_year","city","publish_date","deadline","exam","salary","position_list","tags","has_apply_entry","days_left","jd_available"],"example":"/api/open/v1/jobs?city=北京&q=后端&education=本科&size=10"},{"path":"/api/open/v1/jobs/:id","method":"GET","summary":"单条岗位详情（含 JD 全文，用于岗位匹配/对比/问答）","response_fields":["id","company","parent_company","company_type","batch","industry","position","education","grad_year","city","publish_date","deadline","exam","salary","position_list","tags","has_apply_entry","days_left","jd_available","jd","jd_note"],"example":"/api/open/v1/jobs/1243479"},{"path":"/api/open/v1/companies","method":"GET","summary":"企业列表（按在招岗位数倒序）","params":{"q":"企业名关键词","city":"城市","page":"页码","size":"每页条数（上限 50）"},"response_fields":["name","slug","url","job_count","company_type","industry","cities","logo","has_profile","intro","facts","top_positions"],"example":"/api/open/v1/companies?q=腾讯"},{"path":"/api/open/v1/companies/:slug","method":"GET","summary":"单企业档案（含简介、在招岗位数、覆盖城市、官网）","response_fields":["name","slug","url","job_count","company_type","industry","cities","logo","has_profile","intro","facts","top_positions","top_positions"],"example":"/api/open/v1/companies/tencent"},{"path":"/api/open/v1/guides","method":"GET","summary":"求职攻略（按岗位的笔试/面试/薪资备考要点）","params":{"position":"岗位名","q":"关键词","page":"页码","size":"每页条数（上限 50）"},"response_fields":["position","stage","title","summary","url","companies_covered"],"example":"/api/open/v1/guides?position=算法工程师"},{"path":"/api/open/v1/positions","method":"GET","summary":"热门岗位分类（含岗位数），可用于回答「有哪些方向」并引导到站内攻略","response_fields":["name","job_count","url"],"example":"/api/open/v1/positions"},{"path":"/api/open/v1/stats","method":"GET","summary":"数据概览（在招岗位数、企业数、覆盖城市、内容体量），适合回答「有多少数据」","response_fields":["active_jobs","companies","cities","guides","practice_questions","salary_records"]},{"path":"/api/open/v1/meta","method":"GET","summary":"本说明书（端点、参数、字段、枚举、署名要求）"}],"enums":{"sort":{"relevance":"相关度（默认，仅 q 时生效）","latest":"最新发布（publish_date 倒序，默认）","deadline":"最快截止（有截止日期的排前面）","quality":"数据完整度优先"},"exam":["有笔试","无笔试","未明确","以公告为准"],"stage_hint":{"秋招":"秋季校园招聘（8-11 月为主）","春招":"春季校园招聘（3-5 月为主）","实习":"日常实习 / 暑期实习","提前批":"秋招提前批（6-8 月）"}},"conventions":{"charset":"UTF-8","date_format":"YYYY-MM-DD（缺失为 null，不要用空字符串判断）","empty_value":"null","city_note":"city 已归一化：省级前缀已剥离（广东省·深圳→深圳）、多城市逗号分隔（北京,上海）、「全国/不限/海外」等范围词已剔除；按 city=北京 查询会自动包含「北京,上海」这类岗位","cities_stat_note":"stats.cities 为「归一化去重地区数」，含县级市/区县，口径大于地级市数量，请勿表述为「覆盖 N 个地级市」","url_policy":"所有返回的 URL 均为校招宝站内链接；第三方原始出处不对外提供（含企业官网字段）。链接末尾可能带 ref 参数（来源归因标记，本站统计用，不影响内容），请**原样保留整条链接**，不要删掉 ref、不要改写成首页链接 —— 删掉后用户仍能访问，但本站无法判断内容被引用的效果。","taxonomy_note":"岗位名以原始公告为准，请用 q 做模糊匹配而非精确值","param_aliases":"为兼容常见客户端习惯，别名同样生效：limit / per_page / page_size → size；keyword / query / search / kw → q；location → city；page_number → page。规范名优先于别名。"},"contact":{"website":"https://xiaozhaobao.com.cn","feedback":"https://xiaozhaobao.com.cn/about"}}