Rechercher par critères
Présentation
Cette ressource permet de réaliser une recherche d'offres à partir de critères de sélection.
La liste des offres retournées est paginée.
Description de la requête
Point d'accès
POST https://api.emploi-store.fr/partenaire/offresdemploi/v1/rechercheroffres
Paramètres d'entrée
En-tête(s) | Valeur |
---|---|
Content-Type | application/json |
Accept | application/json application/xml |
Code | Cardinalité | Format | Description |
---|---|---|---|
technicalParameters | 0..1 | Sous balise |
Paramètres techniques |
technicalParameters.page | 1 | Integer 4 |
Numéro de la page Entier positif compris entre 1 et 1000. |
technicalParameters.per_page | 1 | Integer 3 |
Nombre de résultats maximum souhaités par page Entier positif compris entre 1 et 150. |
technicalParameters.sort | 1 | Integer 1 |
Tri des données Valeurs possibles :
|
criterias | 0..1 | Sous balise |
Critères de recherche |
criterias.largeAreaCode | 0..14 | String 1 |
Code du grand domaine professionnel Référentiel : Grands domaines professionnels |
criterias.romeProfessionCardCode | 0..1 | String 5 |
Code ROME du métier Référentiel : Métiers ROME |
criterias.romeProfessionCode | 0..1 | String 6 |
Code de l'appellation Référentiel : Appellations ROME |
criterias.qualificationCode | 0..1 | String 1 |
Code de la qualification Valeurs possibles :
|
criterias.activityCode | 0..1 | String 2 |
Code du secteur d’activité Référentiel : Sous classe NAF |
criterias.keywords | 0..7 | String 100 |
Recherche par mot clé Chaque mot clé ou expression comprend au moins 2 caractères. |
criterias.cityCode | 0..1 | String 5 |
Code INSEE de la commune Le comportement de recherche permet de remonter les offres pour lesquelles la distance entre la commune recherchée et la commune de l’offre est inférieure ou égale à la distance maximum demandée, ainsi que les offres pour lesquelles cette distance est marginalement plus élevée (jusqu’à + 30% de la distance maximum demandée).
Spécificité de la ville de Lyon, l’ensemble des offres de Lyon sont remontées dès que le centre de Lyon est atteint par le rayon de distance recherché. Référentiel : Commune |
criterias.cityDistance | 0..1 Conditionné | Integer 3 |
Distance kilométrique du rayon de recherche Si cette donnée est renseignée, le code INSEE de la commune est obligatoire. Valeur par défaut : |
criterias.departmentCode | 0..1 | String 3 |
Code du département Référentiel : Département |
criterias.includeDepartementBoundaries | 0..1 Conditionné | Integer 1 |
Indique l'inclusion des départements limitrophes à la recherche Si cette donnée est renseignée, le code du département est obligatoire. Valeurs possibles :
|
criterias.regionCode | 0..1 | String 2 |
Code de la région Référentiel : Région |
criterias.countryCode | 0..1 Conditionné | String 2 |
Code du pays Si cette donnée est renseignée, le code du continent ne doit pas être renseigné. Référentiel : Pays
|
criterias.continentCode | 0..1 Conditionné | String 2 |
Code du continent ou du sous-continent Si cette donnée est renseignée, le code du pays ne doit pas être renseigné. Référentiel :
|
criterias.minSalary |
0..1 Conditionné |
Double 7,2 |
Salaire minimum, exprimé en Euro. Si cette donnée est renseignée, le code du type de salaire minimum est obligatoire. |
criterias.salaryCurrencyCode | 0..1 Conditionné | String 1 |
Code du type de salaire Si cette donnée est renseignée, le salaire minimum est obligatoire. Référentiel : Types de salaire |
criterias.contractTypeCode | 0..14 | String 3 |
Code du type de contrat Référentiel : Types de contrat |
criterias.contractNatureCode | 0..2 | String 2 |
Code de la nature Référentiel : Natures de contrat |
criterias.minContractDuration | 0..1 | Double 2,2 |
Durée minimum de contrat, exprimée en mois. Décimal positif compris entre 0 et 99. Exemple :
|
criterias.maxContractDuration | 0..1 | Double 2,2 |
Durée maximum de contrat, exprimée en mois. Décimal positif compris entre 0 et 99. Exemple :
|
criterias.minWeeklyWorkTime | 0..1 | Integer 2 |
Durée hebdomadaire minimum |
criterias.maxWeeklyWorkTime | 0..1 | Integer 2 |
Durée hebdomadaire maximum |
criterias.partTimeWorkingCode | 0..3 | Integer 1 |
Code du travail à temps partiel Référentiel : Travail à temps partiel |
criterias.experienceCode | 0..4 | String 1 |
Code du type d'expérience professionnelle Référentiel : Expériences professionnelles |
criterias.degreeTypeCode | 0..1 | String 3 |
Code du niveau de formation Référentiel : Types de formation |
criterias.languageCode | 0..2 | String 2 |
Code de la langue Référentiel : Langues |
criterias.drivingLicenceCode | 0..1 | String 3 |
Code du permis Référentiel : Permis de conduire |
criterias.isLackCandidate | 0..1 | Integer 1 |
Top indiquant si l’offre est en manque de candidat. Valeurs possibles :
|
criterias.delaySinceCreation | 0..1 | Integer 3 |
Délai depuis la création d'offre, exprimé en jours |
criterias.minCreationDate | 0..1 | Date |
Date de création d'offre minimum Norme ISO-8601 (YYYY-MM-DDTHH:MM:SSZ) |
criterias.maxCreationDate | 0..1 | Date |
Date de création d'offre maximum Norme ISO-8601 (YYYY-MM-DDTHH:MM:SSZ) |
Exemple d'appel
POST /partenaire/offresdemploi/v1/rechercheroffres
Authorization: Bearer [Access token]
{
"technicalParameters" : {
"page": 5,
"per_page": 20,
"sort": 1
},
"criterias" : {
"qualificationCode": "0",
"keywords": "informatique"
}
}
Description de la réponse
Données retournées
Lorsque la requête s’exécute sans erreur, en cas de succès il y a 2 codes retour possibles :
- si le nombre d'offres issu de la recherche est inférieur au nombre maximal d'offres (Accept-Range) que le service peut remonter en une requête, un code HTTP 200 OK est renvoyé
- si le nombre d'offres issu de la recherche est supérieur au nombre maximal d'offres que le service peut remonter en une requête ou supérieur à 150, un code 206 PARTIAL est renvoyé
En-tête(s) | Valeur |
---|---|
Content-Type | application/json ou application/xml |
Content-Range |
offres <p>-<d>/<t> où :
|
Accept-Range |
offres <m> où <m> est le nombre maximal d’offres que le service peut renvoyer en une requête |
Code | Cardinalité | Format | Description |
---|---|---|---|
technicalParameters | 0..1 | Sous balise |
Paramètres techniques |
technicalParameters.startResults | 1 | Integer 4 |
Numéro de la première offre dans la liste de résultats |
technicalParameters.endResults | 1 | Integer 4 |
Numéro de la dernière offre dans la liste de résultats |
technicalParameters.totalNumber | 1 | Integer 4 |
Nombre total de résultats |
results | 0..150 | Sous balise |
Liste des offres |
results.offerId | 1..1 | String 7 |
Identifiant de l'offre |
results.score | 1..1 | Integer 3 |
Score de l'offre calculé en fonction des critères de recherche saisis Plage de valeur comprise entre 1 et 100 |
results.creationDate | 0..1 | Date |
Date de création de l'offre Norme ISO-8601 (YYYY-MM-DD) |
results.modificationDate | 0..1 | Date |
Date d'actualisation de l'offre Norme ISO-8601 (YYYY-MM-DD) |
results.title | 1..1 | String 300 |
Intitulé de l’offre |
results.description | 0..1 | String 5000 |
Description de l'offre |
results.postcode | 0..1 | String 5 |
Lieu de travail – Code postal de la commune Référentiel : Commune |
results.cityCode | 0..1 | String 5 |
Lieu de travail – Code INSEE de la commune Référentiel : Commune |
results.cityName | 0..1 | String 100 |
Lieu de travail – Libellé commune Référentiel : Commune |
results.departmentCode | 0..1 | String 3 |
Lieu de travail – Code département Référentiel : Commune |
results.departmentName | 0..1 | String 100 |
Lieu de travail – Libellé département Référentiel : Commune |
results.regionCode | 0..1 | String 2 |
Lieu de travail – Code région Référentiel : Commune |
results.regionName | 0..1 | String 100 |
Lieu de travail – Libellé région Référentiel : Commune |
results.countryCode | 0..1 | String 2 |
Lieu de travail – Code pays Référentiel : Pays |
results.countryName | 0..1 | String 100 |
Lieu de travail – Libellé pays Référentiel : Pays |
results.subContinentCode | 0..1 | String 2 |
Lieu de travail – Code sous-continent Référentiel : Sous-continents |
results.subContinentName | 0..1 | String 100 |
Lieu de travail – Libellé sous-continent Référentiel : Sous-continents |
results.continentCode | 0..1 | String 2 |
Lieu de travail – Code continent Référentiel : Continents |
results.continentName | 0..1 | String 50 |
Lieu de travail – Libellé continent Référentiel : Continents |
results.gpsLatitude | 0..1 | Décimal 3,10 |
Latitude du lieu (commune) de travail |
results.gpsLongitude | 0..1 | Décimal 3,10 |
Longitude du lieu (commune) de travail |
results.distance | 0..1 | Integer 3 |
Distance par rapport à la zone recherchée, exprimée en kilomètre. |
results.romeProfessionCode | 0..1 | String 6 |
Code de l'appellation Référentiel : Appellations ROME |
results.romeProfessionName | 0..1 | String 150 |
Libellé de l'appellation Référentiel : Appellations ROME |
results.activityCode | 0..1 | String 2 |
Code du secteur d’activité Référentiel : Sous classe NAF |
results.activityName | 0..1 | String 129 |
Libellé du secteur d’activité Référentiel : Sous classe NAF |
results.professionalQualities | 0..3 | Sous balise |
Liste des qualités professionnelles |
results.professionalQualities.professionalQualityCode | 0..1 | String 6 |
Code de la qualité professionnelle Référentiel : Qualités professionnelles |
results.professionalQualities.professionalQualityName | 0..1 | String 240 |
Libellé de la qualité professionnelle Référentiel : Qualités professionnelles |
results.qualificationCode | 0..1 | String 1 |
Code de la qualification Référentiel : Qualifications |
results.qualificationName | 0..1 | String 30 |
Libellé de la qualification Référentiel : Qualifications |
results.contractTypeCode | 0..1 | String 3 |
Code du type de contrat Référentiel : Types de contrat |
results.contractTypeName | 0..1 | String 100 |
Libellé du type de contrat Référentiel : Types de contrat |
results.contractDuration | 0..1 | Integer 2 |
Durée du contrat |
results.contractDurationUnitCode | 0..1 | String 2 |
Code de l'unité de durée de contrat Référentiel : Durées de contrat |
results.contractDurationUnitName | 0..1 | String 100 |
Libellé de l'unité de durée de contrat Référentiel : Durées de contrat |
results.contractNatureCode | 0..1 | String 2 |
Code de la nature de contrat Référentiel : Natures de contrat |
results.contractNatureName | 0..1 | String 50 |
Libellé de la nature du contrat Référentiel : Natures de contrat |
results.experienceCode | 0..1 | String 1 |
Code du type d'expérience professionnelle Référentiel : Expériences |
results.experienceName | 0..1 | String 100 |
Libellé du type d'expérience professionnelle Référentiel : Expériences |
results.experienceDuration | 0..1 | String 10 |
Durée de l'expérience professionnelle |
results.experienceDurationUnitCode | 0..1 | String 2 |
Code de l'unité de la durée d'expérience professionnelle Référentiel : Durées de contrat |
results.experienceDurationUnitName | 0..1 | String 100 |
Libellé de l'unité de la durée d'expérience professionnelle Référentiel : Durées de contrat |
results.experienceComment | 0..1 | String 80 |
Commentaire expérience professionnelle |
results.degrees | 0..2 | Sous balise |
Liste des formations |
results.degrees.degreeCode | 0..1 | String 5 |
Code du domaine de formation Référentiel : Domaines de formation |
results.degrees.degreeName | 0..1 | String 30 |
Libellé du domaine de formation Référentiel : Domaines de formation |
results.degrees.degreeTypeCode | 0..1 | String 3 |
Code du niveau de formation Référentiel : Types de formation |
results.degrees.degreeTypeName | 0..1 | String 100 |
Libellé du niveau de formation Référentiel : Types de formation |
results.degrees.requiredDegreeCode | 0..1 | String 1 |
Code du critère d'obtention du diplôme Référentiel : Exigibilités |
results.degrees.requiredDegreeName | 0..1 | String 100 |
Libellé du critère d'obtention du diplôme Référentiel : Exigibilités |
results.degrees.degreeComment | 0..1 | String 36 |
Commentaire formation |
results.languages | 0..2 | Sous balise |
Liste des langues |
results.languages.languageCode | 0..1 | String 2 |
Code de la langue Référentiel : Langues |
results.languages.languageName | 0..1 | String 100 |
Libellé de la langue Référentiel : Langues |
results.languages.languageProficiencyCode | 0..1 | String 1 |
Code niveau de langue Référentiel : Niveaux de langue |
results.languages.languageProficiencyName | 0..1 | String 100 |
Libellé niveau de langue Référentiel : Niveaux de langue |
results.languages.requiredLanguageCode | 0..1 | String 1 |
Code critère de la langue Référentiel : Exigibilités |
results.languages.requiredLanguageName | 0..1 | String 100 |
Libellé critère de la langue Référentiel : Exigibilités |
results.drivingLicenses | 0..2 | Sous balise |
Liste des permis |
results.drivingLicenses.drivingLicenseCode | 0..1 | String 3 |
Code du permis Référentiel : Permis de conduire |
results.drivingLicenses.drivingLicenseName | 0..1 | String 100 |
Libellé du permis Référentiel : Permis de conduire |
results.drivingLicenses.requiredDrivingLicenseCode | 0..1 | String 1 |
Code critère du permis Référentiel : Exigibilités |
results.drivingLicenses.requiredDrivingLicenseName | 0..1 | String 100 |
Libellé critère du permis Référentiel : Exigibilités |
results.desktops | 0..2 | Sous balise |
Liste des outils bureautique |
results.desktops.desktopToolsCode | 0..1 | String 1 |
Code de l'outil bureautique Référentiel : Outils bureautiques |
results.desktops.desktopToolsName | 0..1 | String 100 |
Libellé de l'outil bureautique Référentiel : Outils bureautiques |
results.desktops.desktopToolsLevelCode | 0..1 | String 2 |
Code de niveau de pratique de l'outil bureautique Référentiel : Niveaux de pratique bureautique |
results.desktops.desktopToolsLevelName | 0..1 | String 100 |
Libellé de niveau de pratique de l'outil bureautique Référentiel : Niveaux de pratique bureautique |
results.weeklyWorkTime | 0..1 | String 5 |
Durée horaire |
results.weeklyWorkTimeTypeCode | 0..1 | String 3 |
Code du type horaire Référentiel : Types horaires |
results.weeklyWorkTimeTypeName | 0..1 | String 100 |
Libellé du type horaire Référentiel : Types horaires |
results.isPartTimeWorking | 0..1 | Integer 1 |
Travail à temps partiel Valeurs possibles :
|
results.weeklyWorkTimeTypeComment | 0..1 | String 80 |
Commentaire du type horaire |
results.workingConditionComment | 0..1 | String 80 |
Commentaire de la condition d'exercice |
results.salaryCode | 0..1 | String 1 |
Code du type de salaire Référentiel : Types de salaire |
results.salaryName | 0..1 | String 100 |
Libellé du type de salaire Référentiel : Types de salaire |
results.minSalary | 0..1 | Double 7,2 |
Montant du salaire minimum |
results.maxSalary | 0..1 | Double 7,2 |
Montant du salaire maximum |
results.salaryCurrencyCode | 0..1 | String 2 |
Code de l'unité monétaire Référentiel : Unités monétaires |
results.salaryCurrencyName | 0..1 | String 100 |
Libellé de l'unité monétaire Référentiel : Unités monétaires |
results.numberMonthSalary | 0..1 | Double 2,1 |
Nombre de mois de salaire |
results.salaryComment | 0..1 | String 120 |
Commentaire du complément de salaire |
results.salary1Comment | 0..1 | String 50 |
Commentaire du premier complément de salaire |
results.salary2Comment | 0..1 | String 50 |
Commentaire du second complément de salaire |
results.skills | 0..40 | Sous balise |
Liste des compétences |
results.skills.skillTypeCode | 1..1 | String 1 |
Code du type de la compétence Référentiel : Types de compétence |
results.skills.skillTypeName | 1..1 | String 100 |
Libellé du type de la compétence Référentiel : Types de compétence |
results.skills.skillCode | 0..1 | String 6 |
Code de la compétence Référentiel : Compétences |
results.skills.skillName | 1..1 | String 240 |
Libellé de la compétence Référentiel : Compétences |
results.skills.requiredSkillCode | 0..1 | String 1 |
Code d'exigence de la compétence Référentiel : Exigibilités |
results.skills.requiredSkillName | 0..1 | String 100 |
Libellé de l'exigence de la compétence Référentiel : Exigibilités |
results.travelFrequencyCode | 0..1 | String 10 |
Code de la fréquence de déplacement Référentiel : Fréquences de déplacement |
results.travelFrequencyName | 0..1 | String 73 |
Libellé de la fréquence de déplacement Référentiel : Fréquences de déplacement |
results.isWorkAlternately | 0..1 | Integer 1 |
Indicateur alternance Valeurs possibles :
|
results.isDisabledAccessibility | 0..1 | Integer 1 |
Accessibilité aux travailleurs handicapés Valeurs possibles :
|
results.numberVacancies | 0..1 | Integer 3 |
Nombre de postes restants |
results.isLackCandidate | 0..1 | Integer 1 |
Top indiquant si l’offre est en manque de candidat Valeurs possibles :
|
results.agencyModalityInterviewCode | 0..1 | String 3 |
Code du mode de présentation agence Référentiel : Modes de présentation agence |
results.agencyModalityInterviewName | 0..1 | String 100 |
Libellé du mode de présentation agence Référentiel : Modes de présentation agence |
results.companyModalityInterviewCode | 0..1 | String 3 |
Code du mode de présentation entreprise Référentiel : Modes de présentation employeur |
results.companyModalityInterviewName | 0..1 | String 100 |
Libellé du mode de présentation entreprise Référentiel : Modes de présentation employeur |
results.preselectionCode | 0..1 | String 3 |
Code de la présélection Référentiel : Présélections |
results.preselectionName | 0..1 | String 100 |
Libellé de la présélection Référentiel : Présélections |
results.companyName | 0..1 | String 52 |
Nom de l'entreprise |
results.companyDescription | 0..1 | String 1000 |
Description de l'entreprise |
results.companyWorkforceCode | 0..1 | String 1 |
Code la tranche d’effectif de l'entreprise Référentiel : Tranches d’effectif |
results.companyWorkforceName | 0..1 | String 32 |
Libellé de la tranche d’effectif de l'entreprise Référentiel : Tranches d’effectif |
results.companyUrl | 0..1 | String 300 |
URL de l'entreprise |
results.contactName | 0..1 | String 100 |
Nom du contact direct de l'offre |
results.contactDetails1 |
0..1 | String 300 |
1ière ligne coordonnées du contact direct de l’offre |
results.contactDetails2 | 0..1 | String 120 |
2ième ligne coordonnées du contact direct de l’offre |
results.contactDetails3 | 0..1 | String 120 |
3ième ligne coordonnées du contact direct de l’offre |
results.contactComment | 0..1 | String 72 |
Commentaire liés au contact |
results.companyContactPhone | 0..1 | String 20 |
N° Téléphone du correspondant entreprise pour l'offre |
results.companyContactEmail | 0..1 | String 80 |
Mail du correspondant entreprise pour l'offre |
results.companyOfferUrl | 0..1 | String 300 |
URL de l’offre chez le recruteur |
results.agencyContactPhone | 0..1 | String 20 |
N° Téléphone de la structure d'accueil |
results.contactFromUrl | 0..1 | String 300 |
URL de modalité de contact |
results.origins | 1..15 | Sous balise |
Liste des sources de l’offre |
results.origins.originCode | 0..1 | String 50 |
Code de la source |
results.origins.originName | 0..1 | String 50 |
Nom de la source |
results.origins.originUrl | 0..1 | String 300 |
URL de la source |
Exemple de retour
HTTP 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
{
"technicalParameters" : [
"startResults": 100,
"endResults": 120,
"totalNumber": 1500
],
"results": [
{…}, {…}
]
}
Cas d'erreurs possibles
Retrouvez la liste des cas d'erreurs possibles sur la page Erreurs Types.
Syntaxe de la requête erronée :
HTTP 400 Bad request
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache
{
"codeErreur": "1493122545781",
"codeHttp": 400,
"message": "La donnée keywords doit être une chaîne comprise entre 2 et 99 caractères."
}
Message |
---|
La donnée [code] est obligatoire. |
La donnée [code1] est obligatoire si la donnée [code2] est renseignée. |
Les données [code1] et [code2] sont exclusives. |
La donnée [code] ne doit pas contenir plus de x occurrences. |
La donnée [code] doit être un entier compris entre x et y. |
La donnée [code] doit être un décimal compris entre x et y. |
La donnée [code] doit être une chaîne de y caractères. |
La donnée [code] doit être une chaîne comprise entre x et y caractères. |
La donnée [code] doit être au format [aA-zZ]*[0-9]*[\\s]*[@#$%^&+./-\"]*. |
La donnée [code] doit être au format ISO-8601 (YYYY-MM-DD'T'HH:MM:SSZ). |
La donnée [code] doit correspondre à une des valeurs du référentiel associé. |
La combinaison du numéro de page et du nombre de résultats maximum souhaité par page est limitée à 1000 offres. |