Bumeran 数据 API:招聘广告、简历与投递
Bumeran(Play 标题 Bumeran: búsqueda de empleo)是 Jobint 面向西语拉美的求职应用,主场在阿根廷。邮箱登录并完成双因素验证码后,求职者可按关键词、省份与市镇搜索分类广告,打开完整职位,用内置简历投递,跟踪每条申请的筛选状态,收藏广告,跟进推荐职位,与招聘方聊天,扫描职场二维码现场投递,并使用税前到税后薪资计算器。Jobint(布宜诺斯艾利斯 Arévalo 1880)还运营区域内的姊妹分类板;Android 上约 13.3 万条评价给出 4.6 分,下载量 500 万+。它与墨西哥 OCC、西班牙 InfoJobs、巴西 Catho 同属分类招聘板,而不是自由职业市场。
每条招聘广告带有 avisoId、titulo、nombreEmpresa、salarioMinimo、salarioMaximo、localidad 与 fechaPublicacion。投递以 postulacionId 为键,含 fechaPostulacion 与 estadoPostulacion;简历存放 nombre、apellido、educacion、experiencia 与 idioma。计算器把 sueldoBruto 换成 sueldoNeto,对照 salarioPretendido。
ATS 与职业辅导产品拉取 Jobint 已经展示给求职者的同一套职位、投递与简历行——openData Studio 把这条招聘闭环变成可调用的开放数据。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
发送双因素登录验证码
POST
/v1/bumeran/otposint向邮箱发送登录界面在签发 accessToken 前使用的双因素 codigo。
认证方式: 无需登录。请求体为求职者 email。返回的 codigo 提交给 POST /v1/bumeran/login。
- codigoEnviado
- ttlSeconds
POST /v1/bumeran/otp HTTP/1.1 Content-Type: application/json { "email": "[email protected]" }{ "email": "[email protected]", "codigoEnviado": true, "ttlSeconds": 300 }用验证码换取会话
POST
/v1/bumeran/loginosint用 email 加双因素 codigo 换取后续职位、投递与简历请求使用的 accessToken 与 refreshToken。
认证方式: 无需登录。请求体为 email 以及 POST /v1/bumeran/otp 得到的 codigo。返回的 accessToken 作为后续请求的 Authorization: Bearer。LinkedIn OAuth 是落到同一对令牌的备选登录。
- codigo
- accessToken
- refreshToken
- tokenType
- expiresIn
POST /v1/bumeran/login HTTP/1.1 Content-Type: application/json { "email": "[email protected]", "codigo": "482193" }{ "accessToken": "eyJhbGciOi...", "refreshToken": "rt-9c11ab", "tokenType": "Bearer", "expiresIn": 3600, "email": "[email protected]" }搜索招聘广告
GET
/v1/bumeran/avisosopendata返回搜索结果页使用的职位列表:titulo、nombreEmpresa、salarioMinimo/salarioMaximo、localidad 与分页。
认证方式: 可选的 Bearer accessToken,来自 POST /v1/bumeran/login。匿名搜索仍可分页;登录调用会个性化已收藏与已投递标记。
- page
- total
- avisos
- avisoId
- titulo
- nombreEmpresa
- logoURL
- salarioMinimo
- salarioMaximo
- tipoTrabajo
- modalidadTrabajo
- nivelLaboral
- areaId
- subAreaId
- idProvincia
- provincia
- idLocalidad
- localidad
- fechaPublicacion
- cantidadVacantes
- cantidadPostulaciones
GET /v1/bumeran/avisos?query=analista+de+datos&idProvincia=1&idLocalidad=14&areaId=5&page=1 HTTP/1.1 Authorization: Bearer eyJhbGciOi... Accept: application/json{ "page": 1, "total": 842, "avisos": [ { "avisoId": "8859410", "titulo": "Analista de datos", "nombreEmpresa": "Estudio Norte SA", "logoURL": "https://cdn.example.com/logos/norte.png", "salarioMinimo": 850000, "salarioMaximo": 1200000, "tipoTrabajo": "Full-time", "modalidadTrabajo": "Híbrido", "nivelLaboral": "Semi Senior", "areaId": 5, "subAreaId": 18, "idProvincia": 1, "provincia": "Buenos Aires", "idLocalidad": 14, "localidad": "CABA", "fechaPublicacion": "2026-09-28T11:04:00Z", "cantidadVacantes": 2, "cantidadPostulaciones": 37 } ] }首页推荐广告
GET
/v1/bumeran/avisos/homeopendata在键入搜索前为首页推荐职位卡片供水。
认证方式: 可选的 Bearer accessToken。登录调用按求职者简历排序卡片;匿名首页仍返回默认信息流。
- page
- avisos
- avisoId
- titulo
- nombreEmpresa
- salarioMinimo
- salarioMaximo
- localidad
- fechaPublicacion
GET /v1/bumeran/avisos/home?page=1 HTTP/1.1 Authorization: Bearer eyJhbGciOi... Accept: application/json{ "page": 1, "avisos": [ { "avisoId": "8859502", "titulo": "Desarrollador backend", "nombreEmpresa": "Fintech Sur", "salarioMinimo": 900000, "salarioMaximo": 1400000, "localidad": "CABA", "fechaPublicacion": "2026-09-29T08:12:00Z" } ] }与当前职位相似的广告
GET
/v1/bumeran/avisos/{avisoId}/similaresopendata为职位详情轮播返回相似职位,以打开的 avisoId 为键。
认证方式: 可选的 Bearer accessToken。已隐藏广告在展示前被过滤。
- avisoId
- similares
- titulo
- nombreEmpresa
- localidad
- salarioMinimo
- salarioMaximo
GET /v1/bumeran/avisos/8859410/similares?limit=6 HTTP/1.1 Authorization: Bearer eyJhbGciOi... Accept: application/json{ "avisoId": "8859410", "similares": [ { "avisoId": "8859601", "titulo": "Data analyst Jr", "nombreEmpresa": "Consultora Andes", "localidad": "Córdoba", "salarioMinimo": 700000, "salarioMaximo": 950000 } ] }投递招聘广告
POST
/v1/bumeran/postularosint针对 avisoId 创建一条 postulacion,可附带 salarioPretendido,返回 postulacionId 与 estadoPostulacion。
认证方式: Authorization: Bearer accessToken,来自 POST /v1/bumeran/login。请求体标明要投递的 avisoId。
- avisoId
- salarioPretendido
- postulacionId
- fechaPostulacion
- estadoPostulacion
POST /v1/bumeran/postular HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "avisoId": "8859410", "salarioPretendido": 1100000 }{ "postulacionId": "p-441902", "avisoId": "8859410", "fechaPostulacion": "2026-10-02T14:22:11Z", "estadoPostulacion": "enviada", "salarioPretendido": 1100000 }列出我的投递
GET
/v1/bumeran/postulacionesosint为“我的投递”界面分页返回带 estadoPostulacion 与 fechaPostulacion 的申请历史。
认证方式: Authorization: Bearer accessToken,来自 POST /v1/bumeran/login。
- page
- postulaciones
- postulacionId
- avisoId
- titulo
- nombreEmpresa
- fechaPostulacion
- estadoPostulacion
- salarioPretendido
GET /v1/bumeran/postulaciones?page=1 HTTP/1.1 Authorization: Bearer eyJhbGciOi... Accept: application/json{ "page": 1, "postulaciones": [ { "postulacionId": "p-441902", "avisoId": "8859410", "titulo": "Analista de datos", "nombreEmpresa": "Estudio Norte SA", "fechaPostulacion": "2026-10-02T14:22:11Z", "estadoPostulacion": "en-seleccion", "salarioPretendido": 1100000 } ] }投递筛选状态
GET
/v1/bumeran/postulaciones/estadososint返回用于过滤“我的投递”的筛选状态目录。
认证方式: Authorization: Bearer accessToken,来自 POST /v1/bumeran/login。
- estados
- estadoPostulacion
- label
GET /v1/bumeran/postulaciones/estados HTTP/1.1 Authorization: Bearer eyJhbGciOi... Accept: application/json{ "estados": [ {"estadoPostulacion": "enviada", "label": "Enviada"}, {"estadoPostulacion": "en-seleccion", "label": "En selección"}, {"estadoPostulacion": "finalista", "label": "Finalista"} ] }读取我的简历
GET
/v1/bumeran/curriculumosint返回投递时使用的登录简历:nombre/apellido、educacion、experiencia、idioma 与 skills。
认证方式: Authorization: Bearer accessToken,来自 POST /v1/bumeran/login。
- nombre
- apellido
- telefono
- fechaNacimiento
- nacionalidad
- genero
- estadoCivilId
- idProvincia
- idLocalidad
- educacion
- institucion
- titulo
- fechaInicio
- fechaFin
- experiencia
- nombreEmpresa
- puesto
- idioma
- skills
GET /v1/bumeran/curriculum HTTP/1.1 Authorization: Bearer eyJhbGciOi... Accept: application/json{ "nombre": "Ana", "apellido": "García", "email": "[email protected]", "telefono": "+54 11 5555 0101", "fechaNacimiento": "1994-03-12", "nacionalidad": "Argentina", "genero": "F", "estadoCivilId": 1, "idProvincia": 1, "idLocalidad": 14, "educacion": [{"institucion": "UBA", "titulo": "Lic. en Economía", "fechaInicio": "2013-03-01", "fechaFin": "2018-12-15"}], "experiencia": [{"nombreEmpresa": "Estudio Norte SA", "puesto": "Analista Jr", "fechaInicio": "2019-02-01", "fechaFin": null}], "idioma": [{"idioma": "Inglés", "nivel": "Avanzado"}], "skills": ["SQL", "Python"] }建议的简历技能
GET
/v1/bumeran/curriculum/skillsopendata为简历编辑器中可钉上的技能提供输入联想。
认证方式: Authorization: Bearer accessToken,来自 POST /v1/bumeran/login。
- skills
- query
GET /v1/bumeran/curriculum/skills?query=sql HTTP/1.1 Authorization: Bearer eyJhbGciOi... Accept: application/json{ "skills": ["SQL", "SQL Server", "PostgreSQL"] }已收藏招聘广告
GET
/v1/bumeran/avisos/guardadososint列出求职者在收藏界面星标过的广告。
认证方式: Authorization: Bearer accessToken,来自 POST /v1/bumeran/login。
- page
- avisos
- avisoId
- titulo
- nombreEmpresa
- localidad
GET /v1/bumeran/avisos/guardados?page=1 HTTP/1.1 Authorization: Bearer eyJhbGciOi... Accept: application/json{ "page": 1, "avisos": [ { "avisoId": "8859410", "titulo": "Analista de datos", "nombreEmpresa": "Estudio Norte SA", "localidad": "CABA" } ] }企业名录
GET
/v1/bumeran/empresasopendata为“热搜企业”界面分页返回企业名录。
认证方式: 可选的 Bearer accessToken。名录可不登录翻页;登录调用可标记已关注企业。
- page
- empresas
- idEmpresa
- nombreEmpresa
- logoURL
- cantidadVacantes
GET /v1/bumeran/empresas?page=1&pageSize=20 HTTP/1.1 Authorization: Bearer eyJhbGciOi... Accept: application/json{ "page": 1, "empresas": [ { "idEmpresa": "co-441", "nombreEmpresa": "Estudio Norte SA", "logoURL": "https://cdn.example.com/logos/norte.png", "cantidadVacantes": 12 } ] }省份目录
GET
/v1/bumeran/geo/provincesopendata返回地点筛选使用的省份目录。
认证方式: 无需登录。用于在搜索前填充省份选择器。
- provincias
- idProvincia
- provincia
GET /v1/bumeran/geo/provinces HTTP/1.1 Accept: application/json{ "provincias": [ {"idProvincia": 1, "provincia": "Buenos Aires"}, {"idProvincia": 2, "provincia": "Córdoba"} ] }按省列出市镇
GET
/v1/bumeran/geo/provinces/{idProvincia}/localitiesopendata返回所选 idProvincia 下的市镇,以便搜索筛选收窄到城市。
认证方式: 无需登录。在选定省份后使用。
- idProvincia
- localidades
- idLocalidad
- localidad
GET /v1/bumeran/geo/provinces/1/localities HTTP/1.1 Accept: application/json{ "idProvincia": 1, "localidades": [ {"idLocalidad": 14, "localidad": "CABA"}, {"idLocalidad": 22, "localidad": "La Plata"} ] }税前到税后薪资
GET
/v1/bumeran/salary/netopendata把键入的 sueldoBruto 换成薪资计算器弹层上展示的 sueldoNeto。
认证方式: 无需登录的计算器。查询参数为薪资界面键入的税前数字。
- sueldoBruto
- sueldoNeto
- salarioPretendido
GET /v1/bumeran/salary/net?salarioBruto=1100000 HTTP/1.1 Accept: application/json{ "sueldoBruto": 1100000, "sueldoNeto": 912450, "salarioPretendido": 1100000 }
数据类别
- 招聘广告
- 投递申请
- 简历
- 企业
- 地点
- 薪资
- 登录会话
数据使用场景与案例
阿根廷职位接入 ATS
轮询 GET /v1/bumeran/avisos(query、idProvincia、areaId),再用 GET /v1/bumeran/avisos/{avisoId}/similares 水合相似卡片,以便申请人跟踪系统镜像 titulo、nombreEmpresa、salarioMinimo 与 salarioMaximo。
按筛选状态跟踪投递管道
把 GET /v1/bumeran/postulaciones(postulacionId、fechaPostulacion、estadoPostulacion)与 GET /v1/bumeran/postulaciones/estados 连接,以便职业产品展示哪些投递从 enviada 进入 en-seleccion。
投递前的简历完整度
读取 GET /v1/bumeran/curriculum(nombre、educacion、experiencia、idioma、skills)与 GET /v1/bumeran/curriculum/skills,以便辅导产品指出 POST /v1/bumeran/postular 为何会显得单薄。
税前到税后的报价核对
把键入的 sueldoBruto 交给 GET /v1/bumeran/salary/net,在求职者接受薪资区间前把 sueldoNeto 与投递体里的 salarioPretendido 对照。
常见问题
Bumeran 如何认证 API 调用?
POST /v1/bumeran/otp 向求职者邮箱发送双因素 codigo。POST /v1/bumeran/login 用 email 加该 codigo 换取 accessToken 与 refreshToken。之后的请求以 accessToken 发送 Authorization: Bearer。LinkedIn OAuth 是落到同一对令牌的备选登录。
哪些端点暴露招聘广告与投递?
GET /v1/bumeran/avisos 返回 avisoId、titulo、nombreEmpresa、salarioMinimo、salarioMaximo、localidad 与 fechaPublicacion。GET /v1/bumeran/avisos/home 填充首页信息流;GET /v1/bumeran/avisos/{avisoId}/similares 排序邻近广告。POST /v1/bumeran/postular 创建 postulacionId;GET /v1/bumeran/postulaciones 按 estadoPostulacion 列出它们。
返回哪些简历字段?
GET /v1/bumeran/curriculum 返回 nombre、apellido、email、telefono、fechaNacimiento、educacion(institucion、titulo、fechaInicio、fechaFin)、experiencia(nombreEmpresa、puesto)与 idioma。GET /v1/bumeran/curriculum/skills 为可钉上的技能提供输入联想。
API 能否看到企业、地点与到手薪?
可以。GET /v1/bumeran/empresas 分页 idEmpresa 与 nombreEmpresa。GET /v1/bumeran/geo/provinces 与 GET /v1/bumeran/geo/provinces/{idProvincia}/localities 填充地点筛选。GET /v1/bumeran/salary/net 把 sueldoBruto 换成 sueldoNeto。
与 Bumeran 相似的应用
- OCC: Job Search — OCCMundial 是墨西哥的分类招聘板:职位搜索、简历、投递与招聘方浏览界面。
- InfoJobs - Job Search — InfoJobs 是 Adevinta 的西班牙招聘板:按省与远程筛选职位、用简历投递并跟踪申请。
- Vagas de Emprego: Catho — Catho 是巴西招聘板,含简历、排序分数与招聘方收件箱线程。
- Indeed Job Search — Indeed 是全球求职应用:关键词搜索、投递、申请状态与招聘方消息。
- Computrabajo — Computrabajo 是拉美通用的西语分类招聘板,与 Bumeran 的求职闭环重叠。
- LinkedIn: Community & Network — LinkedIn 是职业社交网络,Bumeran 也将其作为备选 OAuth 登录。
- Glassdoor | Jobs & Careers — Glassdoor 把职位搜索与雇主评价、薪资估算放在一起,邻近 Bumeran 的净薪计算器。
相关主题
- bumeran api
- bumeran 数据 api
- avisoId salarioMinimo postulacionId
- jobint bumeran
- 阿根廷招聘 api
- bumeran 简历 educacion
- sueldoBruto sueldoNeto
- bumeran postulaciones
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业