如果想在 V2EX 获得更好的推广效果，欢迎了解 PRO 会员机制：
https://www.v2ex.com/pro/about

如果你经常使用铜币置顶主题，持有 V2EX Solana Token 会在每日签到时获得额外铜币：
https://www.v2ex.com/solana

全国公职与国企招录岗位数据 API 接口

接口详情官网地址: https://www.gugudata.com/api/details/recruitmentpositions

全国公职与国企招录岗位数据 API 提供公务员、事业单位、军队文职、三支一扶和国有单位的岗位及招录条件查询，支持按类别、年度、地区、单位代码、岗位代码和资格条件关键词筛选。覆盖范围和资料完整度会因年份、地区和招录类别而异，报考前请以招录公告为准。

gugudata_api_cover

1. 产品功能

查询公务员、事业单位、军队文职、三支一扶及国有单位招录岗位；
支持按招录类别、年度和省市区县组合筛选；
支持按单位代码、岗位代码精确检索；
支持按单位、岗位、专业和学历要求关键词检索；
返回岗位名称、职责、计划招录人数和工作地点；
返回学历、学位、专业、政治面貌、经历及其他资格条件；
返回类别扩展字段，如公务员机构属性、事业单位考试要求或国企招聘渠道；
支持分页和匹配总数，适合岗位检索、条件对照和就业服务；

2. API 文档

接口地址: https://api.gugudata.com/employment/recruitment-positions

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/employment/recruitment-positions?category=public_institution&year=2026&province=%E5%B9%BF%E4%B8%9C&city=&district=&organizationCode=&positionCode=&organizationKeyword=&positionKeyword=&majorKeyword=&educationKeyword=&pageIndex=1&pageSize=10&appkey=YOUR_APPKEY

数据预览: https://www.gugudata.com/preview/recruitmentpositions

接口测试: https://api.gugudata.com/employment/recruitment-positions/demo

3. 请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	否	YOUR_APPKEY	支持 Query 参数，也支持 X-GUGUDATA-APPKEY 、X-API-Key 或 Authorization: Bearer 请求头；缺失或无效返回 504 。请仅在服务端安全保存。
category	string	否	all	类别大小写不敏感；支持 civil_service （公务员）、public_institution （事业单位）、military_civilian （军队文职）、three_support （三支一扶）、state_owned_enterprise （国有单位）。未传或空值为 all 。
year	integer	否	0	年份； 0 表示不限年份，其他值须为 2000 至北京时间当前年份加一的整数。
province	string	否		省级地区名称精确匹配；最长 50 个字符；空值不筛选。
city	string	否		城市名称精确匹配；最长 50 个字符；空值不筛选。
district	string	否		区县名称精确匹配；最长 50 个字符；空值不筛选。
organizationCode	string	否		单位代码精确匹配，按字符串保留前导零；最长 50 个字符。
positionCode	string	否		岗位代码精确匹配，按字符串保留前导零；最长 50 个字符。
organizationKeyword	string	否		单位或部门名称包含匹配；最长 100 个字符。
positionKeyword	string	否		岗位名称或职责包含匹配；最长 100 个字符。
majorKeyword	string	否		专业要求文字包含匹配，不等于报考资格判定；最长 100 个字符。
educationKeyword	string	否		学历要求文字包含匹配；最长 100 个字符。
pageIndex	integer	否	1	正 Int32 页码，从 1 开始；合法超范围页返回空数组和正确总数。
pageSize	integer	否	20	每页 1 ～ 100 条。

4. 返回参数

参数名	参数类型	备注
DataStatus.RequestParameter	string	正式请求展示筛选长度、类别、年份和分页摘要；不包含 APPKEY 。
DataStatus.StatusCode	integer	业务状态码，100 表示正常返回。
DataStatus.StatusDescription	string	业务状态说明。
DataStatus.ResponseDateTime	string	接口响应时间，不代表岗位公开发布时间。
DataStatus.DataTotalCount	integer	筛选后的全部匹配数量；失败时为 0 。
Data.PositionId	string	平台提供的岗位稳定唯一标识，可用于本地幂等更新；不同于公开材料中的 PositionCode 。
Data.Category	string	标准招录类型代码。
Data.CategoryName	string	招录类型中文名称。
Data.RecruitmentYear	integer	招聘年度。
Data.Province	string\|null	省级地区；无公开数据时为 null 。
Data.City	string\|null	城市；无公开数据时为 null 。
Data.District	string\|null	区县；无公开数据时为 null 。
Data.OrganizationName	string\|null	招录单位名称。
Data.DepartmentName	string\|null	部门或用人司局名称。
Data.OrganizationCode	string\|null	公开材料中的单位代码。
Data.PositionCode	string\|null	公开材料中的岗位代码。
Data.PositionName	string\|null	岗位名称。
Data.PositionDescription	string\|null	岗位职责或工作内容。
Data.PositionCategory	string\|null	岗位类别。
Data.PlannedHires	integer	计划招录人数；未披露或无法识别时为 0 。
Data.EducationRequirement	string\|null	学历要求。
Data.DegreeRequirement	string\|null	学位要求。
Data.MajorRequirement	string\|null	公开材料中的专业要求原始描述。
Data.MajorRequirements	array	从专业要求中整理出的专业代码、名称与要求明细；无可识别明细时为空数组。
Data.MajorRequirements[].MajorCode	string\|null	专业代码。
Data.MajorRequirements[].MajorName	string\|null	专业名称。
Data.MajorRequirements[].Requirement	string\|null	对应专业要求说明。
Data.PoliticalRequirement	string\|null	政治面貌要求。
Data.ExperienceRequirement	string\|null	基层或相关工作经历要求。
Data.GraduateRequirement	string\|null	应届生或毕业时间要求。
Data.AgeRequirement	string\|null	年龄要求。
Data.GenderRequirement	string\|null	性别要求。
Data.HouseholdRequirement	string\|null	户籍或生源地要求。
Data.QualificationRequirement	string\|null	资格证书、职称或其他资质要求。
Data.OtherRequirement	string\|null	其他资格条件。
Data.WorkLocation	string\|null	工作地点。
Data.SettlementLocation	string\|null	落户地点。
Data.ExamCategory	string\|null	考试类别或笔试科目类别。
Data.InterviewRatio	string\|null	进入面试比例。
Data.ApplicationDeadline	string\|null	公开材料中的报名截止时间；未单独披露时为 null 。
Data.PublishedAt	string\|null	来源公开发布时间；未提供或无法识别时为 null 。
Data.DataUpdatedAt	string\|null	平台数据更新时间，不等同于 PublishedAt 。
Data.CategoryDetails	object\|null	按 Category 返回的扩展字段；不适用或未披露时为 null 。
Data.CategoryDetails.InstitutionNature	string\|null	公务员岗位的机构性质。
Data.CategoryDetails.InstitutionLevel	string\|null	公务员岗位的机构层级。
Data.CategoryDetails.PositionDistribution	string\|null	公务员岗位分布或职位属性。
Data.CategoryDetails.ProfessionalTestRequired	string\|null	公务员岗位是否组织专业能力测试。
Data.CategoryDetails.DualDegreeAccepted	string\|null	公务员岗位是否接受双学位。
Data.CategoryDetails.PsychologicalAssessment	string\|null	公务员岗位心理测评说明。
Data.CategoryDetails.SupervisorCode	string\|null	事业单位主管部门代码。
Data.CategoryDetails.SupervisorName	string\|null	事业单位主管部门名称。
Data.CategoryDetails.PositionGrade	string\|null	事业单位岗位等级。
Data.CategoryDetails.WrittenExamRequired	string\|null	事业单位岗位是否需要笔试。
Data.CategoryDetails.InterviewRequired	string\|null	事业单位岗位是否需要面试。
Data.CategoryDetails.ExamCategoryMinor	string\|null	事业单位考试细分类别。
Data.CategoryDetails.EmployerSerial	string\|null	军队文职用人单位序号。
Data.CategoryDetails.SourceCategory	string\|null	军队文职岗位来源类别。
Data.CategoryDetails.ExamSubject	string\|null	军队文职专业科目。
Data.CategoryDetails.ContactPhone	string\|null	军队文职公开咨询电话。
Data.CategoryDetails.ServiceType	string\|null	三支一扶服务类型，如支教、支农、支医或帮扶乡村振兴。
Data.CategoryDetails.Township	string\|null	三支一扶服务乡镇。
Data.CategoryDetails.TeacherCertificateRequirement	string\|null	三支一扶教师资格证要求。
Data.CategoryDetails.PhysicianCertificateRequirement	string\|null	三支一扶医师资格要求。
Data.CategoryDetails.EnterpriseGroup	string\|null	国有单位所属企业集团。
Data.CategoryDetails.Subsidiary	string\|null	国有单位所属子公司。
Data.CategoryDetails.RecruitmentChannel	string\|null	国有单位招聘渠道。
Data.CategoryDetails.EmploymentType	string\|null	国有单位招聘或用工类型。
Data.CategoryDetails.Compensation	string\|null	国有单位公开薪酬说明。

5. 错误码说明

状态码	错误说明	备注
100	正常返回	HTTP 200 ；无数据时 Data 为空数组。
501	参数或凭证冲突	HTTP 400 ；请检查筛选条件、分页参数与凭证传递方式。
502	请求频率受限	HTTP 429 ；默认按来源 IP 限速，单 IP 最多 5 QPS 。
503	订单到期	HTTP 403 ；请检查接口订单状态。
504	APPKEY 缺失或无效	HTTP 401 ；请检查 APPKEY 及接口权限。
505	额度耗尽	HTTP 403 ；请检查接口剩余请求次数与配额。
900	内部错误	HTTP 500 ；请稍后重试。
901	招录数据服务暂不可用	HTTP 503 ；请稍后重试。

6. 适用场景

适合用于就业服务与岗位检索页面，按招录类别、地区和资格条件筛选岗位。
适合用于报考条件对照，展示学历、专业、年龄、经历及资格证书等公开要求。
适合用于岗位资料归集，以 PositionId 维护本地增量同步和幂等去重。
适合用于招录数据看板，按地区、类别和年度统计公开岗位信息。
接口字段来自公开材料，不构成报名资格或录用结果判断；报考前请核对原始招录公告。

7. 相关接口

可搭配使用：全国高校基础信息，用于补充高校院校资料。
可搭配使用：全国高校专业数据，用于辅助整理专业名称与专业目录信息。
可搭配使用：职业测评，用于职业兴趣与能力测评场景；测评结果不能替代岗位资格审核。

No Comments Yet

招录岗位数据