France Travail 数据 API：职位、投递与简历

France Travail · 招聘求职 4.6 ★

Parcours Emploi（Play 标题 Parcours Emploi France Travail，原 Mes Offres）是 France Travail 面向已在公共就业服务登记者的官方求职应用。通过 France Connect / PEAM 登录后，求职者可按关键词、合同类型与地点搜索全国职位，打开完整岗位，用已存简历投递，跟踪每条 candidature，维护名片，跟进招聘方邀请（AMI），与顾问消息往来，预约机构面谈，登记求职 démarches 并查看津贴 indemnisation。France Travail 位于巴黎 20 区 Docteur Gley 大街 1 号 Le Cinetic；Android 上约 12.8 万条评价给出 4.6 分，下载量 500 万+。它是国家职位板而不是私营分类市场，与西班牙 InfoJobs、巴西 Catho 同属国家级求职客户端。

每条职位带有 idOffre、intitule、typeContrat、salaire、nomEntreprise、siret 与 codeROME。投递以 candidatureDetail 为键，含 statut；简历存放为 idGed 与 nomFichier。顾问区块加上 idConseiller 与 indemnisation，对照日程行。

ATS 与个案管理产品拉取 France Travail 已经展示给求职者的同一套职位、投递与津贴行——openData Studio 把这条公共就业闭环变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

PEAM OpenID 授权
GET /v1/francetravail/oauth/authorize osint
启动 PEAM OpenID 登录，得到随后换取 access_token 的授权码。
认证方式：无需登录的浏览器起步。查询参数为 client_id、redirect_uri、response_type=code、scope=openid 与 state。PEAM 页面把授权码回跳到 peam-usager://success。
- client_id
- redirect_uri
- response_type
- scope
- state
- code
```
GET /v1/francetravail/oauth/authorize?client_id=USG_PN062-MESOFFRESMOBILE_SSO&redirect_uri=peam-usager%3A%2F%2Fsuccess&response_type=code&scope=openid&state=st-9c11ab HTTP/1.1
Accept: text/html
```
```
HTTP/1.1 302 Found
Location: peam-usager://success?code=SplxlOBeZQQYbYS6WxSbIA&state=st-9c11ab
```
用授权码换取 access token
POST /v1/francetravail/oauth/token osint
用 PEAM 授权码换取后续职位、投递与顾问请求使用的 access_token。
认证方式：无需登录。请求体为 GET /v1/francetravail/oauth/authorize 得到的授权码。返回的 access_token 作为后续请求的 Authorization: Bearer。
- grant_type
- code
- redirect_uri
- client_id
- access_token
- token_type
- expires_in
- scope
```
POST /v1/francetravail/oauth/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&code=SplxlOBeZQQYbYS6WxSbIA&redirect_uri=peam-usager%3A%2F%2Fsuccess&client_id=USG_PN062-MESOFFRESMOBILE_SSO
```
```
{
  "access_token": "eyJhbGciOi...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "openid"
}
```

搜索职位

GET /v1/francetravail/offres opendata

返回搜索结果页使用的职位列表：intitule、typeContrat、salaire、lieuTravail 与分页。

认证方式：可选的 Bearer access_token，来自 POST /v1/francetravail/oauth/token。匿名搜索仍可分页；登录调用会个性化已收藏与已投递标记。

resultats
idOffre
intitule
typeContrat
natureOffre
salaire
salaireMin
nomEntreprise
siret
lieuTravail
codePostal
libelleCommune
codeROME
dateCreation
dateActualisation
filtresPossibles

GET /v1/francetravail/offres?motsCles=developpeur&typeContrat=CDI&departement=75&range=0-19 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "resultats": [
    {
      "idOffre": "075BLXM",
      "intitule": "Développeur backend",
      "typeContrat": "CDI",
      "natureOffre": "Emploi",
      "salaire": "2800 EUR mensuel",
      "salaireMin": 2800,
      "nomEntreprise": "Atelier Nord",
      "siret": "55212022200013",
      "lieuTravail": "Paris 10e",
      "codePostal": "75010",
      "libelleCommune": "Paris",
      "codeROME": "M1805",
      "dateCreation": "2026-09-28T09:12:00Z",
      "dateActualisation": "2026-10-01T11:04:00Z"
    }
  ],
  "filtresPossibles": []
}

已收藏职位
GET /v1/francetravail/offres/selection osint
列出求职者在“我的职位”收藏界面星标过的广告。
认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。
- offres
- idOffre
- intitule
- nomEntreprise
```
GET /v1/francetravail/offres/selection HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json
```
```
{
  "offres": [
    {
      "idOffre": "075BLXM",
      "intitule": "Développeur backend",
      "nomEntreprise": "Atelier Nord"
    }
  ]
}
```
投递职位
POST /v1/francetravail/candidatures/offre osint
针对 idOffre 创建一条 candidature，可附带 GED 简历 idGed。
认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。请求体标明要投递的 idOffre。
- idOffre
- idGed
- postulateWithProfile
- candidatureDetail
- statut
- dateCreation
```
POST /v1/francetravail/candidatures/offre HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "idOffre": "075BLXM",
  "idGed": "ged-441902",
  "postulateWithProfile": true
}
```
```
{
  "idOffre": "075BLXM",
  "candidatureDetail": {
    "statut": "ENVOYEE",
    "dateCreation": "2026-10-02T14:22:11Z"
  }
}
```

招聘方邀请

GET /v1/francetravail/amis osint

列出命题界面上展示的招聘方邀请（AMI）。

认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。

amis
idAMI
idOffre
nomEntreprise
statut

GET /v1/francetravail/amis HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "amis": [
    {
      "idAMI": "ami-8821",
      "idOffre": "075BLXM",
      "nomEntreprise": "Atelier Nord",
      "statut": "EN_COURS"
    }
  ]
}

职业资料

GET /v1/francetravail/profil osint

返回投递与名片界面使用的登录职业资料。

认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。

identifiant
prenom
nomNaissance
mail
telephone
dateNaissance
codePostal
libelleCommune

GET /v1/francetravail/profil HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "identifiant": "id-100442",
  "prenom": "Camille",
  "nomNaissance": "Martin",
  "mail": "[email protected]",
  "telephone": "+33 6 12 34 56 78",
  "dateNaissance": "1992-04-11",
  "codePostal": "75010",
  "libelleCommune": "Paris"
}

文档库中的简历
GET /v1/francetravail/documents osint
列出投递可通过 idGed 附上的 GED 简历。
认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。
- documents
- idGed
- nomFichier
- statut
```
GET /v1/francetravail/documents HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json
```
```
{
  "documents": [
    {
      "idGed": "ged-441902",
      "nomFichier": "cv-camille.pdf",
      "statut": "ACTIF"
    }
  ]
}
```
顾问与津贴
GET /v1/francetravail/conseiller osint
返回首页卡片上展示的指定顾问与 indemnisation 区块。
认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。
- idConseiller
- prenom
- statut
- indemnisation
- libelle
```
GET /v1/francetravail/conseiller HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json
```
```
{
  "idConseiller": "c-2044",
  "prenom": "Léa",
  "statut": "EN_COURS",
  "indemnisation": {
    "libelle": "ARE",
    "statut": "EN_COURS"
  }
}
```

机构预约

GET /v1/francetravail/rendezvous osint

列出日程界面上展示的机构预约。

认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。

rendezvous
id
libelle
statut
agence

GET /v1/francetravail/rendezvous HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "rendezvous": [
    {
      "id": "rdv-331",
      "libelle": "Entretien de suivi",
      "statut": "PLANIFIE",
      "agence": "Paris 10 - Magenta"
    }
  ]
}

求职 démarches

GET /v1/francetravail/demarches osint

为实际化时间线分页返回已申报的求职 démarches。

认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。

demarches
idDemarche
libelle
statut
idActionDeclaree

GET /v1/francetravail/demarches HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "demarches": [
    {
      "idDemarche": "d-9012",
      "libelle": "Candidature envoyée",
      "statut": "VALIDEE",
      "idActionDeclaree": "ad-44"
    }
  ]
}

未读顾问消息
GET /v1/francetravail/messages/unread osint
返回站内顾问收件箱角标使用的未读消息数。
认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。
- nonLu
- messages
- id
- libelle
```
GET /v1/francetravail/messages/unread HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json
```
```
{
  "nonLu": 2,
  "messages": [
    {
      "id": "m-17",
      "libelle": "Votre rendez-vous de jeudi"
    }
  ]
}
```

按 SIRET 查企业

GET /v1/francetravail/companies/{siret} opendata

从职位上的 SIRET 水合雇主卡片。

认证方式：可选的 Bearer access_token。从职位卡片打开雇主时使用。

siret
raisonSociale
nomEntreprise
codePostal
libelleCommune

GET /v1/francetravail/companies/55212022200013 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "siret": "55212022200013",
  "raisonSociale": "Atelier Nord",
  "nomEntreprise": "Atelier Nord",
  "codePostal": "75010",
  "libelleCommune": "Paris"
}

SSO 会话令牌
POST /v1/francetravail/sso osint
签发短时 jeton，以便应用内网页以已登录 usager 打开 candidat 页面。
认证方式： Authorization: Bearer access_token，来自 POST /v1/francetravail/oauth/token。为网页视图签发短时 jeton。
- jeton
- identifiant
```
POST /v1/francetravail/sso HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json
```
```
{
  "jeton": "sso-8f21a4c2",
  "identifiant": "id-100442"
}
```

数据类别

职位
投递申请
简历
顾问
津贴
预约
企业
登录会话

数据使用场景与案例

法国职位接入 ATS
轮询 GET /v1/francetravail/offres（motsCles、typeContrat、departement），以便申请人跟踪系统镜像 idOffre、intitule、typeContrat、salaire 与 codeROME。
投递管道与招聘方 AMI
把 POST /v1/francetravail/candidatures/offre（candidatureDetail、statut）与 GET /v1/francetravail/amis（idAMI）连接，以便职业产品展示哪些投递同时有未关闭的招聘方邀请。
投递前的简历完整度
读取 GET /v1/francetravail/profil（identifiant、prenom、mail）与 GET /v1/francetravail/documents（idGed、nomFichier），以便辅导产品指出投递为何会不带简历发出。
顾问档期与津贴快照
拉取 GET /v1/francetravail/conseiller（idConseiller、indemnisation）与 GET /v1/francetravail/rendezvous，以便个案工具把下一次机构档期放在 ARE 状态旁边。

常见问题

Parcours Emploi 如何认证 API 调用？

GET /v1/francetravail/oauth/authorize 启动 PEAM OpenID（client_id、redirect_uri、scope=openid）。POST /v1/francetravail/oauth/token 用授权码换取 access_token。之后的请求以该 access_token 发送 Authorization: Bearer。

哪些端点暴露职位与投递？

GET /v1/francetravail/offres 返回 idOffre、intitule、typeContrat、salaire、nomEntreprise、siret 与 codeROME。GET /v1/francetravail/offres/selection 列出星标广告。POST /v1/francetravail/candidatures/offre 创建 candidatureDetail；GET /v1/francetravail/amis 按 idAMI 列出招聘方邀请。

返回哪些资料与简历字段？

GET /v1/francetravail/profil 返回 identifiant、prenom、nomNaissance、mail、telephone、dateNaissance、codePostal 与 libelleCommune。GET /v1/francetravail/documents 列出 GED 中的 idGed 与 nomFichier。

API 能否看到顾问、津贴与预约？

可以。GET /v1/francetravail/conseiller 返回 idConseiller 与 indemnisation。GET /v1/francetravail/rendezvous 列出机构档期。GET /v1/francetravail/demarches 分页 idDemarche。GET /v1/francetravail/messages/unread 是收件箱角标。

与 Parcours Emploi 相似的应用

InfoJobs - Job Search — InfoJobs 是 Adevinta 的西班牙招聘板：按省与远程筛选职位、用简历投递并跟踪申请。
Indeed Job Search — Indeed 是全球求职应用：关键词搜索、投递、申请状态与招聘方消息。
Vagas de Emprego: Catho — Catho 是巴西招聘板，含简历、排序分数与招聘方收件箱线程。
OCC: Job Search — OCCMundial 是墨西哥的分类招聘板：职位搜索、简历、投递与招聘方浏览界面。
Bumeran — Bumeran 是 Jobint 面向阿根廷的西语分类招聘板，含招聘广告、简历投递与净薪计算器。
LinkedIn: Community & Network — LinkedIn 是职业社交网络，与 France Travail 的求职资料与投递闭环重叠。
Pôle emploi — 旧品牌 Pôle emploi 仍出现在姊妹应用以及当前 France Travail 客户端使用的 PEAM 登录上。

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

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

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

获取报价

France Travail 数据 API：职位、投递与简历

应用截图

API 端点一览

PEAM OpenID 授权

用授权码换取 access token

搜索职位

已收藏职位

投递职位

招聘方邀请

职业资料

文档库中的简历

顾问与津贴

机构预约

求职 démarches

未读顾问消息

按 SIRET 查企业

SSO 会话令牌

数据类别

数据使用场景与案例

法国职位接入 ATS

投递管道与招聘方 AMI

投递前的简历完整度

顾问档期与津贴快照

常见问题

与 Parcours Emploi 相似的应用

更多招聘求职类应用

apna - Search Job, Vacancy App

Bumeran

Clickworker

Fiverr - Freelance Service

相关主题

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

France Travail 数据 API：职位、投递与简历

应用截图

API 端点一览

PEAM OpenID 授权

用授权码换取 access token

搜索职位

已收藏职位

投递职位

招聘方邀请

职业资料

文档库中的简历

顾问与津贴

机构预约

求职 démarches

未读顾问消息

按 SIRET 查企业

SSO 会话令牌

数据类别

数据使用场景与案例

法国职位接入 ATS

投递管道与招聘方 AMI

投递前的简历完整度

顾问档期与津贴快照

常见问题

相关应用

与 Parcours Emploi 相似的应用

更多招聘求职类应用

apna - Search Job, Vacancy App

Bumeran

Clickworker

Fiverr - Freelance Service

相关主题

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