Rechercher des entreprises
Présentation
Cette ressource permet de récupérer les entreprises à fort potentiel d’embauche (par ordre de score décroissant).
Description de la requête
Point d'accès
GET https://api.emploi-store.fr/partenaire/labonneboite/v1/company/
Paramètres d'entrée
Code | Cardinalité | Format | Description |
---|---|---|---|
commune_id |
0,1 Conditionné |
String |
Code INSEE de la commune à proximité de laquelle on recherche des entreprises à fort potentiel d’embauche. Si ce paramètre n'est pas renseigné, il est nécessaire d'indiquer la latitude et la longitude. Référentiel : Géographie administrative de l'Insee |
contract | 0,1 | String |
Type de contrat Valeurs possibles :
|
latitude |
0,1 Conditionné |
Float |
Latitude du point géographique à proximité duquel on recherche des entreprises à fort potentiel d’embauche. Si ce paramètre n'est pas renseigné, il est nécessaire d'indiquer le code INSEE de la commune. |
longitude |
0,1 Conditionné |
Float |
Longitude du point géographique à proximité duquel on recherche des entreprises à fort potentiel d’embauche. Si ce paramètre n'est pas renseigné, il est nécessaire d'indiquer le code INSEE de la commune. |
distance | 0,n | Integer |
Périmètre du rayon de recherche (en kilomètres) autour du point géographique défini par le couple longitude / latitude ou le code INSEE de la commune. Par défaut, cette distance est de 10 km. |
rome_codes |
0,n Conditionné |
String |
Codes métiers ROME (exemple : "A1501") pour lesquels des entreprises embauchent potentiellement. Vous devez utiliser soit `rome_codes`, soit `rome_codes_keyword_search`. Il est fortement recommandé d'utiliser `romes_codes` qui donnera en général des résultats de meilleure qualité. Référentiel : Répertoire Opérationnel des Métiers et des Emplois |
rome_codes_keyword_search |
0,1 Conditionné |
String |
Mots clé (exemple : "boucher" ou "animateur vente") utilisés pour déterminer automatiquement un code ROME. Vous devez utiliser soit `rome_codes_keyword_search`, soit `rome_codes`. Il est fortement recommandé d'utiliser `romes_codes` qui donnera en général des résultats de meilleure qualité. Attention : réponse 400 si aucun ROME ne matche les mots clés demandés. |
naf_codes | 0,n | String |
Liste de codes métier NAF (exemple : "9499Z,5610C") ou simplement un seul code métier (exemple : "9499Z") associés aux entreprises. Ce champ est optionnel, par défaut la recherche s'étendra automatiquement à tous les codes NAF pertinents pour le code ROME demandé. Référentiel : Nomenclature d'activités française de l'Insee (rév. 2, 2008 - Niveau 2 - Liste des divisions) |
headcount | 0,1 | String |
Taille de l'entreprise Valeurs possibles :
|
page | 0,1 | Integer |
Numéro de la page demandée. Par défaut, la page restituée est la première. |
page_size | 0,1 | Integer |
Nombre de résultats par page. Par défaut, le service restitue les 20 premiers résultats. La valeur maximale est 100. |
sort | 0,1 | String |
Ordre des résultats Valeurs possibles :
|
Exemple d'appel
GET https://api.emploi-store.fr/partenaire/labonneboite/v1/company/?distance=30&latitude=49.119146&longitude=6.17602&rome_codes=M1607
Authorization: Bearer [Access token]
Description de la réponse
Lors de la réponse de l'API, une redirection (code HTTP 302 Found) est réalisée du domaine https://api.emploi-store.fr/api/lbb/v1/company
vers le domaine https://labonneboite.pole-emploi.fr/api/v1/company/
.
Vous devez explicitement indiquer à votre client HTTP de suivre les redirections car il ne le fait probablement pas par défaut. Par exemple pour le client curl, il est nécéssaire d'utiliser curl --location
(ou curl -L
).
Données retournées
Code | Cardinalité | Format | Description |
---|---|---|---|
companies | 0,n | Object | Liste des entreprises répondant aux critères |
companies.siret | 1,1 | String | Numéro de SIRET de l’entreprise |
companies.name | 1,1 | String | Enseigne de l'entreprise si disponible, sinon raison sociale |
companies.address | 1,1 | String | Adresse de l’entreprise |
companies.city | 1,1 | String | Ville de l’entreprise |
companies.contact_mode | 1,1 | String | Mode de contact à privilégier pour contacter l'entreprise |
companies.distance | 1,1 | Integer | Distance du point géographique demandé (en kilomètres) |
companies.headcount_text | 1,1 | String | Libellé du nombre d’employés pour cette entreprise |
companies.naf | 1,1 | String |
Secteur d’activité de l’entreprise concernée Référentiel : Nomenclature d'activités française de l'Insee (rév. 2, 2008 - Niveau 2 - Liste des divisions) |
companies.naf_text | 1,1 | String |
Libellé du secteur d'activité de l’entreprise concernée Référentiel : Nomenclature d'activités française de l'Insee (rév. 2, 2008 - Niveau 2 - Liste des divisions) |
companies.lon | 1,1 | Float | Longitude du point géographique de l'entreprise |
companies.lat | 1,1 | Float | Latitude du point géographique de l'entreprise |
companies.raison_sociale | 1,1 | String | Raison sociale de l'entreprise |
match_rome_code | 1,1 | String | Code ROME le plus pertinent (parmi ceux présents dans la requête) |
match_rome_label | 1,1 | String | Libellé du ROME le plus pertinent (parmi ceux présents dans la requête) |
match_rome_slug | 1,1 | String | Slug du libellé du ROME le plus pertinent (parmi ceux présents dans la requête) |
companies.stars | 1,1 | Integer | Potentiel d’embauche (nombre d'étoiles), de 0 à 5 |
companies.url | 1,1 | String | Lien absolu vers la fiche de l'entreprise sur le site La Bonne Boite |
companies.alternance | 1,1 | Boolean | Candidatures pour de l’alternance possibles |
companies_count | 1,1 | String | Nombre total d'entreprises correspondant à la recherche |
url | 1,1 | String | URL frontend de la recherche si possible, ou sinon URL de la page d'accueil |
rome_code | 1,1 | String | Code ROME utilisé pour la recherche |
rome_label | 1,1 | String | Libellé du code ROME utilisé pour la recherche |
Exemple de retour
HTTP 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
{
"companies": [
{
"address": "CAISSE D'EPARGNE ET DE PREVOYANCE DE L, CAISSE D'EPARGNE, Service des ressources humaines, 5 PARVIS DES DROITS DE L HOMME, 57000 METZ",
"alternance" : false,
"city": "METZ",
"contact_mode": "Envoyer un CV et une lettre de motivation",
"distance": 0,
"headcount_text": "250 à 499 salariés",
"lat": 49.11613,
"lon": 6.1727,
"naf": "7010Z",
"naf_text": "Activités des sièges sociaux",
"name": "CAISSE D'EPARGNE",
"raison_sociale": "CAISSE D'EPARGNE ET DE PREVOYANCE",
"siret": "77561862203725",
"stars": 4,
"url": "http://labonneboite.pole-emploi.fr/77561862203725/details"
},
{
"address": "ARTISANS RADIO TAXIS DE METZ, , 2 RUE LAFAYETTE, 57000 METZ",
"alternance" : true,
"city": "METZ",
"contact_mode": "Se présenter spontanément",
"distance": 1,
"headcount_text": "6 à 9 salariés",
"lat": 49.109,
"lon": 6.174795,
"naf": "8299Z",
"naf_text": "Autres activités de soutien aux entreprises nca",
"name": "ARTISANS RADIO TAXIS DE METZ",
"raison_sociale": "ARTISANS RADIO TAXIS DE METZ",
"siret": "31807235200020",
"stars": 4,
"url": "http://labonneboite.pole-emploi.fr/31807235200020/details"
}],
"companies_count": 649,
"rome_code": "M1607",
"rome_label": "Secrétariat",
"url": "https://labonneboite.pole-emploi.fr/"
}
Cas d'erreurs possibles
Retrouvez la liste des cas d'erreurs possibles sur la page Erreurs Types.
API en cours de maintenance :
HTTP 502 Bad gateway
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache
L'API est susceptible de connaitre occasionnellement de brèves indisponibilités (micro-coupures pendant certains déploiements).
Par conséquent, votre application doit contrôler le code retour de l'API. Le code HTTP 502 signifie que l'API est temporairement indisponible. Vous pourrez retenter l'appel quelques secondes plus tard.
Syntaxe de la requête erronnée :
HTTP 400 Bad request
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache
{
"codeErreur": "1493122545783",
"codeHttp": 400,
"message": "Aucun code_rome trouvé"
}
La réponse 400 s'accompagne d'un message explicite qui vous indique le problème rencontré par votre requête :
- code_commune inconnu
- Aucun code_rome trouvé (uniquement si vous utilisez rome_code_keyword_search)