API Abonnements aux offres v1

Présentation

L'API Abonnements aux offres vous permet d’accéder aux critères de recherche d’emploi saisis et enregistrés par un individu dans son espace personnel sur pole-emploi.fr (mots-clés, zone géographique de recherche, salaire souhaité, contrat recherché, durée hebdomadaire, expérience demandée, domaine professionnel, qualification, éléments techniques).

L'utilisateur doit au préalable s'être identifié sur votre application avec son compte Pôle emploi grâce à l'API Se connecter avec Pôle emploi.

 

Caractéristiques

Mode d'accès restreint (demande d'accès soumise à validation de Pôle emploi)
Cinématique OAuth authorization code flow
Royaume Pôle Emploi Access Management /individu
Scopes nécessaires

 

Description de la requête

Point d'accès

GET https://api.emploi-store.fr/partenaire/peconnect-abonnementsauxoffres/v1/criteres

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/peconnect-abonnementsauxoffres/v1/criteres

Authorization: Bearer [Access token]

 

Description de la réponse

Données retournées

Code Cardinalité Format Description
criteres 0..n Sous balise

Liste des critères de recherche sélectionnés par le candidat ou le demandeur d'emploi dans son espace personnel sur pole-emploi.fr

domaines 0..1 Sous balise

Liste des domaines professionnels sélectionnés dans la recherche

domaines.libelle 0..1 String

Libellé du domaine professionnel issu du ROME

dureeContratMax 0..1 String

En cas de sélection d'un type de contrat ayant une durée fixe (CDD par exemple), ce critère indique la durée maximale en mois saisie

dureeContratMin 0..1 String

En cas de sélection d'un type de contrat ayant une durée fixe (CDD par exemple), ce critère indique la durée minimale en mois saisie

dureeHebdoMax 0..1 String

En cas de sélection d'un type de contrat à temps partiel, ce critère indique la durée minimale souhaitée par semaine

dureeHebdoMin 0..1 String

En cas de sélection d'un type de contrat à temps partiel, ce critère indique la durée maximale souhaitée par semaine

dureesHebdos 0..1 Sous balise

Liste des valeurs sélectionnées pour la durée de travail hebdomadaire

dureesHebdos.libelle 0..3 String

Valeurs possibles :

  • temps plein
  • temps partiel
  • Non précisée
emission 0..1 Integer

Nombre de jours maximum depuis la publication des offres souhaité par le candidat ou le demandeur d'emploi

experiencesSouhaitees 0..1 Sous balise

Liste des durées d'expériences souhaitées

experiencesSouhaitees.libelle 0..4 String

Valeurs possibles :

  • Moins de 1 an
  • De 1 à 3 ans
  • Plus de 3 ans
  • Non précisée
lieu 1 Sous balise

Lieu de la recherche d'offre

lieu.code 1

String

Si le lieu est :

  • une commune, le code est valorisé avec le code INSEE de la commune.
  • un département, le code est valorisé avec le numéro de département suivi de la lettre D.
  • une région, le code est valorisé avec le code INSEE de la région suivi de la lettre R.
  • un pays, le code est valorisé avec un code à deux chiffres suvi de la lettre P.
  • un continent, le code est valorisé avec un code à deux caractères suvi de la lettre C.

Les référentiels des codes pays et continents seront prochainement exposés par l'API Offres d'emploi V2.

lieu.libelle 1

String

Libellé du lieu de la recherche d'offres
lieu.rayon 0..1

Integer

Dans le cas où le lieu est une commune, ce critère indique le rayon de la recherche géographique
motsCles 1..7

String

Liste des mots-clés souhaités
naturesOffres 0..1

Sous balise

Liste des natures d'offres souhaitées
naturesOffres.libelle 0..10

String

Valeurs possibles :

  • Mesure régionale
  • Contrat Initiative Emploi (CUI-CIE)
  • Contrat d'Accompagnement dans l'Emploi (CUI-CAE)
  • Contrat de travail - GEIQ
  • Contrat de professionnalisation
  • Portage salarial
  • Contrat d'apprentissage
  • Insertion par l'activ.éco.
  • Contrat pacte
  • PrAB - Préparation aux concours de catégorie A et B
offresPartenaires 1

Booléen

Indique si le candidat ou le demandeur d'emploi souhaite que la recherche inclut les offres des partenaires de Pole Emploi
offresPeuDeCandidats 1

Booléen

Indique si le candidat ou le demandeur d'emloi cible les offres avec peu de candidats (offres de plus de 15 jours et comptant moins de 4 candidatures dont Pole Emploi est informé)

qualifications 0..1

Sous balise

Liste des qualifications souhaitées
qualifications.libelle 0..3

String

Valeurs possibles :

  • Cadre
  • Non cadre
  • Non précisée
salaireMin 0..1

String

Salaire minimal brut souhaité
typeSalaire 0..1

Sous balise

Liste des types de salaire souhaités en rapport au salaire minimal brut souhaité
typeSalaire.code 0..1

String

Code du type de salaire souhaité

Valeurs possibles :

  • M
  • A
  • H
  • C
typeSalaire.libelle 0..1

String

Libellé du type de salaire souhaité

Valeurs possibles :

  • Mensuel
  • Annuel
  • Horaire
  • Cachet
typeContrats 0..1

Sous balise

Liste des types de contrats souhaités
typeContrats.libelle 0..10

String

Libellé du type de contrat souhaité

Valeurs possibles :

  • Travail intérimaire
  • Profession commerciale
  • Franchise
  • Reprise d'entreprise
  • Contrat à durée déterminée
  • Contrat travail intermittent
  • Contrat travail saisonnier
  • Profession libérale
  • Contrat à durée indéterminée
  • CDD Senior
nom 1

String

Nom de la recherche enregistrée

 

Exemple de retour

HTTP 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
[
    {
        "criteres": {
            "domaines": [
                {
                    "libelle": "Commerce / Vente"
                },
                {
                    "libelle": "Banque / Assurance"
                }
            ],
            "dureeContratMax": "24.0",
            "dureeContratMin": "2.0",
            "dureeHebdoMax": "35",
            "dureeHebdoMin": "25",
            "dureesHebdos": [
                {
                    "libelle": "temps partiel"
                },
                {
                    "libelle": "temps plein"
                }
            ],
            "emission": 14,
            "experiencesSouhaitees": [
                {
                    "libelle": "Non précisée"
                },
                {
                    "libelle": "De 1 à 3 ans"
                }
            ],
            "lieu": {
                "code": "75D",
                "libelle": "Paris (Dept.)"
            },
            "motsCles": [
                "commercial"
            ],
            "naturesOffres": [
                {
                    "libelle": "Contrat Initiative Emploi (CUI-CIE)"
                },
                {
                    "libelle": "Contrat d'apprentissage"
                },
                {
                    "libelle": "Contrat d'Accompagnement dans l'Emploi (CUI-CAE)"
                },
                {
                    "libelle": "Contrat de professionnalisation"
                },
                {
                    "libelle": "Insertion par l'activ.éco."
                }
            ],
            "offresPartenaires": true,
            "offresPeuDeCandidats": false,
            "qualifications": [
                {
                    "libelle": "Cadre"
                },
                {
                    "libelle": "Non cadre"
                }
            ],
            "salaireMin": "2000.0",
            "typeSalaire": {
                "code": "M",
                "libelle": "Mensuel"
            },
            "typesContrats": [
                {
                    "libelle": "Contrat à durée déterminée"
                },
                {
                    "libelle": "Contrat à durée indéterminée"
                }
            ]
        },
        "nom": "Commercial en région parisienne",
        "flagMail": false,
        "flagPush": false,
        "flagNouveau": false,
        "flagInefficace": false,
        "flagARenouveler": false
    }
]

 

Cas d'erreurs possibles

Retrouvez la liste des cas d'erreurs possibles sur la page Erreurs Types.