# 全国公职与国企招录岗位数据
> 来源页面: https://www.gugudata.com/api/details/recruitmentpositions
## 概览
- API 标识: `recruitmentpositions`
- 分类: 教育/高考
- 描述: 公职国企岗位与招录条件查询
- 标签: 公职招录 / 国企招聘 / 岗位检索
- 短标签: 基础数据 / 招录岗位 / 就业数据
- 详情页: https://www.gugudata.com/api/details/recruitmentpositions
- LLM Markdown: https://www.gugudata.com/api/details/recruitmentpositions/llm.md
- 数据预览: https://www.gugudata.com/preview/recruitmentpositions
- 购买开通: https://www.gugudata.com/order/recruitmentpositions
- APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders
## 给大模型的接入指令
如果你正在帮助用户接入这个 API，请优先使用本文档中的接口地址、请求方式、请求参数、返回参数、状态码、cURL 示例和预览数据生成代码或排查问题。
- 接入目标: 调用 `全国公职与国企招录岗位数据`，不要臆造未在文档中出现的参数或返回字段。
- AppKey 获取: 用户登录咕咕数据开发者中心后，在 `APP KEY 管理` 页面复制对应产品的 AppKey。
- AppKey 替换: 示例中的 `YOUR_APPKEY`、`APPKEY`、`{{YOUR_APPKEY}}`、`{{appkey}}`、`{{appKey}}` 都应替换为用户自己的 AppKey。
- AppKey 传递: 推荐使用 `X-GUGUDATA-APPKEY` 或 `X-API-Key` 请求头；OpenAI 兼容客户端可使用 `Authorization: Bearer <AppKey>`；历史 query 参数 `appkey` 继续有效。
- 开通与续费: 未开通时引导用户访问购买开通页；已开通或需要续费时，引导用户进入开发者中心或订单与续费页。
- 错误处理: HTTP 状态码代表传输层结果，响应体内的业务状态码代表接口业务结果，代码中应分别处理。
- 生产建议: AppKey 应保存在服务端环境变量或密钥配置中，由服务端统一发起请求，不要写入网页、App 客户端或公开仓库。
关键链接:
- 接口详情页: https://www.gugudata.com/api/details/recruitmentpositions
- LLM Markdown: https://www.gugudata.com/api/details/recruitmentpositions/llm.md
- 数据预览: https://www.gugudata.com/preview/recruitmentpositions
- 购买开通页: https://www.gugudata.com/order/recruitmentpositions
- 开发者中心 APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders
## API 功能
- 查询公务员、事业单位、军队文职、三支一扶及国企招录岗位；
- 支持按招录类别、年度和地区组合筛选；
- 可按单位代码、岗位代码精确检索；
- 支持单位、岗位、专业和学历关键词查询；
- 返回岗位名称、职责及计划招录人数；
- 展示学历、学位、专业和其他资格条件；
- 提供可获取的工作地点、报名截止时间等资料；
- 返回专业要求明细及不同招录类别的补充信息；
- 支持分页与匹配总数，适合岗位检索、条件对照和就业服务；
- 覆盖及资料完整度因年份、地区和类别而异，报考前请核对招录公告；
- 默认最大 QPS:5，可在开发者中心自助升级，年付订单接口调用次数不限。
- [接口调用状态与状态监控](https://www.gugudata.com/status)
## 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=`
- 接口测试: https://api.gugudata.com/employment/recruitment-positions/demo
- Apifox: https://doc.gugudata.com/
- Postman: https://www.postman.com/gugudata/gugudata-official/collection/1163860-22cb92f5-771a-48fd-89c0-f20a0790a8ce/?action=share&creator=1163860&active-environment=1163860-a95b31ef-324f-43db-b2fc-faa41f45bd35
- OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
## 鉴权方式
接口支持以下 AppKey 传递方式，任选一种即可；已有请求示例、Postman 集合和历史代码仍可继续使用原来的 `appkey` 参数方式。
| 传输载体 | 参数 | 示例 | 说明 |
| --- | --- | --- | --- |
| HTTP Header | `X-GUGUDATA-APPKEY` | `X-GUGUDATA-APPKEY: YOUR_APPKEY` | 推荐方式，适合服务端接入和统一封装。 |
| HTTP Header | `X-API-Key` | `X-API-Key: YOUR_APPKEY` | 通用 API Key Header，便于和常见 API 客户端集成。 |
| HTTP Header | `Authorization` | `Authorization: Bearer YOUR_APPKEY` | 适合 OpenAI 兼容接口或 Bearer Token 风格客户端。 |
| Query 参数 | `appkey` | `?appkey=YOUR_APPKEY` | 兼容现有示例、Postman 集合、浏览器调试和历史代码。 |
> 部分历史 POST 接口仍兼容表单或 JSON body 中的 `appkey`；新接入建议优先使用 Header 或 Query 参数。
## 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
| --- | --- | --- | --- | --- |
| appkey | string | 否 | | 支持 Query、AppKey/X-GUGUDATA-APPKEY/X-API-Key Header 和 Bearer；同值可共存，冲突返回 501，缺失或无效返回 504。 |
| category | string | 否 | all | 类别大小写不敏感；未传或空值为 all。civil_service 公务员、public_institution 事业单位、military_civilian 军队文职、three_support 三支一扶、state_owned_enterprise 国有单位。未知类别返回 501。 |
| year | integer | 否 | 0 | 默认 0 表示不限年份；其他值须为 2000 至北京时间当前年份加一的整数，动态上限由请求时的年份确定。显式空值或非法值返回 501。 |
| province | string | 否 | | 地区名称精确匹配；空值不筛选，不自动扩展全国岗位归属。NFKC 和首尾空白处理，最长 50 字符。 |
| city | string | 否 | | 地区名称精确匹配；空值不筛选，不自动扩展全国岗位归属。NFKC 和首尾空白处理，最长 50 字符。 |
| district | string | 否 | | 地区名称精确匹配；空值不筛选，不自动扩展全国岗位归属。NFKC 和首尾空白处理，最长 50 字符。 |
| organizationCode | string | 否 | | 代码精确匹配，作为字符串保留前导零；空值不筛选。NFKC 和首尾空白处理，最长 50 字符。 |
| positionCode | string | 否 | | 代码精确匹配，作为字符串保留前导零；空值不筛选。NFKC 和首尾空白处理，最长 50 字符。 |
| organizationKeyword | string | 否 | | 单位或部门名称包含匹配；NFKC 和首尾空白处理，最长 100 字符，空值不筛选。 |
| positionKeyword | string | 否 | | 岗位名称或职责包含匹配；NFKC 和首尾空白处理，最长 100 字符，空值不筛选。 |
| majorKeyword | string | 否 | | 专业要求文字包含匹配，不等于报考资格判定；NFKC 和首尾空白处理，最长 100 字符，空值不筛选。 |
| educationKeyword | string | 否 | | 学历要求文字包含匹配；NFKC 和首尾空白处理，最长 100 字符，空值不筛选。 |
| pageIndex | integer | 否 | 1 | 正 Int32 页码，默认 1；非法值或显式空值返回 501，合法超范围页返回空数组和正确总数。 |
| pageSize | integer | 否 | 20 | 每页 1～100，默认 20；非法值或显式空值返回 501。 |
## 返回参数
| 参数名 | 参数类型 | 备注 |
| --- | --- | --- |
| DataStatus.RequestParameter | string | 正式请求仅展示筛选长度、类别、年份和分页摘要；Demo 展示完整公开示例输入。 |
| DataStatus.StatusCode | integer | 业务状态码。 |
| 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，必要时可结合 SourceUrl 复核。 |
| 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 | 国有单位公开薪酬说明。 |
## 响应示例（真实数据节选）
```json
{
"DataStatus": {
"RequestParameter": "category=public_institution&year=2026&province=广东&city=&district=&organizationCode=&positionCode=&organizationKeyword=&positionKeyword=&majorKeyword=&educationKeyword=&pageIndex=1&pageSize=10",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-09-07 19:15:35.536",
"DataTotalCount": 9570
},
"Data": [
{
"PositionId": "31b3ceba3579c53f78241b99af07d64e3004d5293184a702ba4e0641c17c1d5f",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "黄埔海关技术中心",
"DepartmentName": "植物检疫实验室",
"OrganizationCode": "6210839",
"PositionCode": "2026005980056",
"PositionName": "植物检疫实验室",
"PositionDescription": "从事植物检疫工作。",
"PositionCategory": "专业技术岗位十一级至十三级",
"PlannedHires": 1,
"EducationRequirement": "硕士研究生",
"DegreeRequirement": "硕士",
"MajorRequirement": "植物学(A071001),植物病理学(A090401),农业昆虫与害虫防治(A090402)",
"MajorRequirements": [
{
"MajorCode": "A071001",
"MajorName": null,
"Requirement": "植物学(A071001),植物病理学(A090401),农业昆虫与害虫防治(A090402)"
},
{
"MajorCode": "A090401",
"MajorName": null,
"Requirement": "植物学(A071001),植物病理学(A090401),农业昆虫与害虫防治(A090402)"
},
{
"MajorCode": "A090402",
"MajorName": null,
"Requirement": "植物学(A071001),植物病理学(A090401),农业昆虫与害虫防治(A090402)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "应届毕业生",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": "1.大学英语六级考试合格（或425分）及以上； 2.色觉功能正常，不得为色盲或色弱。",
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.084",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
},
{
"PositionId": "3b312c165aa551461a2a080fb7d738338eeb74e7afcc0f3f85500dd0cf37790d",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "黄埔海关国际旅行卫生保健中心（黄埔海关口岸门诊部）",
"DepartmentName": "业务发展部",
"OrganizationCode": "6210839",
"PositionCode": "2026005980057",
"PositionName": "业务发展部",
"PositionDescription": "从事医学影像检查和诊断工作。",
"PositionCategory": "专业技术岗位十级及以上",
"PlannedHires": 1,
"EducationRequirement": "本科以上",
"DegreeRequirement": "学士以上",
"MajorRequirement": "临床医学(B100301),医学影像学(B100303)；影像医学与核医学(A100207),影像医学与核医学硕士（专业硕士）(A100225),超声医学（专业硕士）(A100243)",
"MajorRequirements": [
{
"MajorCode": "A100207",
"MajorName": null,
"Requirement": "临床医学(B100301),医学影像学(B100303)；影像医学与核医学(A100207),影像医学与核医学硕士（专业硕士）(A100225),超声医学（专业硕士）(A100243)"
},
{
"MajorCode": "A100225",
"MajorName": null,
"Requirement": "临床医学(B100301),医学影像学(B100303)；影像医学与核医学(A100207),影像医学与核医学硕士（专业硕士）(A100225),超声医学（专业硕士）(A100243)"
},
{
"MajorCode": "A100243",
"MajorName": null,
"Requirement": "临床医学(B100301),医学影像学(B100303)；影像医学与核医学(A100207),影像医学与核医学硕士（专业硕士）(A100225),超声医学（专业硕士）(A100243)"
},
{
"MajorCode": "B100301",
"MajorName": null,
"Requirement": "临床医学(B100301),医学影像学(B100303)；影像医学与核医学(A100207),影像医学与核医学硕士（专业硕士）(A100225),超声医学（专业硕士）(A100243)"
},
{
"MajorCode": "B100303",
"MajorName": null,
"Requirement": "临床医学(B100301),医学影像学(B100303)；影像医学与核医学(A100207),影像医学与核医学硕士（专业硕士）(A100225),超声医学（专业硕士）(A100243)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": "2年以上相关工作经历",
"GraduateRequirement": "不限",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": "中级以上；卫生技术人员；医师",
"OtherRequirement": "1.具有超声波医学专业技术资格，医师执业范围为医学影像和放射治疗； 2.具有2年二级及以上医院超声工作经历； 3.大学英语四级考试合格（或425分）及以上。",
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.084",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
},
{
"PositionId": "5f03a476a69e96455b6f029440ed2a7f7141b8d43ac639c1c2349d98cf81d18d",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "黄埔海关后勤管理中心",
"DepartmentName": "财务部",
"OrganizationCode": "6210839",
"PositionCode": "2026005980058",
"PositionName": "财务部",
"PositionDescription": "从事会计、财务、预决算管理工作。",
"PositionCategory": "专业技术岗位十三级及以上",
"PlannedHires": 1,
"EducationRequirement": "本科以上",
"DegreeRequirement": "学士以上",
"MajorRequirement": "会计学(B120203),财务管理(B120204)；会计学(A120201),会计硕士（专业硕士）(A120206)",
"MajorRequirements": [
{
"MajorCode": "A120201",
"MajorName": null,
"Requirement": "会计学(B120203),财务管理(B120204)；会计学(A120201),会计硕士（专业硕士）(A120206)"
},
{
"MajorCode": "A120206",
"MajorName": null,
"Requirement": "会计学(B120203),财务管理(B120204)；会计学(A120201),会计硕士（专业硕士）(A120206)"
},
{
"MajorCode": "B120203",
"MajorName": null,
"Requirement": "会计学(B120203),财务管理(B120204)；会计学(A120201),会计硕士（专业硕士）(A120206)"
},
{
"MajorCode": "B120204",
"MajorName": null,
"Requirement": "会计学(B120203),财务管理(B120204)；会计学(A120201),会计硕士（专业硕士）(A120206)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": "2年以上相关工作经历",
"GraduateRequirement": "不限",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": "初级以上；会计人员",
"OtherRequirement": null,
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.084",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
},
{
"PositionId": "23460a6cfca390f701f2ae2d6c20b277d75b29f629739699504dc9dc72ad1618",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "国家税务总局深圳市税务局信息中心",
"DepartmentName": "业务部门",
"OrganizationCode": "6210730",
"PositionCode": "2026005980050",
"PositionName": "业务部门",
"PositionDescription": "从事信息化运营等有关工作。",
"PositionCategory": "管理岗位九级以上",
"PlannedHires": 3,
"EducationRequirement": "本科以上",
"DegreeRequirement": "学士以上",
"MajorRequirement": "计算机类(B0809)；计算机科学与技术(A0812),软件工程(A0835),网络空间安全(A0839)",
"MajorRequirements": [
{
"MajorCode": "A0812",
"MajorName": null,
"Requirement": "计算机类(B0809)；计算机科学与技术(A0812),软件工程(A0835),网络空间安全(A0839)"
},
{
"MajorCode": "A0835",
"MajorName": null,
"Requirement": "计算机类(B0809)；计算机科学与技术(A0812),软件工程(A0835),网络空间安全(A0839)"
},
{
"MajorCode": "A0839",
"MajorName": null,
"Requirement": "计算机类(B0809)；计算机科学与技术(A0812),软件工程(A0835),网络空间安全(A0839)"
},
{
"MajorCode": "B0809",
"MajorName": null,
"Requirement": "计算机类(B0809)；计算机科学与技术(A0812),软件工程(A0835),网络空间安全(A0839)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "应届毕业生",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": null,
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.083",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
},
{
"PositionId": "52db70c8cbef09249942e4feb8f0df1768b73ee06b8c3e34e075709ddfd4285a",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "国家税务总局深圳市税务局信息中心",
"DepartmentName": "业务部门",
"OrganizationCode": "6210730",
"PositionCode": "2026005980051",
"PositionName": "业务部门",
"PositionDescription": "从事信息化运营等有关工作。",
"PositionCategory": "管理岗位九级以上",
"PlannedHires": 2,
"EducationRequirement": "硕士研究生",
"DegreeRequirement": "硕士",
"MajorRequirement": "计算机科学与技术(A0812),软件工程(A0835),网络空间安全(A0839)",
"MajorRequirements": [
{
"MajorCode": "A0812",
"MajorName": null,
"Requirement": "计算机科学与技术(A0812),软件工程(A0835),网络空间安全(A0839)"
},
{
"MajorCode": "A0835",
"MajorName": null,
"Requirement": "计算机科学与技术(A0812),软件工程(A0835),网络空间安全(A0839)"
},
{
"MajorCode": "A0839",
"MajorName": null,
"Requirement": "计算机科学与技术(A0812),软件工程(A0835),网络空间安全(A0839)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "不限",
"AgeRequirement": "放宽到40周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": "至少具有信息系统项目管理师、系统分析师、系统架构设计师、系统规划与管理师、软件设计师、系统集成项目管理工程师、数据库系统工程师、网络规划设计师中的一项资质。",
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.083",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
},
{
"PositionId": "58c1ca355cf6c772c9f4fb253b54e3c47a4a81b8d3fffd1b5d460ba28fe2d617",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "黄埔海关技术中心",
"DepartmentName": "食品化妆品实验室",
"OrganizationCode": "6210839",
"PositionCode": "2026005980055",
"PositionName": "食品化妆品实验室",
"PositionDescription": "从事检验检测、标准研究和科研等工作。",
"PositionCategory": "专业技术岗位十一级至十三级",
"PlannedHires": 2,
"EducationRequirement": "硕士研究生",
"DegreeRequirement": "硕士",
"MajorRequirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)",
"MajorRequirements": [
{
"MajorCode": "A070301",
"MajorName": null,
"Requirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)"
},
{
"MajorCode": "A070302",
"MajorName": null,
"Requirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)"
},
{
"MajorCode": "A070303",
"MajorName": null,
"Requirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)"
},
{
"MajorCode": "A071010",
"MajorName": null,
"Requirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)"
},
{
"MajorCode": "A081704",
"MajorName": null,
"Requirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "应届毕业生",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": "1.大学英语六级考试合格（或425分）及以上； 2.色觉功能正常，不得为色盲或色弱。",
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.083",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
},
{
"PositionId": "66d2d8c8315f2f01744ea1de33e2738a4d9aa0f1ab6ae2ac9d4ae4f78aa8f28c",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "广州海关技术中心",
"DepartmentName": "危险化学品与运输包装检测研究所",
"OrganizationCode": "6210732",
"PositionCode": "2026005980053",
"PositionName": "危险化学品与运输包装检测研究所",
"PositionDescription": "从事再生纸浆、危险货物包装检测等工作。",
"PositionCategory": "专业技术岗位十一级至十三级",
"PlannedHires": 1,
"EducationRequirement": "本科以上",
"DegreeRequirement": "学士以上",
"MajorRequirement": "包装工程(B081802)；制浆造纸工程(A082201)",
"MajorRequirements": [
{
"MajorCode": "A082201",
"MajorName": null,
"Requirement": "包装工程(B081802)；制浆造纸工程(A082201)"
},
{
"MajorCode": "B081802",
"MajorName": null,
"Requirement": "包装工程(B081802)；制浆造纸工程(A082201)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "不限",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": null,
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.083",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
},
{
"PositionId": "7789ff4209f77c06fa9c8097cbd5fcfa7e6cce235324952186fb23cdb16be642",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "国家税务总局深圳市税务局机关服务中心",
"DepartmentName": "业务部门",
"OrganizationCode": "6210730",
"PositionCode": "2026005980052",
"PositionName": "业务部门",
"PositionDescription": "从事机关后勤工程管理、采购、行政工作。",
"PositionCategory": "管理岗位九级以上",
"PlannedHires": 2,
"EducationRequirement": "本科以上",
"DegreeRequirement": "学士以上",
"MajorRequirement": "管理科学与工程类(B1201),公共管理类(B1204),物流管理与工程类(B1206)；管理科学与工程(A1201),公共管理(A1204)",
"MajorRequirements": [
{
"MajorCode": "A1201",
"MajorName": null,
"Requirement": "管理科学与工程类(B1201),公共管理类(B1204),物流管理与工程类(B1206)；管理科学与工程(A1201),公共管理(A1204)"
},
{
"MajorCode": "A1204",
"MajorName": null,
"Requirement": "管理科学与工程类(B1201),公共管理类(B1204),物流管理与工程类(B1206)；管理科学与工程(A1201),公共管理(A1204)"
},
{
"MajorCode": "B1201",
"MajorName": null,
"Requirement": "管理科学与工程类(B1201),公共管理类(B1204),物流管理与工程类(B1206)；管理科学与工程(A1201),公共管理(A1204)"
},
{
"MajorCode": "B1204",
"MajorName": null,
"Requirement": "管理科学与工程类(B1201),公共管理类(B1204),物流管理与工程类(B1206)；管理科学与工程(A1201),公共管理(A1204)"
},
{
"MajorCode": "B1206",
"MajorName": null,
"Requirement": "管理科学与工程类(B1201),公共管理类(B1204),物流管理与工程类(B1206)；管理科学与工程(A1201),公共管理(A1204)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "应届毕业生",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": null,
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.083",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
},
{
"PositionId": "84a06f766763c85fb5168b7da9cf87bfcd19639c5d5f04ae8b176927d6cef92d",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "广州白云机场海关综合技术服务中心",
"DepartmentName": "质量与技术管理部",
"OrganizationCode": "6210732",
"PositionCode": "2026005980054",
"PositionName": "质量与技术管理部",
"PositionDescription": "从事统筹做好动物检疫实验室管理工作。",
"PositionCategory": "专业技术岗位十一级至十三级",
"PlannedHires": 1,
"EducationRequirement": "硕士研究生以上",
"DegreeRequirement": "硕士以上",
"MajorRequirement": "分析化学(A070302),动物学(A071002),水生生物学(A071004),应用化学(A081704)",
"MajorRequirements": [
{
"MajorCode": "A070302",
"MajorName": null,
"Requirement": "分析化学(A070302),动物学(A071002),水生生物学(A071004),应用化学(A081704)"
},
{
"MajorCode": "A071002",
"MajorName": null,
"Requirement": "分析化学(A070302),动物学(A071002),水生生物学(A071004),应用化学(A081704)"
},
{
"MajorCode": "A071004",
"MajorName": null,
"Requirement": "分析化学(A070302),动物学(A071002),水生生物学(A071004),应用化学(A081704)"
},
{
"MajorCode": "A081704",
"MajorName": null,
"Requirement": "分析化学(A070302),动物学(A071002),水生生物学(A071004),应用化学(A081704)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "不限",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": null,
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.083",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
},
{
"PositionId": "dbbb1ca87980e4fbd4ed6b85a9bb80d59b2ccc98881d0da2cef96a4790e70222",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "国家税务总局深圳市税务局纳税服务和宣传中心",
"DepartmentName": "业务部门",
"OrganizationCode": "6210730",
"PositionCode": "2026005980049",
"PositionName": "业务部门",
"PositionDescription": "从事税收宣传等有关工作。",
"PositionCategory": "管理岗位九级以上",
"PlannedHires": 1,
"EducationRequirement": "本科以上",
"DegreeRequirement": "学士以上",
"MajorRequirement": "法学类(B0301),中国语言文学类(B0501),新闻传播学类(B0503)；法学(A0301),中国语言文学(A0501),新闻传播学(A0503)",
"MajorRequirements": [
{
"MajorCode": "A0301",
"MajorName": null,
"Requirement": "法学类(B0301),中国语言文学类(B0501),新闻传播学类(B0503)；法学(A0301),中国语言文学(A0501),新闻传播学(A0503)"
},
{
"MajorCode": "A0501",
"MajorName": null,
"Requirement": "法学类(B0301),中国语言文学类(B0501),新闻传播学类(B0503)；法学(A0301),中国语言文学(A0501),新闻传播学(A0503)"
},
{
"MajorCode": "A0503",
"MajorName": null,
"Requirement": "法学类(B0301),中国语言文学类(B0501),新闻传播学类(B0503)；法学(A0301),中国语言文学(A0501),新闻传播学(A0503)"
},
{
"MajorCode": "B0301",
"MajorName": null,
"Requirement": "法学类(B0301),中国语言文学类(B0501),新闻传播学类(B0503)；法学(A0301),中国语言文学(A0501),新闻传播学(A0503)"
},
{
"MajorCode": "B0501",
"MajorName": null,
"Requirement": "法学类(B0301),中国语言文学类(B0501),新闻传播学类(B0503)；法学(A0301),中国语言文学(A0501),新闻传播学(A0503)"
},
{
"MajorCode": "B0503",
"MajorName": null,
"Requirement": "法学类(B0301),中国语言文学类(B0501),新闻传播学类(B0503)；法学(A0301),中国语言文学(A0501),新闻传播学(A0503)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "应届毕业生",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": null,
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"PublishedAt": null,
"DataUpdatedAt": "2026-09-07 07:40:03.083",
"CategoryDetails": {
"SupervisorCode": null,
"SupervisorName": null,
"PositionGrade": null,
"WrittenExamRequired": null,
"InterviewRequired": null,
"ExamCategoryMinor": null
}
}
]
}
```
## 接口常见 HTTP 响应状态码
> 以下为接口调用中常见的 HTTP 传输层状态码，不等同于响应体内的业务状态码；完整状态码注册表以 IANA HTTP Status Code Registry 为准。
| 状态码 | 状态码解释 | 备注 |
| --- | --- | --- |
| 200 | 请求成功 | HTTP 请求已成功处理；业务状态请结合响应体中的自定义业务码判断。 |
| 201 | 资源已创建 | 创建类接口请求成功，并已生成对应资源。 |
| 202 | 请求已接受 | 请求已被接受处理，结果可能异步完成。 |
| 204 | 无响应内容 | 请求成功但响应体为空，适用于无需返回数据的操作。 |
| 400 | 请求参数错误 | 请求参数缺失、格式错误或参数组合不合法。 |
| 401 | 认证失败 | 缺少、无效或未通过认证的访问凭证（如 AppKey）。 |
| 403 | 无权限访问 | 订单到期、权限不足或接口额度不可用。 |
| 404 | 资源不存在 | 请求路径不存在。 |
| 405 | 请求方法不允许 | 当前路径不支持该 HTTP 方法。 |
| 408 | 请求超时 | 客户端请求在服务端等待时间内未完成，可稍后重试。 |
| 409 | 请求冲突 | 请求与当前资源状态冲突，调整参数或业务状态后重试。 |
| 413 | 请求内容过大 | 上传文件或请求体超过接口限制。 |
| 414 | 请求地址过长 | 请求 URL 超过服务端可处理长度，建议减少查询参数或改用 POST。 |
| 415 | 请求内容类型不支持 | 上传或请求体的内容类型不符合接口要求。 |
| 422 | 请求语义错误 | 请求格式正确，但参数取值、语义或业务约束无法处理。 |
| 429 | 请求频率受限 | 默认按来源 IP 限速，单 IP 最多 5 QPS，可满足常规业务调用。超出限制时接口会返回 429 请求频率受限；已购买接口订单可加购 10 QPS 扩展。 |
| 431 | 请求头过大 | 请求头字段过大或过多，建议精简 Header 后重试。 |
| 500 | 服务器内部错误 | 服务端处理异常，请稍后重试。 |
| 502 | 服务暂时不可用 | 请稍后重试。 |
| 503 | 服务暂时不可用 | 请稍后重试。 |
| 504 | 请求超时 | 请稍后重试。 |
## 接口自定义业务状态码
| 业务状态码 | 业务状态码解释 | 备注 |
| --- | --- | --- |
| 100 | 成功 | HTTP 200 |
| 501 | 参数或凭证冲突 | HTTP 400 |
| 502 | 请求频率受限 | HTTP 429 |
| 503 | 订单到期 | HTTP 403 |
| 504 | APPKEY 缺失或无效 | HTTP 401 |
| 505 | 额度耗尽 | HTTP 403 |
| 900 | 内部错误 | HTTP 500 |
| 901 | 招录数据服务暂不可用 | HTTP 503 |
## cURL 请求示例
```bash
curl --location --request GET '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='
```
## 更多请求示例与预览数据
- [事业单位岗位查询](https://www.gugudata.com/preview/6a94ea3f1973dbbcdf49da64)
## 常见问题 Q&A
### Q: 接口是否覆盖全国全部地区和所有年份？
A: 接口汇集当前已结构化的公开招录岗位，各类型、年份和地区的覆盖范围以公开发布情况和接口实时返回为准，不承诺所有地区和所有年度完全覆盖。
### Q: 默认按照什么顺序返回？
A: 招聘年度倒序，其次按资料日期倒序、岗位标识升序返回；未提供发布时间时使用现有资料日期。
### Q: 如何区分岗位标识与资料更新时间？
A: PositionId 用于区分岗位；DataUpdatedAt 表示该条资料的数据更新时间，不代表报名仍在开放。
### Q: 多个筛选条件如何组合？
A: category、year、地区、代码和关键词等参数同时传入时按交集查询。地区和代码为精确筛选，单位、岗位、专业及学历关键词为模糊搜索。
### Q: PositionId 和 PositionCode 有什么区别？
A: PositionId 是平台提供的稳定岗位标识，适合本地幂等更新；PositionCode 是公开材料中的岗位代码，部分招录类型或来源可能未提供。
### Q: 为什么部分字段返回 null、空数组或 0？
A: 不同类型、年份和地区公开的岗位材料字段并不完全一致。未披露的可空字段返回 null，无法整理出专业明细时 MajorRequirements 返回空数组，未披露或无法识别计划人数时 PlannedHires 返回 0。
### Q: 是否可以一次查询全部招录类型？
A: 可以。category 不传或传 all 时查询全部已覆盖类型，也可以传入指定枚举值只查询某一类岗位。
### Q: 接口如何计费和限流？
A: 本接口按年订阅，默认 5 QPS。需要更高并发时可在购买后根据业务量评估扩容。
### Q: 如何完成第一次 API 调用？
A: 先确认当前接口的请求方法、必填参数和成功状态，再使用对应产品的 AppKey 发起请求；以实际响应中的业务状态判断结果。 [查看接入指南](https://www.gugudata.com/developers/getting-started)
### Q: 如何保证请求时 AppKey 的安全性？
A: 在开发者中心的 APP KEY 管理页面复制对应产品的 AppKey，并保存在服务端环境变量或密钥管理服务中。不要写入网页、App 客户端、公开仓库或日志。
### Q: 接口可以用于哪些开发语言？
A: Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等支持 HTTP 请求的语言均可接入；也可以通过 OpenAPI、Postman 或 Apifox 查看和调试接口。
### Q: 请求失败或超时后可以重试吗？
A: 先区分 HTTP 状态与业务错误。参数、鉴权和权限错误应修正后再请求；超时并不表示服务端未执行，重试前需确认接口是否会重复计费或产生副作用。 [查看接入指南](https://www.gugudata.com/developers/errors-and-retries)
### Q: 接口的性能可以保证吗？
A: 实际响应时间受接口类型、参数和网络环境影响。请按当前套餐的 QPS 控制并发，生产接入前完成联调与容量评估。
### Q: 数据多久更新？
A: 不同接口按各自的数据周期更新，请以当前详情页的更新时间、更新频率及字段说明为准；不要将一次请求时间视为数据更新时间。
## 服务协议以及服务免责声明
- [服务协议](https://www.gugudata.com/license)
- [服务免责声明](https://www.gugudata.com/disclaimer)
## 技术支持
- 技术支持邮箱: support@gugudata.com
- 微信客服: https://work.weixin.qq.com/kfid/kfcf9a60a6afe3337b7