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

API 功能
- 汇集已结构化的国家公务员、部分省级公务员、事业单位、军队文职、三支一扶及国有单位公开招聘岗位；
- 统一岗位、招录人数、学历、学位、专业和资格条件等核心字段；
- 支持按招录类型、年度、地区、单位、岗位、学历和专业要求组合检索；
- 返回稳定岗位标识、公开来源链接及各招录类型对应的扩展信息；
- 适用于招考信息平台、职业规划、就业服务、岗位搜索与历史趋势研究；
- 各类型、年份和地区的覆盖及字段完整度以公开发布情况和接口实时返回为准；
- 百万级结构化数据，毫秒级响应性能。
- 默认最大 QPS:5，可在开发者中心自助升级，仅支持年付，订阅期内接口调用次数不限；
- 接口调用状态与状态监控。

API 文档

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

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

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=

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

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

OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求参数（GET 请求方式可参见下方示例代码）

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	购买本接口后获取的 APPKEY，请仅在服务端安全保存。
category	string	否	all	招录类型。可选值：all（全部）；civil_service（公务员）；public_institution（事业单位）；military_civilian（军队文职）；three_support（三支一扶）；state_owned_enterprise（国有单位）。
year	integer	否	0	招聘年度；不传或传 0 时不按年度筛选。
province	string	否		省级地区名称精确筛选；传全国可查询现有国家级岗位。
city	string	否		城市名称精确筛选，建议与 province 组合使用。
district	string	否		区县名称精确筛选，建议与 province、city 组合使用。
organizationCode	string	否		招录单位代码精确查询。
positionCode	string	否		岗位代码精确查询。
organizationKeyword	string	否		单位名称或部门名称模糊搜索，最长 100 个字符。
positionKeyword	string	否		岗位名称或岗位描述模糊搜索，最长 100 个字符。
majorKeyword	string	否		专业要求模糊搜索，最长 100 个字符。
educationKeyword	string	否		学历要求模糊搜索，如本科、硕士研究生，最长 100 个字符。
pageIndex	integer	否	1	分页页码，从 1 开始。
pageSize	integer	否	20	每页记录数，取值范围 1~100。

返回参数

参数名	参数类型	备注
DataStatus.RequestParameter	string	服务端识别的业务参数摘要，不包含 APPKEY。
DataStatus.StatusCode	integer	业务状态码。
DataStatus.StatusDescription	string	业务状态说明。
DataStatus.ResponseDateTime	string	响应时间。
DataStatus.DataTotalCount	integer	当前筛选条件下去重后的岗位总数。
Data.PositionId	string	岗位稳定唯一标识，可用于本地幂等更新。
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	报名截止时间。
Data.SourceUrl	string\|null	公开信息来源链接。
Data.PublishedAt	string\|null	公开发布时间。
Data.DataUpdatedAt	string\|null	平台数据更新时间。
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	国有单位公开薪酬说明。

响应示例（真实数据节选）

接口数据预览

{
  "DataStatus": {
    "RequestParameter": "category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&city=&district=&organizationCode=&positionCode=&organizationKeyword=&positionKeyword=&majorKeyword=&educationKeyword=&pageIndex=1&pageSize=10",
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-08-31 11:38:54.410",
    "DataTotalCount": 9384
  },
  "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,
      "SourceUrl": "https://rsj.gz.gov.cn/attachment/7/7965/7965878/10667246.xlsx",
      "PublishedAt": null,
      "DataUpdatedAt": "2026-08-31 11:38:06.754",
      "CategoryDetails": [
        [
          [
            
          ]
        ],
        [
          [
            
          ]
        ],
        [
          [
            
          ]
        ]
      ]
    },
    {
      "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)"
        }
      ],
      "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,
      "SourceUrl": "https://rsj.gz.gov.cn/attachment/7/7965/7965878/10667246.xlsx",
      "PublishedAt": null,
      "DataUpdatedAt": "2026-08-31 11:38:06.754",
      "CategoryDetails": [
        [
          [
            
          ]
        ],
        [
          [
            
          ]
        ],
        [
          [
            
          ]
        ]
      ]
    },
    {
      "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)"
        }
      ],
      "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,
      "SourceUrl": "https://rsj.gz.gov.cn/attachment/7/7965/7965878/10667246.xlsx",
      "PublishedAt": null,
      "DataUpdatedAt": "2026-08-31 11:38:06.754",
      "CategoryDetails": [
        [
          [
            
          ]
        ],
        [
          [
            
          ]
        ],
        [
          [
            
          ]
        ]
      ]
    }
  ]
}

鉴权方式

接口支持以下 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 参数。

接口常见 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	正常返回	无匹配岗位时 Data 返回空数组。
501	参数错误	请检查分类、年份、关键词和分页参数。
502	请求频率受限	默认 5 QPS，请按套餐频率调用。
503	订单已到期	请检查订单有效期。
504	APPKEY 错误	请检查 APPKEY 及本接口购买状态。
505	请求次数超限	请检查套餐剩余调用次数。
900	接口内部响应错误	请稍后重试。
901	数据服务暂时不可用	请稍后重试。

请求示例代码

curl --location --request GET 'https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword='

#include <curl/curl.h>

int main(void) {
  CURL *curl = curl_easy_init();
  if (curl) {
    curl_easy_setopt(curl, CURLOPT_URL, "https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=");
    curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
    curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
    CURLcode res = curl_easy_perform(curl);
    (void)res;
    curl_easy_cleanup(curl);
  }
  return 0;
}

using System;
using System.Collections.Generic;
using System.IO;
using System.Net.Http;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=");
var response = client.SendAsync(request).Result;
Console.WriteLine(response.Content.ReadAsStringAsync().Result);

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  url := "https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword="
  req, err := http.NewRequest("GET", url, nil)
  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := http.DefaultClient.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()
  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

OkHttpClient client = new OkHttpClient().newBuilder().build();
Request request = new Request.Builder()
  .url("https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());

$.ajax({
  url: "https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=",
  method: "GET",
}).done(function (response) {
  console.log(response);
});

const https = require("node:https");

const url = "https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=";
const request = https.request(url, { method: "GET", headers: {  } }, handleResponse);
request.on("error", console.error);
request.end();

function handleResponse(response) {
  const chunks = [];
  response.on("data", function (chunk) {
    chunks.push(chunk);
  });
  response.on("end", function () {
    console.log(Buffer.concat(chunks).toString("utf8"));
  });
}

#import <Foundation/Foundation.h>

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword="]];
[request setHTTPMethod:@"GET"];
NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  if (error) {
    NSLog(@"%@", error);
    return;
  }
  NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
}];
[task resume];

<?php
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_CUSTOMREQUEST => "GET",
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

import requests

url = "https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword="
response = requests.request("GET", url)
print(response.text)

require "uri"
require "net/http"

url = URI("https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
response = https.request(request)
puts response.read_body

import Foundation

let semaphore = DispatchSemaphore(value: 0)
var request = URLRequest(url: URL(string: "https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=")!, timeoutInterval: .infinity)
request.httpMethod = "GET"
let task = URLSession.shared.dataTask(with: request) { data, response, error in
  defer { semaphore.signal() }
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}
task.resume()
semaphore.wait()

Swagger 文档在 Postman 中测试运行

在 Apifox 中测试运行打开 LLM 页面

更多请求示例与预览数据
- - 事业单位岗位查询
常见问题 Q&A
- Q: 接口是否覆盖全国全部地区和所有年份？
  
  A: 接口汇集当前已结构化的公开招录岗位，各类型、年份和地区的覆盖范围以公开发布情况和接口实时返回为准，不承诺所有地区和所有年度完全覆盖。
- Q: 默认按照什么顺序返回？
  
  A: 固定按招聘年度倒序、发布时间倒序、岗位唯一标识升序返回。
- Q: 如何持续同步到本地数据库？
  
  A: 建议按筛选条件分页拉取，并使用 PositionId 作为本地幂等更新键；定期补拉近期年度数据。
- Q: 数据多久更新？
  
  A: 不同接口按各自的数据周期更新，具体以接口详情中的更新频率和字段说明为准。
- Q: 如何保证请求时 AppKey 的安全性？
  
  A: 建议将 AppKey 保存在服务端环境中，由后端统一调用 API，再向前端或业务系统返回必要结果。不要把 AppKey 写入网页、App 客户端或公开仓库；生产环境建议按系统或业务线拆分 AppKey，并保留调用日志，便于权限控制、审计与问题排查。
- Q: 接口可以用于哪些开发语言？
  
  A: Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等常用语言均可接入。
- Q: 接口的性能可以保证吗？
  
  A: 实际响应时间会受接口类型、请求参数和网络环境影响。生产接入前建议完成联调与压测，高并发场景可提前评估 QPS 和专属容量。
服务协议与免责声明

购买或使用 GuGuData API 服务前，请充分阅读服务协议、免责声明与数据合规声明。相关页面均支持在浏览器中快速导出 PDF，便于内部归档、评审和合规留存。

服务协议免责声明数据合规
技术支持
- 技术支持邮箱: support@gugudata.com
- 微信客服: 客服链接
专业软件开发与系统工程服务

GuGuData 官方认证工程合作伙伴，专注企业级数据接口集成、AI 工程化与大规模数据处理。团队深度理解 GuGuData 数据接口体系，具备海量数据采集、治理、检索与高并发接口服务经验，可围绕业务场景构建 AI Agent、MCP 接入、智能工作流和生产级数据应用，让数据能力稳定进入现有流程、内部平台和核心业务系统。

了解工程服务

购买数据调用邮件咨询 (7*24小时) 微信客服联系 (工作日) 需要软件工程开发服务？

API 功能

API 文档

鉴权方式

接口常见 HTTP 响应状态码

接口自定义业务状态码

请求示例代码

更多请求示例与预览数据

常见问题 Q&A

Q: 接口是否覆盖全国全部地区和所有年份？

Q: 默认按照什么顺序返回？

Q: 如何持续同步到本地数据库？

Q: 数据多久更新？

Q: 如何保证请求时 AppKey 的安全性？

Q: 接口可以用于哪些开发语言？

Q: 接口的性能可以保证吗？

服务协议与免责声明

技术支持

专业软件开发与系统工程服务

业务相关接口推荐