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

公职国企岗位与招录条件
接口特性：

查询公务员、事业单位、军队文职、三支一扶及国企招录岗位。

支持按招录类别、年度和地区组合筛选。

可按单位代码、岗位代码精确检索，保留代码中的前导零。

支持单位、岗位、专业和学历关键词查询。

返回岗位名称、职责及计划招录人数。

展示学历、学位和专业要求，便于人工对照资格条件。

提供政治面貌、工作经历、毕业生和年龄等要求资料。

返回户籍、资格证书及其他条件，补充岗位限制信息。

提供可获取的工作地点、报名截止时间等资料。

返回专业要求明细，保留原始要求的业务含义。

按招录类别提供对应补充资料，如考试、服务方向或用工信息。

使用 PositionId 区分记录，岗位代码按原资料展示。

支持分页与匹配总数，适合岗位检索和就业服务。

资料完整度因年份、地区和类别而异，报考前请核对招录公告。
未知或重复业务参数返回 501；多处凭证同值允许，冲突返回 501。示例年份为示例值，Demo 使用北京时间当年。

当前接口契约

接口详情：https://www.gugudata.com/api/details/recruitmentpositions

请求参数

参数	类型	必填	默认值	说明
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，不能据此认定明确不招聘，需结合招录公告复核。
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	国有单位公开薪酬说明。

业务状态说明

业务状态码	业务状态码解释	备注
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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 100
    },
    "Data": [
        {
            "PositionDescription": "string",
            "PositionCategory": "string",
            "InterviewRatio": "string",
            "ExperienceRequirement": "string",
            "QualificationRequirement": "string",
            "OtherRequirement": "string",
            "HouseholdRequirement": "string",
            "ApplicationDeadline": "string",
            "OrganizationName": "string",
            "PositionId": "string",
            "District": "string",
            "DataUpdatedAt": "string",
            "CategoryDetails": null,
            "Category": "civil_service",
            "PlannedHires": 0,
            "City": "string",
            "CategoryName": "string",
            "MajorRequirements": [
                {
                    "MajorCode": "string",
                    "Requirement": "string",
                    "MajorName": "string"
                }
            ],
            "GraduateRequirement": "string",
            "DepartmentName": "string",
            "SettlementLocation": "string",
            "AgeRequirement": "string",
            "PublishedAt": "string",
            "MajorRequirement": "string",
            "PoliticalRequirement": "string",
            "RecruitmentYear": 2000,
            "WorkLocation": "string",
            "EducationRequirement": "string",
            "DegreeRequirement": "string",
            "ExamCategory": "string",
            "PositionCode": "string",
            "PositionName": "string",
            "Province": "string",
            "OrganizationCode": "string",
            "GenderRequirement": "string"
        }
    ]
}

🟠400参数或凭证冲突（业务码 501）。

🟠401APPKEY 缺失或无效（业务码 504）。

🟠403订单到期（业务码 503）；额度耗尽（业务码 505）。

🟠429请求频率受限（业务码 502）。

🔴500内部错误（业务码 900）。

🔴503招录数据服务暂不可用（业务码 901）。

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

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明