Lister les métiers recherchés

Présentation

Cette ressource fait remonter les activités professionnelles recherchées  (salariées ou non-salariées) par un individu et renseignées au sein du profil de compétences de son espace personnel sur pole-emploi.fr.

Deux métiers recherchés du profil au maximum seront remontés par cette API. Le métier peut être une « reprise » d’entreprise ou un projet d’adhésion à une « franchise ».

Pour chacun de ces métiers les ressources suivantes seront exposées :

Intitulé du métier (code ROME, code appellation et libellé de l’appellation), expérience (en années ou en mois), lieu d’habitation et mobilité (trajet accepté en minutes, en heures, en kilomètres), lieux de travail acceptés, salaire (brut minimum accepté en euros, unité (horaire/mensuel/annuel, cachet), types de contrats souhaités, temps de travail souhaité (temps plein/temps partiel).

Exemple d’usage : un job board pourra afficher des offres correspondant à la recherche d’emploi contenue dans le profil de compétences de l’individu.

Cette API fait partie de l’ensemble des API mises à disposition dans le cadre de l’utilisation du dispositif de portabilité de Pôle emploi des données personnelles d'un individu.

Pour pouvoir l'exploiter, l'utilisateur doit au préalable s'être identifié sur l’application ou le site web avec son compte Pôle emploi grâce au bouton « Se connecter avec Pôle emploi » (API Se connecter avec Pôle emploi).

 

Description de la requête

Point d'accès

GET http://api.emploi-store.fr/partenaire/peconnect-metiersrecherches/v1/metiersrecherches

 

Exemple d'appel

GET http://api.emploi-store.fr/partenaire/peconnect-metiersrecherches/v1/metiersrecherches

Authorization: Bearer [Access token]

 

Description de la réponse

Données retournées

En-tête(s) Valeur
Cache-Control no-cache
Date Wed, 09 Sep 2020 09:54:20 GMT
Content-Length 2788
Content-Type application/json
Code Cardinalité Format Description
appellation 0..1 sousbalise Appellation précise du référentiel ROME ~ poste recherché
appellation.libelle 1..1 AN(?)  
appellation.code 1..1 AN(5)  
rome 0..1 sousbalise Famille ROME du référentiel ROME
rome.libelle 1..1 AN  
rome.code 1..1 AN(5)  
typologieEmploi 1..1 sousbalise Typologie de l'emploi recherché
typologieEmploi.libelle 1..1 AN(?)  
typologieEmploi.code 1..1 AN(2)  
contrats 0..1 tableau Types de contrats souhaités
contrats.critereOre 0..1 booléen Critère ORE
contrats.priorite 1..1 INTEGER Critère recherché en priorité
contrats.type 1..1 sousbalise Type de contrat : code et libellés
contrats.type.code 1..1 AN(?)  
contrats.type.libelle 1..1 AN(?)  
contrats.type.libelleLong 1..1 AN(?)  
dureeExperience 0..1 sousbalise Expérience professionnelle sur cette appellation
dureeExperience.valeur 1..1 INTEGER  
dureeExperience.unite 1..1 sousbalise Unité de l'expérience
dureeExperience.unite.code 1..1 AN(?)  
dureeExperience.unite.libelle 1..1 AN(?)  
dureesHebdo 0..1 tableau Temps de travail hebdomadaire acceptés
dureesHebdo.critereOre 0..1 booléen Critère ORE
dureesHebdo.tempsTravail. 1..1 sousbalise Temps de travail hebdomadaire accepté
dureesHebdo.tempsTravail.code 1..1 AN(1)  
dureesHebdo.tempsTravail.libelle 1..1 AN(13)  
dureesHebdo.tempsTravail.max 0..1 INTEGER en heures
dureesHebdo.tempsTravail.min 0..1 INTEGER en heures
mobiliteHabitation 0..1 sousbalise Rayon autour du lieu d'habitation
mobiliteHabitation.valeur 1..1 INTEGER(?)  
mobiliteHabitation.unite 1..1 sousbalise Unité du rayon
mobiliteHabitation.unite.code 1..1 AN(2)  
mobilites 0..1 tableau Lieux de travail acceptés
mobilites.rayon 1..1 INTEGER Rayon autour du lieu
mobilites.lieu 1..1 sousbalise Lieu
mobilites.lieu.code 1..1 AN(?)  
mobilites.lieu.codeDepartement 0..1 AN(?)  
mobilites.lieu.codePostal 0..1 AN(5)  
mobilites.lieu.libelle 1..1 AN(?)  
mobilites.lieu.type 1..1 sousbalise Unité du rayon
mobilites.lieu.type.code 1..1 AN(?)  
mobilites.lieu.type.libelle 1..1 AN(?)  
mobilites.unite 1..1 sousbalise  
mobilites.unite.code 1..1 AN(?)  
mobilites.unite.libelle 1..1 AN(?)  
salaire 0..1 sousbalise Salaire minimum recherché
salaire.remuneration 1..1 DOUBLE Montant
salaire.libelle 1..1 AN(?)  
typeCrefFranchise 0..1 Booléen CREF concernant une franchise
typeCrefReprise 0..1 Booléen CREF concernant une reprise
typeCrefCreation 0..1 Booléen CREF concernant une création

 

Exemple de retour

HTTP 200 OK
Cache-Control: no-cache
Date: Wed, 09 Sep 2020 09:54:20 GMT
Content-Length: 2788
Content-Type: application/json
[
    {
        "appellation": {
            "libelle": "Comédien / Comédienne",
            "code": "12724"
        },
        "contrats": [
            {
                "critereOre": false,
                "priorite": 1,
                "type": {
                    "code": "CDI",
                    "libelle": "CDI",
                    "libelleLong": "Contrat à durée indeterminée"
                }
            },
            {
                "critereOre": false,
                "priorite": 3,
                "type": {
                    "code": "DIN",
                    "libelle": "CDI Intérimaire",
                    "libelleLong": "CDI Intérimaire"
                }
            },
            {
                "critereOre": true,
                "priorite": 2,
                "type": {
                    "code": "CDD",
                    "libelle": "CDD",
                    "libelleLong": "Contrat à durée déterminée"
                }
            }
        ],
        "dureeExperience": {
            "valeur": 2,
            "unite": {
                "code": "AN",
                "libelle": "An(s)"
            }
        },
        "dureesHebdo": [
            {
                "critereOre": true,
                "tempsTravail": {
                    "code": "1",
                    "libelle": "temps plein"
                }
            },
            {
                "critereOre": false,
                "tempsTravail": {
                    "code": "2",
                    "libelle": "temps partiel",
                    "max": 35,
                    "min": 10
                }
            }
        ],
        "mobiliteHabitation": {
            "valeur": 27,
            "unite": {
                "code": "KM"
            }
        },
        "mobilites": [
            {
                "rayon": 0,
                "lieu": {
                    "code": "32",
                    "libelle": "Hauts-de-France",
                    "type": {
                        "code": "3",
                        "libelle": "Région"
                    }
                },
                "unite": {
                    "code": "KM",
                    "libelle": "Kilomètres"
                }
            },
            {
                "rayon": 0,
                "lieu": {
                    "code": "59220",
                    "codeDepartement": "59",
                    "codePostal": "59155",
                    "libelle": "FACHES THUMESNIL",
                    "type": {
                        "code": "5",
                        "libelle": "Commune"
                    }
                },
                "unite": {
                    "code": "KM",
                    "libelle": "Kilomètres"
                }
            },
            {
                "rayon": 10,
                "lieu": {
                    "code": "59507",
                    "codeDepartement": "59",
                    "codePostal": "59790",
                    "libelle": "RONCHIN",
                    "type": {
                        "code": "5",
                        "libelle": "Commune"
                    }
                },
                "unite": {
                    "code": "KM",
                    "libelle": "Kilomètres"
                }
            }
        ],
        "rome": {
            "libelle": "Art dramatique",
            "code": "L1203"
        },
        "salaire": {
            "remuneration": 95.0,
            "libelle": "Cachet",
            "code": "C"
        },
        "typologieEmploi": {
            "libelle": "Métier Recherché",
            "code": "MR"
        }
    },
    {
        "appellation": {
            "libelle": "Maître-chien / Maîtresse-chien d'avalanche",
            "code": "16320"
        },
        "mobilites": [
            {
                "rayon": 0,
                "lieu": {
                    "code": "33",
                    "libelle": "Gironde",
                    "type": {
                        "code": "4",
                        "libelle": "Département"
                    }
                },
                "unite": {
                    "code": "KM",
                    "libelle": "Kilomètres"
                }
            },
            {
                "rayon": 100,
                "lieu": {
                    "code": "33281",
                    "codeDepartement": "33",
                    "codePostal": "33700",
                    "libelle": "MERIGNAC",
                    "type": {
                        "code": "5",
                        "libelle": "Commune"
                    }
                },
                "unite": {
                    "code": "KM",
                    "libelle": "Kilomètres"
                }
            },
            {
                "rayon": 0,
                "lieu": {
                    "code": "75",
                    "libelle": "Nouvelle-Aquitaine",
                    "type": {
                        "code": "3",
                        "libelle": "Région"
                    }
                },
                "unite": {
                    "code": "KM",
                    "libelle": "Kilomètres"
                }
            },
            {
                "rayon": 0,
                "lieu": {
                    "code": "01",
                    "libelle": "France",
                    "type": {
                        "code": "1",
                        "libelle": "Pays"
                    }
                },
                "unite": {
                    "code": "KM",
                    "libelle": "Kilomètres"
                }
            },
            {
                "rayon": 0,
                "lieu": {
                    "code": "9C",
                    "libelle": "EUROPE (hors France)",
                    "type": {
                        "code": "2",
                        "libelle": "Continent"
                    }
                },
                "unite": {
                    "code": "KM",
                    "libelle": "Kilomètres"
                }
            },
            {
                "rayon": 0,
                "lieu": {
                    "code": "33063",
                    "codeDepartement": "33",
                    "codePostal": "33100",
                    "libelle": "BORDEAUX",
                    "type": {
                        "code": "5",
                        "libelle": "Commune"
                    }
                },
                "unite": {
                    "code": "KM",
                    "libelle": "Kilomètres"
                }
            }
        ],
        "rome": {
            "libelle": "Sécurité civile et secours",
            "code": "K1705"
        },
        "typeCrefFranchise": true,
        "typeCrefReprise": true,
        "typologieEmploi": {
            "libelle": "Création ou Reprise d'Entreprise ou de Franchiseaire",
            "code": "EF"
        }
    }
]

 

Cas d'erreurs possibles

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