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.
La combinaison du numéro de page et du nombre maximum de résultats souhaité par page retourne au maximum 1000 offres.

technicalParameters.per_page 1 Integer 3

Nombre de résultats maximum souhaités par page

Entier positif compris entre 1 et 150.
La combinaison du numéro de page et du nombre maximum de résultats souhaité par page retourne au maximum 1000 offres.

technicalParameters.sort 1 Integer 1

Tri des données

Valeurs possibles :

  • 0 → Tri par pertinence décroissante, distance croissante, date de création décroissante
  • 1 → Tri par date de création décroissant, pertinence décroissante, distance croissante
  • 2 → Tri par distance croissante, pertinence décroissante, date de création décroissante
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 :

  • 0 → Non cadre
  • 9 → Cadre
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.
Caractères autorisés : [aA-zZ]+[0-9]+[espace]+[@#$%^&+./-""]

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 Paris, l’ensemble des offres de Paris sont remontées pour :

  • Une recherche effectuée sur un arrondissement de Paris ou si le centre de Paris est atteint par le rayon de distance recherché,
  • Une recherche effectuée sur le département 75 (Paris).

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 : 0
Valeur maximum : 200

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 :

  • 0 → Non
  • 1 → Oui
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
complété des valeurs :

  • 03 → ALLEMAGNE (Frontalier)
  • 05 → BELGIQUE (Frontalier)
  • 08 → ESPAGNE (Frontalier)
  • 15 → ITALIE (Frontalier)
  • 17 → LUXEMBOURG (Frontalier)
  • 10 → ROYAUME-UNI (Frontalier)
  • 24 → SUISSE (Frontalier)
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 :

  • Continents
  • Sous continents
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 :

  • 0.5 pour 15 jours
  • 2.0 pour 2 mois
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 :

  • 0.5 pour 15 jours
  • 2.0 pour 2 mois
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 :

  • 0 → Non
  • 1 → Oui
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ù :

  • <p> est l’index (débutant à 0) du premier élément renvoyé
  • <d> est l’index de dernier élément renvoyé
  • <t> est le nombre total d’éléments de la recherche
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 :

  • 0 → Non
  • 1 → Oui
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 :

  • 0 → Non
  • 1 → Oui
results.isDisabledAccessibility 0..1 Integer 1

Accessibilité aux travailleurs handicapés

Valeurs possibles :

  • 0 → Non
  • 1 → Oui
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 :

  • 0 → Non
  • 1 → Oui
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.