OCC 求职(OCCMundial)数据 API
OCC 求职是 OCCMundial.com(墨西哥招聘网站 occ.com.mx 的运营方)推出的安卓应用,面向在墨西哥找工作的求职者。用户可按关键词、地点、职位类别和薪资区间搜索职位,并用筛选项缩小结果;职位详情页展示职位描述、任职要求、福利、薪资区间、办公方式,以及雇主所属行业、评分和认证标识,下方还有相关职位轮播。投递时需回答筛选问题(killer questions)并填写技能水平,应用内的简历编辑器涵盖技能、工作经历、教育背景、证书和语言,可设为公开或隐藏,也可附上 PDF 或 DOC 格式的简历文件。投递之后,“投递记录”标签页跟踪每份申请的状态,简历访问面板显示哪些公司的招聘方看过自己的资料,聊天收件箱则用未读角标提示招聘方消息。收藏职位、按关键词与地点设置并可选推送频率的职位订阅,以及仪表盘上按匹配度排序的推荐职位,持续带来新的机会。OCCMundial 是墨西哥领先的招聘平台之一,服务全国求职者,与 Computrabajo、Bumeran México、Indeed 和 LinkedIn 争夺同一批求职用户。
OCCMundial 职位记录是这份数据的主干:每条职位带有 jobTitle,雇主以 companyPrettyName 呈现,并附 companySector、companyRating 与 isCompanyVerified 认证标志;此外还有 salaryMin/salaryMax 薪资区间及其 salaryInterval、locationName、jobModality 或 workplaceType、publicationDate,以及标记需回答筛选问题的 hasKillerQuestions;详情记录再补充 description、requirements 与 jobBenefits,每次搜索还按查询返回 facets 聚合与 total 总数。候选人一侧,结构化简历拆分为带 levelId 的 skills、jobExperiences、education、certification 以及带 languageLevel 的 language,并统一受 visibility 设置控制。投递以 applicationId、applicationStatusId 和 applicationDate 记录;招聘方兴趣体现为 totalRecruiterViews 与 totalCompanies 计数,以及带 unreadMessagesCount 的聊天会话;已保存的订阅保留 keywords、locationIds 与 frequency;推荐职位与相关职位则按 affinityScore 排序。
申请人跟踪系统可以借此镜像 OCCMundial 的墨西哥职位,连同薪资区间与筛选问题标志一并同步;职业辅导产品可读取 skills、jobExperiences 与简历 visibility,在投递发出前告诉求职者为何会被拦下;把投递状态与招聘方浏览总数关联,就能看出哪些投递真正被雇主打开;人力产品还能把同样的订阅条件和按匹配度排序的推荐分发为推送或邮件,而无需重新实现 OCCMundial 的匹配逻辑。openData Studio 把这些职位、简历、投递与招聘方兴趣记录变成可调用的开放数据。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
OAuth2 令牌(候选人登录)
POST
/oauth/tokenosint把 OCCMundial 授权码(或 refresh_token)换成 Bearer accessToken,供候选人登录及后续每次 /v1 调用携带。
认证方式: 无需认证。授权码 + PKCE 交换。后续 REST 调用发送 Authorization: Bearer <accessToken>。刷新在同一端点使用 grant_type=refresh_token。
- grant_type
- code
- redirect_uri
- clientId
- code_verifier
- access_token
- refresh_token
- id_token
- token_type
- expires_in
- scope
- sub
POST /oauth/token HTTP/1.1 Content-Type: application/x-www-form-urlencoded grant_type=authorization_code&code=<auth-code>&redirect_uri=<app-redirect-uri>&client_id=<portal-client-id>&code_verifier=<pkce-verifier>{ "access_token": "<accessToken>", "refresh_token": "<refreshToken>", "id_token": "<idToken>", "token_type": "Bearer", "expires_in": 3600, "scope": "openid profile email" }搜索职位
GET
/v1/ofertas/searchopendata返回职位搜索结果页使用的职位列表:jobTitle、companyPrettyName、salaryMin/salaryMax、locationName、筛选聚合与分页。
认证方式: 可选的 Bearer accessToken,来自 POST /oauth/token。匿名搜索仍发送门户标识;登录调用会个性化 isFavorite / isApplied。
- jobOffers
- jobOfferId
- encryptedId
- jobTitle
- companyName
- companyPrettyName
- companyLogoUrl
- companySector
- companyRating
- isCompanyVerified
- isCompanyConfidential
- salaryMin
- salaryMax
- salaryNegotiable
- salaryInterval
- isSalaryVisible
- locationId
- locationName
- publicationDate
- jobModality
- hasKillerQuestions
- isFavorite
- isApplied
- affinityScore
- facets
- selectedFacets
- pageNumber
- total
- hasMore
GET /v1/ofertas/search?keywords=ingeniero+software&locationIds=9&cityIds=555&categoryIds=12&salaryMin=20000&salaryMax=45000&pageNumber=1&pageSize=20&sortBy=publicationDate HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "jobOffers": [{ "jobOfferId": "18442091", "encryptedId": "enc-off-18442091", "jobTitle": "Ingeniero de software", "companyName": "Example Corp", "companyPrettyName": "Example Corp SA de CV", "companyLogoUrl": "https://cdn.example.com/logos/example.png", "companySector": "Tecnología", "companyRating": 4.2, "isCompanyVerified": true, "isCompanyConfidential": false, "salaryMin": 25000, "salaryMax": 38000, "salaryNegotiable": false, "salaryInterval": "monthly", "isSalaryVisible": true, "locationId": 9, "locationName": "Ciudad de México", "publicationDate": "2026-09-20T15:04:00Z", "jobModality": "hybrid", "hasKillerQuestions": true, "isFavorite": false, "isApplied": false, "affinityScore": 0.81, "jobFirstToApply": true }], "total": 1284, "pageNumber": 1, "hasMore": true, "facets": [{"facetId": "salary", "facetType": "salary", "count": 412}], "selectedFacets": [] }按 ID 获取职位
GET
/v1/ofertas/{jobId}opendata为职位详情页水合单个 OCCMundial 职位(description、requirements、jobBenefits、薪资区间、企业认证)。
认证方式: 可选的 Bearer accessToken。个性化区块(isApplied、isFavorite、affinityScore)需要登录候选人。
- jobOffer
- jobOfferId
- encryptedId
- jobTitle
- description
- requirements
- jobBenefits
- companyId
- companyPrettyName
- companyLogoUrl
- companySector
- companyRating
- isCompanyVerified
- isCompanyConfidential
- salaryMin
- salaryMax
- workplaceType
- contractTypeId
- publicationDate
- hasKillerQuestions
- hasSkills
- isExternal
- isFavorite
- isApplied
GET /v1/ofertas/18442091 HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "jobOffer": { "jobOfferId": "18442091", "encryptedId": "enc-off-18442091", "jobTitle": "Ingeniero de software", "description": "Construye servicios de marketplace en CDMX.", "requirements": "3+ años en Kotlin o Java.", "jobBenefits": ["SGMM", "home office 2 días"], "companyId": "co-441", "companyPrettyName": "Example Corp SA de CV", "companyLogoUrl": "https://cdn.example.com/logos/example.png", "companySector": "Tecnología", "companyRating": 4.2, "isCompanyVerified": true, "isCompanyConfidential": false, "salaryMin": 25000, "salaryMax": 38000, "salaryNegotiable": false, "locationName": "Ciudad de México", "workplaceType": "hybrid", "contractTypeId": 1, "publicationDate": "2026-09-20T15:04:00Z", "hasKillerQuestions": true, "hasSkills": true, "isExternal": false, "isFavorite": false, "isApplied": false } }相关职位
GET
/v1/ofertas/{jobId}/relatedopendata为职位详情轮播返回相关职位,以 affinityScore 评分。
认证方式: 可选的 Bearer accessToken。候选人已隐藏的职位在展示前被过滤。
- relatedJobOffers
- jobOfferId
- jobTitle
- companyPrettyName
- companyLogoUrl
- locationName
- salaryMin
- salaryMax
- affinityScore
- isSimilarJob
- isFavorite
- jobOffersAffinityScoreList
GET /v1/ofertas/18442091/related HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "relatedJobOffers": [{ "jobOfferId": "18443002", "jobTitle": "Desarrollador backend", "companyPrettyName": "Example Labs", "companyLogoUrl": "https://cdn.example.com/logos/labs.png", "locationName": "Guadalajara", "salaryMin": 22000, "salaryMax": 32000, "affinityScore": 0.74, "isSimilarJob": true, "isFavorite": false }], "jobOffersAffinityScoreList": [0.74] }获取登录候选人
GET
/v1/me/profileosint加载登录求职者记录(姓名、email、phoneNumber、encryptedCurriculumId、resumeVisibility、功能开关),用于控制投递与聊天界面。
认证方式: Bearer accessToken,来自 POST /oauth/token。会话过期会触发令牌刷新,刷新失败则登出。
- candidate
- candidateId
- encryptedCandidateId
- firstName
- middleName
- lastName
- phoneNumber
- gender
- birthDate
- candidateStatusId
- curriculumId
- encryptedCurriculumId
- resumeVisibility
- features
- isVerified
GET /v1/me/profile HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "candidate": { "candidateId": 8845123, "encryptedCandidateId": "enc-cand-8845123", "firstName": "María", "middleName": "Elena", "lastName": "Hernández", "email": "[email protected]", "phoneNumber": "5512345678", "gender": "F", "birthDate": "1994-03-12", "candidateStatusId": 1, "curriculumId": 44189012, "encryptedCurriculumId": "enc-cv-44189012", "resumeVisibility": "public", "features": ["chatEnabled", "chargedApply"], "isVerified": true } }获取候选人简历
GET
/v1/me/resumeosint返回结构化 OCCMundial 简历(skills、jobExperiences、education、certification、language、visibility),供简历界面展示与编辑。
认证方式: Bearer accessToken,来自 POST /oauth/token。要求候选人具有有效的 curriculumId。
- resume
- resumeId
- curriculumId
- encryptedCurriculumId
- visibility
- isFirstJob
- jobTitle
- skills
- encryptedSkillId
- levelId
- jobExperiences
- company
- position
- startDate
- endDate
- isCurrent
- education
- institution
- certification
- encryptedCertificationId
- language
- languageId
- languageLevel
GET /v1/me/resume HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "resume": { "resumeId": 44189012, "curriculumId": 44189012, "encryptedCurriculumId": "enc-cv-44189012", "visibility": "public", "isFirstJob": false, "jobTitle": "Ingeniera de software", "skills": [{"encryptedSkillId": "enc-sk-91", "skill": "Kotlin", "levelId": 3}], "jobExperiences": [{ "company": "Example Corp", "position": "Ingeniera de software", "startDate": "2021-03-01", "endDate": null, "isCurrent": true, "expIsFirstJob": false }], "education": [{"institution": "UNAM", "year": 2017}], "certification": [{"encryptedCertificationId": "enc-cert-7", "institution": "Google", "year": 2024}], "language": [{"languageId": 1, "languageLevel": "C1"}] } }上传简历文件
POST
/v1/me/resume/fileosint上传候选人附加的简历文件(PDF/DOC),返回用于下载、附加或设置默认简历的 encryptedFileId / fileUri。
认证方式: Bearer accessToken,来自 POST /oauth/token。以 multipart 上传附加简历文件。
- encryptedFileId
- fileName
- mimeType
- fileSize
- fileUri
- curriculumId
- encryptedCurriculumId
POST /v1/me/resume/file HTTP/1.1 Authorization: Bearer <accessToken> Content-Type: multipart/form-data; boundary=----occ ------occ Content-Disposition: form-data; name="file"; filename="cv-maria.pdf" Content-Type: application/pdf <pdf-bytes> ------occ--{ "encryptedFileId": "enc-file-9081", "fileName": "cv-maria.pdf", "mimeType": "application/pdf", "fileSize": 184320, "fileUri": "https://files.example.com/v1/me/resume/file/enc-file-9081", "curriculumId": 44189012, "encryptedCurriculumId": "enc-cv-44189012" }投递职位
POST
/v1/ofertas/{jobId}/applyopendata向职位提交投递,含 killerQuestionAnswers 与 skillAnswers;返回投递记录列表所用的 applicationId / applicationStatusId。
认证方式: Bearer accessToken,来自 POST /oauth/token。候选人须有完整简历;当 hasKillerQuestions / hasSkills 为 true 时,killerQuestionAnswers 与 skillAnswers 为必填。
- encryptedCandidateId
- jobOfferId
- encryptedCurriculumId
- killerQuestionAnswers
- skillAnswers
- applicationId
- jobApplicationId
- applicationDate
- applicationStatusId
- isApplied
- chargedApply
POST /v1/ofertas/18442091/apply HTTP/1.1 Authorization: Bearer <accessToken> Content-Type: application/json { "encryptedCandidateId": "enc-cand-8845123", "encryptedCurriculumId": "enc-cv-44189012", "killerQuestionAnswers": [{"questionId": 11, "answerText": "Sí"}], "skillAnswers": [{"encryptedSkillId": "enc-sk-91", "levelId": 3}] }{ "applicationId": "app-55201", "jobApplicationId": "app-55201", "jobOfferId": "18442091", "applicationDate": "2026-09-27T14:22:00Z", "applicationStatusId": 1, "isApplied": true, "chargedApply": false }列出已投递职位
GET
/v1/me/applicationsopendata列出候选人已投递的职位,供投递记录标签页使用。
认证方式: Bearer accessToken,来自 POST /oauth/token。
- jobOffers
- jobOfferId
- jobTitle
- companyPrettyName
- companyLogoUrl
- applicationId
- applicationDate
- applicationStatusId
- isApplied
- locationName
- total
GET /v1/me/applications HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "jobOffers": [{ "jobOfferId": "18442091", "jobTitle": "Ingeniero de software", "companyPrettyName": "Example Corp SA de CV", "companyLogoUrl": "https://cdn.example.com/logos/example.png", "applicationId": "app-55201", "applicationDate": "2026-09-27T14:22:00Z", "applicationStatusId": 1, "isApplied": true, "locationName": "Ciudad de México" }], "total": 6 }列出收藏职位
GET
/v1/me/favoritesopendata按 encryptedFavoritesIds 读取已收藏职位,供收藏页使用。
认证方式: Bearer accessToken,来自 POST /oauth/token。按 encryptedFavoritesIds 或 typeId 查询;切换收藏时写入同一资源。
- favoriteJobOffers
- encryptedFavoritesIds
- typeId
- jobOfferId
- encryptedId
- jobTitle
- companyPrettyName
- locationName
- salaryMin
- salaryMax
- isFavorite
GET /v1/me/favorites?typeId=1 HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "favoriteJobOffers": [{ "jobOfferId": "18442091", "encryptedId": "enc-off-18442091", "jobTitle": "Ingeniero de software", "companyPrettyName": "Example Corp SA de CV", "locationName": "Ciudad de México", "salaryMin": 25000, "salaryMax": 38000, "isFavorite": true }], "encryptedFavoritesIds": ["enc-off-18442091"] }招聘方资料浏览
GET
/v1/me/profile-viewsosint返回浏览过该候选人的招聘方,以及简历访问仪表盘所用的 totalRecruiterViews / totalCompanies。
认证方式: Bearer accessToken,来自 POST /oauth/token。
- recruiterViews
- companyId
- companyPrettyName
- companyLogoUrl
- recruiterViewsCount
- createdAt
- totalRecruiterViews
- totalCompanyViews
- totalCompanies
GET /v1/me/profile-views HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "recruiterViews": [{ "companyId": "co-441", "companyPrettyName": "Example Corp SA de CV", "companyLogoUrl": "https://cdn.example.com/logos/example.png", "recruiterViewsCount": 3, "createdAt": "2026-09-26T11:00:00Z" }], "totalRecruiterViews": 17, "totalCompanyViews": 9, "totalCompanies": 9 }职位订阅列表
GET
/v1/me/alertsopendata列出已保存的职位订阅,向候选人推送匹配职位。
认证方式: Bearer accessToken,来自 POST /oauth/token。
- alertId
- keywords
- locationIds
- locationName
- salaryMin
- criteria
- frequency
- isActive
- receiveAlerts
GET /v1/me/alerts HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "alerts": [{ "alertId": "al-2201", "keywords": "ingeniero software", "locationIds": [9], "locationName": "Ciudad de México", "salaryMin": 20000, "criteria": {"categoryIds": [12], "jobModality": "hybrid"}, "frequency": "daily", "isActive": true, "receiveAlerts": true }] }推荐职位
GET
/v1/me/suggested-jobsopendata为仪表盘推荐页返回个性化职位推荐。
认证方式: Bearer accessToken,来自 POST /oauth/token。要求有效的 curriculumId。
- suggestedJobOffers
- jobOfferId
- jobTitle
- companyPrettyName
- locationName
- salaryMin
- salaryMax
- affinityScore
- isFavorite
GET /v1/me/suggested-jobs HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "suggestedJobOffers": [{ "jobOfferId": "18445110", "jobTitle": "Desarrolladora Android", "companyPrettyName": "Example Mobile", "locationName": "Monterrey", "salaryMin": 28000, "salaryMax": 40000, "affinityScore": 0.88, "isFavorite": false }] }招聘方聊天会话
GET
/v1/me/conversationsosint列出招聘方与候选人的会话,含未读数 unreadMessagesCount,供应用内聊天收件箱使用。
认证方式: Bearer accessToken,来自 POST /oauth/token。功能由候选人资料上的 chatEnabled 开关控制。
- conversationId
- encryptedIdConversation
- companyPrettyName
- jobOfferId
- jobTitle
- unreadMessagesCount
- lastMessage
- messageCreationDate
- senderId
- totalMessagesCount
GET /v1/me/conversations HTTP/1.1 Authorization: Bearer <accessToken> Accept: application/json{ "conversations": [{ "conversationId": "conv-901", "encryptedIdConversation": "enc-conv-901", "companyPrettyName": "Example Corp SA de CV", "jobOfferId": "18442091", "jobTitle": "Ingeniero de software", "unreadMessagesCount": 2, "lastMessage": "¿Puedes entrevistarte el jueves?", "messageCreationDate": "2026-09-27T09:15:00Z", "senderId": "rec-44" }], "totalMessagesCount": 2 }
数据类别
- 职位
- 候选人资料
- 简历
- 投递申请
- 招聘方浏览
- 职位订阅
- 招聘方聊天
数据使用场景与案例
墨西哥职位接入 ATS
轮询 GET /v1/ofertas/search(keywords、locationIds、salaryMin/salaryMax、selectedFacets),并用 GET /v1/ofertas/{jobId} 水合每条结果,让申请人跟踪系统以 jobTitle、companyPrettyName、薪资区间与 hasKillerQuestions 镜像 OCCMundial 职位。
候选人简历完整度与投递就绪
读取 GET /v1/me/profile 与 GET /v1/me/resume(skills、jobExperiences、education、visibility),并把新文件 POST 到 /v1/me/resume/file,让职业辅导产品能告知求职者投递为何受阻。
投递管道与招聘方兴趣
关联 GET /v1/me/applications(applicationId、applicationStatusId、applicationDate)与 GET /v1/me/profile-views(totalRecruiterViews、totalCompanies),展示哪些投递真正被查看。
订阅驱动的职位通知
同步 GET /v1/me/alerts(keywords、locationIds、frequency、isActive)与 GET /v1/me/suggested-jobs(affinityScore),让人力产品无需重新实现 OCCMundial 的匹配,即可把相同的已保存搜索条件分发为推送或邮件。
常见问题
哪些 OCCMundial 端点驱动职位搜索?
empleos 结果页调用 GET /v1/ofertas/search(keywords、locationIds、salaryMin/salaryMax、facets)。打开卡片水合 GET /v1/ofertas/{jobId};相关轮播为 GET /v1/ofertas/{jobId}/related。
OCC 求职如何认证?
候选人以 OpenID Connect(授权码 + PKCE)登录。应用把 grant_type=authorization_code 提交到 POST /oauth/token,后续 /v1 调用发送 Authorization: Bearer <accessToken>。刷新使用 grant_type=refresh_token。
返回哪些候选人与简历字段?
GET /v1/me/profile 返回 encryptedCandidateId、firstName、lastName、email、phoneNumber 与 encryptedCurriculumId。GET /v1/me/resume 增加 skills、jobExperiences、education、certification、language 与简历可见性;文件上传至 POST /v1/me/resume/file。
投递与招聘方浏览在哪里?
投递为 POST /v1/ofertas/{jobId}/apply,含 killerQuestionAnswers。历史为 GET /v1/me/applications。招聘方兴趣为 GET /v1/me/profile-views(totalRecruiterViews、totalCompanies)。
与 OCC: Job Search 相似的应用
- Indeed Job Search — Indeed 是从企业招聘页和其他招聘网站聚合职位的搜索引擎,墨西哥求职者可用筛选、提醒和薪资区间查找岗位。
- LinkedIn: Community & Network — LinkedIn 是墨西哥职场人常用的职业社交网络,求职板块面向企业与中高级岗位,并支持招聘方主动联系与按资料匹配。
- Computrabajo — Computrabajo 是在墨西哥覆盖较广的拉美招聘平台,职位多集中在销售、客服、行政与物流,并提供应用内提醒。
- Bumeran México — Bumeran México 是 Jobint 的求职应用,求职者可上传简历、按领域和地点筛选职位,并与招聘方在应用内消息往来。
- Glassdoor | Jobs & Careers — Glassdoor 把职位列表与匿名员工评价、薪资信息放在一起,求职者可在投递前了解墨西哥雇主。
- CornerJob — CornerJob 是墨西哥常用的手机求职应用,面向临时与一线岗位,投递流程较短。
相关主题
- OCCMundial API
- OCC 职位搜索 API
- occ.com.mx 职位
- 候选人简历 API
- 招聘方浏览
- 墨西哥职位订阅
- OCC 投递端点
- OpenID Connect OCC
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业