openData StudioEnglish
Vagas de Emprego: Catho 图标

Catho 职位数据 API：搜索、简历与排名

Catho · 招聘求职

在 Google Play 中打开

Vagas de Emprego: Catho 是 Catho 面向巴西职位市场的 Android 客户端。设备会话在 POST /v1/auth/device-session 开始，返回 access_token/refresh_token；后续调用发送 Bearer，以及 X-Origin: app-android 和按服务选取的 X-Api-Key。职位搜索把筛选条件提交到 POST /v1/vacancies/query，返回带 job.id、title、activities、salary.range_description 与 hirer.name 的卡片；单条职位由 GET /v1/vacancies/{jobId}/expanded 加载。

候选人侧在 GET /v1/candidates/{userId}/card 读取资料（email、name、phone_number），在 GET /v1/curriculum/{resumeId} 读取简历，在 GET /v1/me/cv-viewers 查看招聘方浏览，并在 POST /v1/ranking/applicant-scores 取得 paying_position 与 non-paying_position。

Vagas de Emprego: Catho（包名 br.com.catho.app.vagas.empregos，版本 2.59.5-20260724_1600）是 Catho 面向巴西职位市场的 Android 客户端：候选人搜索职位、打开职位详情、用简历投递、查看招聘方浏览并与其他申请人比较排名。这些界面背后是第一方 JSON API。登录 POST /v1/auth/device-session 返回 access_token/refresh_token；后续调用发送 Authorization: Bearer，以及 X-Origin: app-android、platform: android 和按服务选取的 X-Api-Key。下列字段名（job_id、title、activities、salary.range_description、hirer.name、email、resumeId、paying_position）来自应用的 API 模型。

应用截图

  • Vagas de Emprego: Catho 应用截图 1
  • Vagas de Emprego: Catho 应用截图 2
  • Vagas de Emprego: Catho 应用截图 3
  • Vagas de Emprego: Catho 应用截图 4
  • Vagas de Emprego: Catho 应用截图 5
  • Vagas de Emprego: Catho 应用截图 6
  • Vagas de Emprego: Catho 应用截图 7
  • Vagas de Emprego: Catho 应用截图 8

API 端点一览

  • 设备会话登录

    POST /v1/auth/device-session osint

    用 login/password（及 client_id、code_challenge、redirect_uri 等 PKCE 字段）认证 Catho 求职者，返回后续 BFF 调用所用的 access_token 与 refresh_token。

    认证方式： 未认证的 PKCE 风格登录。响应中的 access_token/refresh_token 作为后续调用的 Bearer 会话。

    • client_id
    • code_challenge
    • code_challenge_method
    • login
    • password
    • provider
    • redirect_uri
    • response_type
    • state
    • token
    • access_token
    • refresh_token

    依据应用界面重构的示意示例，并非实时抓包。

    POST /v1/auth/device-session HTTP/1.1
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)

{
  "client_id": "catho-android",
  "code_challenge": "<code-challenge>",
  "code_challenge_method": "S256",
  "login": "[email protected]",
  "password": "******",
  "provider": "password",
  "redirect_uri": "com.catho.app://authorize-callback",
  "response_type": "code",
  "state": "<state>",
  "token": ""
}
    {
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>"
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据邮箱/密码设备登录界面及登录表单上的 PKCE 字段重建

  • 搜索职位广告

    POST /v1/vacancies/query opendata

    提交 Catho 职位搜索（keywords 及 city_id/state_id/salary_range_id/work_model 筛选），分页返回职位广告，含 title、activities、salary.range_description、hirer.name 与 isBookmarked。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。

    • query
    • keywords
    • filters
    • jobs
    • city_id
    • exclude_aggregator
    • hierarchical_level_id
    • ppd_profile_id
    • professional_area_id
    • profile_id
    • region_id
    • salary_range_id
    • segment_id
    • state_id
    • work_model
    • facets
    • fields
    • job_id
    • job_customized_data
    • score
    • browser
    • referrer
    • device
    • user
    • candidate_id
    • device_id
    • ip
    • subscriber
    • api
    • origin
    • service
    • sort_by
    • page
    • results_per_page
    • location_form
    • meta
    • type
    • total
    • jobAds
    • jobsExpanded
    • apply
    • isBookmarked
    • isReported
    • exclusiveFeatures
    • id
    • title
    • status
    • period
    • activities
    • entry_date
    • contracting_models
    • profiles
    • salary
    • value
    • range
    • range_description
    • is_confidential
    • benefits
    • positions
    • hirer
    • name
    • description
    • role
    • requirements
    • questions
    • disabilities
    • aggregated_job
    • ats_job
    • is_pandape
    • company_id_hash

    依据应用界面重构的示意示例，并非实时抓包。

    POST /v1/vacancies/query?sort_by=relevance&page=1&results_per_page=20&location_form=city HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)

{
  "query": {
    "keywords": "analista de dados",
    "filters": {
      "jobs": {
        "city_id": [
          347
        ],
        "exclude_aggregator": false,
        "hierarchical_level_id": [],
        "ppd_profile_id": [],
        "professional_area_id": [
          12
        ],
        "profile_id": 1,
        "region_id": [],
        "salary_range_id": [
          4
        ],
        "segment_id": [],
        "state_id": [
          26
        ],
        "work_model": [
          "hybrid"
        ]
      }
    }
  },
  "facets": [],
  "fields": [
    "job_id",
    "job_customized_data",
    "score"
  ],
  "browser": {
    "referrer": "com.catho.app",
    "device": "mobile"
  },
  "user": {
    "candidate_id": 8845123,
    "device_id": "<device_id>",
    "ip": "177.92.0.1",
    "subscriber": true
  },
  "api": {
    "origin": "catho_search",
    "service": "search"
  }
}
    {
  "meta": {
    "page": 1,
    "type": "job_ad",
    "total": {
      "jobAds": 1284,
      "jobs": 980
    }
  },
  "jobs": [
    {
      "apply": {
        "applyCount": 0
      },
      "isBookmarked": false,
      "isReported": false,
      "exclusiveFeatures": null,
      "job": {
        "id": 71225000123,
        "title": "Analista de Dados Pleno",
        "status": "published",
        "period": "full_time",
        "activities": "Modelar dashboards e pipelines de dados em São Paulo.",
        "entry_date": "2026-09-20",
        "contracting_models": [
          {
            "id": 1,
            "name": "CLT"
          }
        ],
        "profiles": [
          "PROFESSIONAL"
        ],
        "salary": {
          "value": 8500.0,
          "range": "7000-9000",
          "range_description": "R$ 7.000 a R$ 9.000",
          "is_confidential": false
        },
        "benefits": [
          {
            "name": "VR"
          }
        ],
        "positions": [
          {
            "city": "São Paulo",
            "state": "SP",
            "quantity": 2
          }
        ],
        "hirer": {
          "name": "Example Corp",
          "description": "Empresa de tecnologia",
          "is_confidential": false
        },
        "role": {
          "id": 441,
          "name": "Analista de Dados",
          "profile": "PROFESSIONAL"
        },
        "requirements": {
          "experience": "3 a 5 anos"
        },
        "questions": [],
        "disabilities": {},
        "aggregated_job": null,
        "ats_job": false,
        "is_pandape": false,
        "company_id_hash": "c-hash-441"
      }
    }
  ],
  "jobsExpanded": []
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据职位搜索筛选（城市、薪资、工作模式）与结果卡片重建

  • 获取扩展职位详情

    GET /v1/vacancies/{jobId}/expanded opendata

    按 jobId 加载单条扩展职位：title、activities、salary、hirer、questions 以及 apply/isBookmarked 标志，供职位详情屏使用。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。

    • apply
    • isBookmarked
    • isReported
    • exclusiveFeatures
    • job
    • id
    • title
    • status
    • period
    • activities
    • entry_date
    • contracting_models
    • profiles
    • salary
    • value
    • range
    • range_description
    • is_confidential
    • benefits
    • positions
    • hirer
    • name
    • description
    • role
    • requirements
    • questions
    • disabilities
    • aggregated_job
    • ats_job
    • is_pandape
    • company_id_hash

    依据应用界面重构的示意示例，并非实时抓包。

    GET /v1/vacancies/71225000123/expanded HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)
    {
  "apply": {
    "applyCount": 1
  },
  "isBookmarked": true,
  "isReported": false,
  "exclusiveFeatures": {
    "highlighted": true
  },
  "job": {
    "id": 71225000123,
    "title": "Analista de Dados Pleno",
    "status": "published",
    "period": "full_time",
    "activities": "Modelar dashboards e pipelines de dados em São Paulo.",
    "entry_date": "2026-09-20",
    "contracting_models": [
      {
        "id": 1,
        "name": "CLT"
      }
    ],
    "profiles": [
      "PROFESSIONAL"
    ],
    "salary": {
      "value": 8500.0,
      "range": "7000-9000",
      "range_description": "R$ 7.000 a R$ 9.000",
      "is_confidential": false
    },
    "benefits": [
      {
        "name": "VR"
      },
      {
        "name": "Plano de saúde"
      }
    ],
    "positions": [
      {
        "city": "São Paulo",
        "state": "SP",
        "quantity": 2
      }
    ],
    "hirer": {
      "name": "Example Corp",
      "description": "Empresa de tecnologia",
      "is_confidential": false
    },
    "role": {
      "id": 441,
      "name": "Analista de Dados",
      "profile": "PROFESSIONAL"
    },
    "requirements": {
      "experience": "3 a 5 anos"
    },
    "questions": [
      {
        "id": 11,
        "text": "Tem disponibilidade para híbrido?"
      }
    ],
    "disabilities": {},
    "aggregated_job": null,
    "ats_job": false,
    "is_pandape": false,
    "company_id_hash": "c-hash-441"
  }
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据展开单条职位的详情界面重建

  • 投递职位

    POST /v1/vacancies/{jobId}/applications opendata

    提交候选人对某职位的投递（resumeId 与 questionnaireAnswers），返回 applyCount、applyDate、jobAdId 与 postApplySnackbar。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。 投递调用另带 client_id 请求头。

    • userId
    • jobId
    • device_apply
    • entrada_apply
    • origem_apply
    • canal_apply
    • acao_apply
    • other
    • resumeId
    • questionnaireAnswers
    • chargedApply
    • applyCount
    • applyDate
    • jobAdId
    • presentationLetter
    • postApplySnackbar

    依据应用界面重构的示意示例，并非实时抓包。

    POST /v1/vacancies/71225000123/applications?device_apply=android&entrada_apply=job_detail&origem_apply=search&canal_apply=app&acao_apply=apply HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)
client_id: 123123123

{
  "resumeId": 44189012,
  "questionnaireAnswers": [
    {
      "questionId": 11,
      "answer": "Sim"
    }
  ],
  "chargedApply": null
}
    {
  "applyCount": 1,
  "applyDate": 1758902400000,
  "resumeId": 44189012,
  "jobAdId": 71225000123,
  "presentationLetter": null,
  "postApplySnackbar": {
    "title": "Candidatura enviada"
  }
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据提交 resumeId 的投递确认流程重建

  • 列出投递历史

    GET /v1/me/application-pipeline opendata

    按 lastItem 游标与 jobAdStatus 分页返回投递流水（totalApplies 及 applies[].apply / applies[].jobAd），供「我的投递」屏使用。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。

    • lastItem
    • origin
    • jobAdStatus
    • totalApplies
    • applies
    • apply
    • applyCount
    • applyDate
    • resumeId
    • jobAdId
    • jobAd
    • id
    • title
    • status

    依据应用界面重构的示意示例，并非实时抓包。

    GET /v1/me/application-pipeline?lastItem=0&origin=app&jobAdStatus=all HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)
    {
  "totalApplies": 12,
  "applies": [
    {
      "apply": {
        "applyCount": 1,
        "applyDate": 1758902400000,
        "resumeId": 44189012,
        "jobAdId": 71225000123
      },
      "jobAd": {
        "id": 71225000123,
        "title": "Analista de Dados Pleno",
        "status": "published"
      }
    }
  ]
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据「我的投递」历史界面重建

  • 加载候选人首页 BFF

    GET /v1/me/home-feed opendata

    返回已登录候选人首页载荷：acl 开关、communication 未读、resume 完整度、suggestion 职位卡片、user 与 campaign 区块。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。

    • action
    • acl
    • ads
    • communication
    • hiring-process
    • resume
    • suggestion
    • user
    • campaign
    • userParameters

    依据应用界面重构的示意示例，并非实时抓包。

    GET /v1/me/home-feed?action=open HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)
    {
  "acl": {
    "canApply": true,
    "isSubscriber": true
  },
  "ads": {
    "slots": []
  },
  "communication": {
    "unread": 3
  },
  "hiring-process": {
    "active": 1
  },
  "resume": {
    "resumeId": 44189012,
    "completeness": 82
  },
  "suggestion": [
    {
      "id": 71225000123,
      "title": "Analista de Dados Pleno",
      "entry_date": "2026-09-20"
    }
  ],
  "user": {
    "id": 8845123,
    "name": "Ana Silva"
  },
  "campaign": {
    "id": "home-sep"
  },
  "userParameters": {
    "profileId": 1
  }
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据已登录候选人首页仪表盘重建

  • 获取候选人资料

    GET /v1/candidates/{userId}/card osint

    读取已登录候选人名片：id、name、email、phone_number（cellPhone/phone）、photo 以及 address.city/state。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。 此调用还发送带 ReasonEnum 的 x-audit-info。

    • id
    • profile_id
    • name
    • email
    • photo
    • phone_number
    • number
    • type
    • address
    • city
    • state

    依据应用界面重构的示意示例，并非实时抓包。

    GET /v1/candidates/8845123/card HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)
x-audit-info: <base64-audit-info>
    {
  "id": 8845123,
  "profile_id": 1,
  "name": "Ana Silva",
  "email": "[email protected]",
  "photo": "ana.jpg",
  "phone_number": [
    {
      "number": "11987654321",
      "type": "cellPhone"
    },
    {
      "number": "1133334444",
      "type": "phone"
    }
  ],
  "address": {
    "city": "São Paulo",
    "state": "SP"
  }
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据候选人名片（邮箱、电话、地址）重建

  • 按 resumeId 获取简历

    GET /v1/curriculum/{resumeId} osint

    返回候选人简历信封（data），含 resumeId、profileName、goal、educations、experiences、resumeSkills 与 salaryRange，供简历屏使用。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。 简历调用另带 api-client-id、client_id 与 x-audit-info。

    • data
    • resumeId
    • userId
    • profileId
    • profileName
    • goal
    • goalId
    • miniResume
    • default
    • salaryRange
    • specializations
    • educations
    • experiences
    • resumeSkills
    • resumeCourseComps
    • resumeHierarchicalLevels
    • resumeProfessionalAreas
    • resumeControl

    依据应用界面重构的示意示例，并非实时抓包。

    GET /v1/curriculum/44189012 HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)
x-audit-info: <base64-audit-info>
api-client-id: 2
client_id: 123123123
    {
  "data": {
    "resumeId": 44189012,
    "userId": 8845123,
    "profileId": 1,
    "profileName": "Analista de Dados",
    "goal": "Atuar com analytics em São Paulo",
    "goalId": 88,
    "miniResume": "5 anos em BI e SQL.",
    "default": true,
    "salaryRange": 4,
    "specializations": "Python, SQL",
    "educations": [
      {
        "course": "Estatística",
        "institution": "USP"
      }
    ],
    "experiences": [
      {
        "company": "Example Corp",
        "role": "Analista Jr"
      }
    ],
    "resumeSkills": [
      {
        "name": "SQL"
      }
    ],
    "resumeCourseComps": [],
    "resumeHierarchicalLevels": [
      {
        "id": 2
      }
    ],
    "resumeProfessionalAreas": [
      {
        "id": 12
      }
    ],
    "resumeControl": {
      "showSalaryRange": 1
    }
  }
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据简历界面（教育、经历、技能）重建

  • 列出招聘方浏览简历记录

    GET /v1/me/cv-viewers osint

    按 resumeViewType 分页返回谁浏览过候选人简历：resumeViews 含 hirerName、isConfidentialCompany、lastSeen 与浏览次数 total。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。

    • page
    • resumeViewType
    • title
    • description
    • total
    • pagination
    • resumeViews
    • hirerName
    • isConfidentialCompany
    • lastSeen
    • site
    • companyActivities

    依据应用界面重构的示意示例，并非实时抓包。

    GET /v1/me/cv-viewers?page=1&resumeViewType=all HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)
    {
  "title": "Quem viu seu currículo",
  "description": "Empresas que visualizaram seu CV",
  "total": 18,
  "pagination": {
    "page": 1,
    "pageSize": 10
  },
  "resumeViews": [
    {
      "hirerName": "Example Corp",
      "description": "Visualizou seu currículo",
      "isConfidentialCompany": false,
      "lastSeen": "2026-09-24T12:00:00Z",
      "site": "https://www.example.com",
      "total": 3,
      "companyActivities": [
        {
          "name": "Tecnologia"
        }
      ]
    }
  ]
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据「谁看过你的简历」招聘方浏览列表重建

  • 在申请人中排名简历

    POST /v1/ranking/applicant-scores opendata

    按 job_id 将候选人简历与其他申请人比较，返回 paying_position 与 non-paying_position、score 及 total_of_cvs。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。

    • items
    • origin
    • candidate_id
    • job_id
    • cv_profile_id
    • errors
    • meta
    • positions
    • non-paying_position
    • paying_position
    • score
    • total_of_cvs

    依据应用界面重构的示意示例，并非实时抓包。

    POST /v1/ranking/applicant-scores HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)

{
  "items": [
    {
      "candidate_id": "8845123",
      "job_id": "71225000123",
      "cv_profile_id": "1"
    }
  ],
  "origin": "modal-pos-apply-android"
}
    {
  "errors": [],
  "meta": {
    "count": 1
  },
  "positions": [
    {
      "candidate_id": "8845123",
      "cv_profile_id": "1",
      "job_id": "71225000123",
      "non-paying_position": 42,
      "paying_position": 8,
      "score": 0.81,
      "total_of_cvs": 186
    }
  ]
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据投递后排名弹窗（付费/非付费名次）重建

  • 列出候选人与招聘方聊天

    GET /v1/inbox/recruiter-threads opendata

    分页返回候选人收件箱（page、itensPerPage）：chats 含 chatId、title、unread、lastMessage 与 recipient，供招聘方聊天使用。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。

    • page
    • itensPerPage
    • meta
    • chats
    • chatId
    • isChatBlocked
    • title
    • unread
    • lastMessage
    • recipient

    依据应用界面重构的示意示例，并非实时抓包。

    GET /v1/inbox/recruiter-threads?page=1&itensPerPage=20 HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)
    {
  "meta": {
    "page": 1,
    "total": 6
  },
  "chats": [
    {
      "chatId": 90011,
      "isChatBlocked": false,
      "title": "Analista de Dados Pleno",
      "unread": 2,
      "lastMessage": {
        "text": "Podemos agendar uma entrevista?",
        "messageTime": 1758902400
      },
      "recipient": {
        "name": "Carla Mendes",
        "company": {
          "name": "Example Corp",
          "logo": "https://cdn.example.com/logo.png"
        }
      }
    }
  ]
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据招聘方聊天收件箱重建

  • 列出收藏的职位

    GET /v1/me/saved-vacancies opendata

    按 userId 分页返回收藏职位 job_ads，以及 pagination.itens_per_page/total_itens，供收藏屏使用。

    认证方式： 来自 POST /v1/auth/device-session 的 Bearer access_token。已登录调用还发送 X-Origin: app-android、platform: android、Content-Type/Accept: application/json、Cache-Control: no-cache，以及按服务选取的 X-Api-Key。 若带 x-audit-info，客户端会替换为含公开 IP 的 base64 JSON 审计块。

    • page
    • job_ads
    • id
    • title
    • status
    • entry_date
    • company_id_hash
    • is_pandape
    • has_questions
    • pagination
    • itens_per_page
    • total_itens

    依据应用界面重构的示意示例，并非实时抓包。

    GET /v1/me/saved-vacancies?page=1 HTTP/1.1
Authorization: Bearer <access_token>
X-Origin: app-android
platform: android
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
X-Api-Key: <service-api-key>
User-Agent: Catho/2.59.5 (Android)
    {
  "job_ads": [
    {
      "id": 71225000123,
      "title": "Analista de Dados Pleno",
      "status": "published",
      "entry_date": "2026-09-20",
      "company_id_hash": "c-hash-441",
      "is_pandape": false,
      "has_questions": true
    }
  ],
  "pagination": [
    {
      "itens_per_page": 10,
      "total_itens": 7
    }
  ]
}

    依据应用界面推导；端点细节为示意说明，并非实际抓包。

    • 依据收藏/保存职位界面重建

数据类别

  • 职位列表
  • 职位详情
  • 投递
  • 候选人资料
  • 简历
  • 招聘方浏览
  • 排名
  • 消息
  • 登录会话

数据使用场景与案例

  • 巴西职位市场普查

    夜间任务按城市、州、薪资区间与工作模式筛选巴西职位，并保存职位标题、职责描述、薪资区间文本与雇主名称，以跟踪圣保罗等都市的 CLT 与混合办公需求。

  • 候选人 CRM 补全

    招聘 CRM 在设备登录后读取候选人名片与简历，保存邮箱、姓名、电话、教育与经历，使外联与候选人已在 Catho 维护的简历一致。

  • 招聘方浏览监测

    职业顾问分页查看谁浏览过候选人简历，记录雇主名称、保密公司标志、最近浏览时间与浏览次数，以便跟进已打开简历的雇主。

  • 投递漏斗排名

    ATS 机器人用 resumeId 提交投递后，读取该职位的付费/非付费排名、分数与简历总数，从而在内部漏斗中标出流失投递与付费提升差距。

常见问题

Catho Vagas 数据 API 暴露哪些能力？

带城市/州/薪资/工作模式筛选的分页职位搜索、职位详情、投递与投递历史、已登录候选人资料与简历、招聘方浏览简历记录、相对其他申请人的简历排名、招聘方聊天与收藏职位。

职位与简历 API 如何鉴权？

应用在 POST /v1/auth/device-session 用 login/password 与 PKCE 字段登录，随后发送 Authorization: Bearer，以及 X-Origin: app-android、platform: android 和按服务选取的 X-Api-Key。部分用户/简历调用还发送 x-audit-info。

哪些字段标识职位与候选人？

职位使用 job.id、title、activities、salary.range_description、hirer.name 与 company_id_hash。候选人资料使用 id、email、name、phone_number 与 address；简历使用 resumeId、profileName、educations 与 experiences。

应用是否提供招聘方可见性与排名？

是。GET /v1/me/cv-viewers 返回 hirerName、lastSeen 与 isConfidentialCompany；POST /v1/ranking/applicant-scores 返回 paying_position、non-paying_position、score 与 total_of_cvs。

更多招聘求职类应用

相关主题

  • catho 职位 api
  • br.com.catho.app.vagas.empregos 端点
  • catho 职位搜索 api
  • catho 职位查询
  • 候选人简历 email
  • paying_position
  • 简历浏览
  • catho 投递 api

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

  • 每个项目均签 NDA 与 SOW
  • 3–7 天交付
  • 验收通过后才付款
  • 仅在授权范围内作业

获取报价