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	api_peconnect-abonnementsauxoffresv1 application_`Votre identifiant client` criteresrecherchesoffres

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 Contrat intermittent Contrat d'usage CDI de chantier ou d'opération Engagement à servir dans la réserve Contrat d'Engagement Educatif
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 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.