# French Jobs and Outcomes by Area: Employment and Training (`geckostar/metiers-debouches-territoire`) Actor

For each job (ROME code) and each French department or region: jobseekers' return to work, training leavers, 6-month employment access rate of the courses that lead to the job, key skills. France Travail statistics, with statistical confidentiality applied.

- **URL**: https://apify.com/geckostar/metiers-debouches-territoire.md
- **Developed by:** [Gecko Lab](https://apify.com/geckostar) (community)
- **Categories:** Jobs, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $50.00 / 1,000 profile built (publisher's key)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Jobs and Outcomes by French Area: return to work, training and employment access

One job, one area, one profile: pick jobs (ROME codes) and French departments, regions or the whole of France, and get
in one row what France Travail publishes across three separate APIs (return to work, training leavers, employment
access after training, job markers). For training providers, HR and outplacement firms, local authorities and
employment services. **Price: $0.02 per profile with your own free francetravail.io credentials; without them,
$0.005 per run that returns results plus $0.05 per profile.**

**Independent tool: not published, endorsed or sponsored by France Travail; France Travail is named here only as the data source.**

For each job and each area, the profile gathers:

- **return to work** of jobseekers looking for this job in the area: count and rate for the latest quarter, compared
  with the rate for France as a whole in the same quarter, with the series of the last 4 quarters;
- **training leavers** aiming at this job: count per quarter and total over one year;
- **training courses that lead to the job** (ROME formacodes, 5 at most): 6-month employment access rate after each
  one in the area, compared with France as a whole, and the course with the best employment access rate;
- **job markers** from the ROME: key skills (10 at most), business sectors, managerial or regulated job, job affected
  by the digital or green transition.

No artificial intelligence: the figures come straight from France Travail's official APIs.

### Price

- **With your francetravail.io credentials**: $0.02 per profile.
- **Without credentials**: $0.005 to start (once per run, only with the first result), then $0.05 per profile.

Example: 3 jobs in 5 departments = 15 profiles = $0.30 with your credentials.

Only profiles carrying at least one publishable figure for the area are charged (`facturable` column). A profile
whose values are all masked by statistical confidentiality is saved but not charged, as is a department profile whose
publishable figures are all those of its region (`taux_identique_region`). Unknown ROME codes produce neither a
profile nor a charge. The start fee without credentials is only charged with the first charged profile, and only if
your spending limit covers both the start fee and that profile.

### Two ways to use it

| | With your credentials | Without credentials |
|---|---|---|
| What you provide | the client ID and secret of your francetravail.io application (free) | nothing: the developer's key is used |
| Price | lowest | higher |
| Jobs per run | 10 at most | 3 at most |
| Areas per run | 20 at most | 5 at most |
| Profiles (jobs × areas) | 100 at most | 10 at most |
| France Travail requests | 1,200 at most | 180 at most, login included |

The developer's key is shared between all users of this mode. If France Travail briefly limits requests, the tool
waits and retries; if the developer's key is refused or still limited after four attempts, the run stops cleanly, the
profiles already built are kept and you are invited to enter your own credentials.

### Create your francetravail.io credentials

1. Create an account on **francetravail.io** (France Travail's partner portal), then log in.
2. Open **Mes applications** (My applications) and create an application. In its description, declare its use:
   querying the APIs below from this tool, "Métiers et débouchés par territoire", a web service published on Apify.
   The credentials are tied to the application you declare (francetravail.io terms of use, art. 5.3).
3. Subscribe the application to these three APIs, accepting their terms of use: **"ROME 4.0 - Métiers"**, **"Accès à
   l'emploi des demandeurs d'emploi"** and **"Sortants de formation et accès à l'emploi"**. If one is missing, the tool
   names it before any charge.
4. Copy the application's client ID ("identifiant client") and secret ("clé secrète") into the "francetravail.io
   client ID" and "francetravail.io secret" fields.

By entering your credentials, you entrust them to this tool for the duration of the run only; they are encrypted by
Apify and never appear in the log or in the results. The tool only sends them to France Travail, to log in. You use
the APIs under your own account and accept their terms of use.

### Input

| Console label | Default | Purpose |
|---|---|---|
| francetravail.io client ID, francetravail.io secret | empty | Your francetravail.io application. Both empty: the developer's key is used |
| ROME codes (jobs) | M1805 | Jobs to study, 10 at most (3 without credentials) |
| Departments | 31 | Department codes: 31, 75, 2A, 971… |
| Regions (Insee codes) | empty | 11 (Île-de-France), 76 (Occitanie), 84 (Auvergne-Rhône-Alpes)… |
| Whole of France | unticked | Adds a national profile for each job |
| Compare with France as a whole | ticked | Adds the national rate for the same quarter, at no extra cost |

Give at least one ROME code and one area. The tool queries job by job: it does not list the whole job classification.

**Find a ROME code**: each France Travail job sheet carries its code, on MétierScope
(https://candidat.francetravail.fr/metierscope/). Examples: M1805 (software developer), G1603 (fast-food crew member),
J1501 (care assistant).

### Output

One row per job and per area:

| Field | Content |
|---|---|
| `code_rome`, `metier` | Job code and title |
| `territoire_type`, `territoire_code`, `territoire` | departement, region or france; code; name |
| `trimestre` | Reference quarter for return to work (for example 2026T1) |
| `retours_emploi`, `taux_retour_emploi_pct` | Category A and B jobseekers looking for this job who found a job of more than one month in the quarter, and their rate |
| `taux_retour_emploi_france_pct` | Same rate for France as a whole, in the same quarter |
| `taux_identique_region` | Department: true if one of its rates is strictly equal to its region's, for the same quarter and indicator (the rate is then not specific to the area); empty for a region or France |
| `sortants_formation_4_trimestres` | Jobseekers leaving training who are looking for this job, over the last 4 quarters |
| `meilleure_formation`, `taux_acces_emploi_6_mois_pct` | Training course linked to the job with the best 6-month employment access rate in the area, and that rate |
| `retour_emploi`, `sortants_formation` | Indicator definition and series of the last 4 quarters |
| `formations` | For each course (formacode): quarter, 6-month employment access (count and rate), France rate for the same quarter, series |
| `competences_cles`, `secteurs_naf`, `domaine_professionnel` | Job markers from the ROME |
| `emploi_cadre`, `emploi_reglemente`, `transition_numerique`, `transition_ecologique`, `metier_obsolete` | ROME flags |
| `statistiques_indisponibles` | Statistics France Travail could not provide during the run |
| `version_rome`, `statistiques_mises_a_jour_le` | ROME version and update date of the statistics by France Travail |
| `mention_source`, `avertissement`, `consulte_le` | Source and date notice, independence notice, access time |
| `mode` | `cle_utilisateur` (your credentials) or `cle_editeur` (developer's key) |
| `facturable` | True if the profile carries at least one publishable figure that is not the region's: it is then charged once |

**Reading the figures.**

- **Statistical confidentiality**: any value covering fewer than 5 people is masked, together with its rate
  (`secret_statistique` true, value empty). France Travail publishes rounded counts.
- **Unconsolidated quarter**: for 6-month employment access after a training course, the most recent quarter
  published by France Travail is not yet consolidated; its count is given, not its rate (`taux_non_consolide`). The
  profile uses the latest consolidated quarter.
- **Small numbers**: in a small area, a rate based on a few dozen people varies strongly from one quarter to the next.
  In some small areas, France Travail appears to publish the region's rate (observed: Lozère and Occitanie): the
  profile flags it (`taux_identique_region`) and the rate is then not specific to the area. Read it with the series
  and the national rate.
- These are statistics on jobseekers registered with France Travail, not a measure of the whole labour market.

The run stops cleanly after all the requested profiles, at your spending limit, at the request ceiling or after 25
minutes. Refused credentials, or an application not subscribed to one of the three APIs, make the run fail before any
charge. Output field names are in French.

### Sources

| Source | What it provides |
|---|---|
| France Travail, ROME 4.0 - Métiers API | title, key skills, sectors, training courses linked to the job |
| France Travail, Accès à l'emploi des demandeurs d'emploi API | return to work of jobseekers looking for the job (indicator ACC_1) |
| France Travail, Sortants de formation et accès à l'emploi API | training leavers (DE_3) and 6-month employment access after training (ACC_2) |

Each row carries the following notice (`mention_source`, in French), completed with the ROME version and the dates:

"Source: France Travail, ROME 4.0 - Métiers API (ROME version \[n]), Accès à l'emploi des demandeurs d'emploi API and
Sortants de formation et accès à l'emploi API, accessed on \[date]; statistics updated by France Travail on \[date].
Counts published rounded by the source; any value covering fewer than 5 people is masked (statistical
confidentiality)."

Keep this notice when re-using the data. The data is made available by France Travail under the Licence Ouverte 2.0
(Etalab), subject to the francetravail.io terms of use. This tool adds no further restriction on the re-use of the
delivered data.

### Personal data

The tool processes **no personal data**: it only reads aggregate statistics published by France Travail (counts and
rates by job, area and quarter) and job reference data. No breakdown by sex, age or any other characteristic is
published, and any value covering fewer than 5 people is masked. The publisher keeps no results: data is read on each
run and stored only in the user's Apify account.

### Related Actors

- [Companies Hiring in France](https://apify.com/geckostar/entreprises-qui-recrutent): establishments France Travail
  rates as likely to hire within 6 months, by job (ROME code) or sector and area.

***

## Version française — Métiers et débouchés par territoire

> **Outil indépendant : il n'est ni édité, ni approuvé, ni parrainé par France Travail. France Travail est cité ici
> comme source des données.**

**Un métier, un territoire, une fiche.** Choisissez des métiers (codes ROME) et des départements, des régions ou la
France entière. Pour chaque métier et chaque territoire, l'outil réunit en une ligne ce que France Travail publie
dans trois API distinctes :

- **retour à l'emploi** des demandeurs d'emploi qui recherchent ce métier sur le territoire : nombre et taux du
  dernier trimestre, comparés au taux de la France entière au même trimestre, avec la série des 4 derniers trimestres ;
- **sortants de formation** qui visent ce métier : nombre par trimestre et cumul sur un an ;
- **formations qui mènent au métier** (formacodes du ROME, 5 au plus) : taux d'accès à l'emploi à 6 mois après
  chacune sur le territoire, comparé à la France entière, et la formation au meilleur taux d'accès à l'emploi ;
- **repères du métier** selon le ROME : compétences clés (10 au plus), secteurs d'activité, emploi de cadre ou
  réglementé, métier concerné par la transition numérique ou écologique.

Pour les organismes de formation (quelle formation ouvrir, où, avec quel débouché), les cabinets de ressources
humaines et d'outplacement, les collectivités et les services emploi des territoires.

Aucune intelligence artificielle : les chiffres viennent directement des API officielles de France Travail.

### Prix

- **Avec vos identifiants francetravail.io** : 0,02 $ par fiche.
- **Sans identifiants** : 0,005 $ de lancement (une fois par exécution) puis 0,05 $ par fiche.

Exemple : 3 métiers dans 5 départements = 15 fiches = 0,30 $ avec vos identifiants.

Seules les fiches qui portent au moins une statistique publiable sur le territoire sont facturées (colonne
`facturable`). Une fiche dont toutes les valeurs sont masquées par le secret statistique est enregistrée, mais pas
facturée, de même qu'une fiche de département dont toutes les statistiques publiables sont celles de sa région
(`taux_identique_region`). Les codes ROME inconnus ne produisent ni fiche ni facture. Le lancement sans identifiants
n'est facturé qu'avec la première fiche facturée, et seulement si votre limite de dépense couvre le lancement et
cette fiche.

### Deux façons de l'utiliser

| | Avec vos identifiants | Sans identifiants |
|---|---|---|
| Ce que vous fournissez | l'identifiant et le secret de votre application francetravail.io (gratuite) | rien : la clé de l'éditeur est utilisée |
| Prix | le plus bas | plus élevé |
| Métiers par exécution | 10 au plus | 3 au plus |
| Territoires par exécution | 20 au plus | 5 au plus |
| Fiches (métiers × territoires) | 100 au plus | 10 au plus |
| Consultations de France Travail | 1 200 au plus | 180 au plus, connexion comprise |

La clé de l'éditeur est partagée entre tous les utilisateurs de ce mode. Si France Travail limite momentanément les
demandes, l'outil attend et réessaie ; si la clé de l'éditeur est refusée ou reste limitée après quatre essais,
l'exécution s'arrête proprement, les fiches déjà construites sont conservées et il vous est proposé de saisir vos
identifiants.

### Créer vos identifiants francetravail.io

1. Créez un compte sur **francetravail.io** (espace des partenaires de France Travail), puis connectez-vous.
2. Ouvrez **Mes applications** et créez une application. Dans sa description, déclarez son usage : interroger les
   API ci-dessous depuis cet outil, « Métiers et débouchés par territoire », service web publié sur Apify. Les
   identifiants sont liés à l'application que vous déclarez (conditions d'utilisation de francetravail.io, art. 5.3).
3. Abonnez l'application à ces trois API, en acceptant leurs conditions d'utilisation :
   **« ROME 4.0 - Métiers »**, **« Accès à l'emploi des demandeurs d'emploi »** et **« Sortants de formation et
   accès à l'emploi »**. S'il en manque une, l'outil la nomme avant toute facturation.
4. Copiez l'identifiant (« identifiant client ») et le secret (« clé secrète ») de l'application dans les champs
   « francetravail.io client ID » et « francetravail.io secret ».

En renseignant vos identifiants, vous les confiez à cet outil pour la seule durée de l'exécution ; ils sont chiffrés
par Apify et n'apparaissent jamais dans le journal ni dans les résultats. L'outil ne les envoie qu'à France Travail,
pour se connecter. Vous utilisez les API sous votre propre compte et vous en acceptez les conditions d'utilisation.

### Entrée

| Libellé dans la console (en anglais) | Valeur proposée | À quoi ça sert |
|---|---|---|
| francetravail.io client ID, francetravail.io secret | vides | Votre application francetravail.io. Vides tous les deux : la clé de l'éditeur est utilisée |
| ROME codes (jobs) | M1805 | Métiers à étudier, 10 au plus (3 sans identifiants) |
| Departments | 31 | Codes de département : 31, 75, 2A, 971… |
| Regions (Insee codes) | vide | 11 (Île-de-France), 76 (Occitanie), 84 (Auvergne-Rhône-Alpes)… |
| Whole of France | décochée | Ajoute une fiche nationale pour chaque métier |
| Compare with France as a whole | cochée | Ajoute le taux national au même trimestre, sans surcoût |

Indiquez au moins un code ROME et un territoire. L'outil interroge métier par métier : il ne liste pas le
référentiel des métiers.

**Trouver un code ROME** : chaque fiche métier de France Travail porte son code, sur MétierScope
(https://candidat.francetravail.fr/metierscope/). Exemples : M1805 (développeur informatique), G1603 (équipier de
restauration rapide), J1501 (aide-soignant).

### Sortie

Une ligne par métier et par territoire :

| Champ | Contenu |
|---|---|
| `code_rome`, `metier` | Code et intitulé du métier |
| `territoire_type`, `territoire_code`, `territoire` | departement, region ou france ; code ; nom |
| `trimestre` | Trimestre de référence du retour à l'emploi (par exemple 2026T1) |
| `retours_emploi`, `taux_retour_emploi_pct` | Demandeurs d'emploi de catégories A et B recherchant ce métier ayant retrouvé un emploi de plus d'un mois dans le trimestre, et leur taux |
| `taux_retour_emploi_france_pct` | Même taux pour la France entière, au même trimestre |
| `taux_identique_region` | Département : vrai si l'un de ses taux est strictement égal à celui de sa région, au même trimestre et pour le même indicateur (taux alors non propre au territoire) ; vide pour une région ou la France |
| `sortants_formation_4_trimestres` | Demandeurs d'emploi sortis de formation qui recherchent ce métier, sur les 4 derniers trimestres |
| `meilleure_formation`, `taux_acces_emploi_6_mois_pct` | Formation liée au métier qui a le meilleur taux d'accès à l'emploi à 6 mois sur le territoire, et ce taux |
| `retour_emploi`, `sortants_formation` | Définition de l'indicateur et série des 4 derniers trimestres |
| `formations` | Pour chaque formation (formacode) : trimestre, accès à l'emploi à 6 mois (nombre et taux), taux France au même trimestre, série |
| `competences_cles`, `secteurs_naf`, `domaine_professionnel` | Repères du métier selon le ROME |
| `emploi_cadre`, `emploi_reglemente`, `transition_numerique`, `transition_ecologique`, `metier_obsolete` | Indicateurs du ROME |
| `statistiques_indisponibles` | Statistiques que France Travail n'a pas pu fournir pendant l'exécution |
| `version_rome`, `statistiques_mises_a_jour_le` | Version du ROME et date de mise à jour des statistiques par France Travail |
| `mention_source`, `avertissement`, `consulte_le` | Mention des sources et des dates, mention d'indépendance, heure de consultation |
| `mode` | `cle_utilisateur` (vos identifiants) ou `cle_editeur` (clé de l'éditeur) |
| `facturable` | Vrai si la fiche porte au moins une statistique publiable qui n'est pas celle de la région : elle est alors facturée une fois |

**Lire les chiffres.**

- **Secret statistique** : toute valeur qui porte sur moins de 5 personnes est masquée, ainsi que son taux
  (`secret_statistique` vrai, valeur vide). France Travail publie les effectifs arrondis.
- **Trimestre non consolidé** : pour l'accès à l'emploi à 6 mois après une formation, le trimestre le plus récent
  publié par France Travail n'est pas encore consolidé ; son effectif est donné, pas son taux (`taux_non_consolide`).
  La fiche retient le trimestre consolidé le plus récent.
- **Petits effectifs** : sur un petit territoire, un taux calculé sur quelques dizaines de personnes varie fortement
  d'un trimestre à l'autre. Sur certains petits territoires, France Travail semble publier le taux de la région
  (constaté : Lozère et Occitanie) : la fiche le signale (`taux_identique_region`) et ce taux n'est alors pas propre
  au territoire. Lisez-le avec la série
  et avec le taux de la France entière.
- Ce sont des statistiques sur des demandeurs d'emploi inscrits à France Travail, pas une mesure de l'ensemble du
  marché du travail.

L'exécution s'arrête proprement après toutes les fiches demandées, à votre limite de dépense, au plafond de
consultations ou après 25 minutes. Des identifiants refusés, ou une application non abonnée à l'une des trois API,
font échouer l'exécution avant toute facturation.

### Sources

| Source | Ce qu'elle apporte |
|---|---|
| France Travail, API ROME 4.0 - Métiers | intitulé, compétences clés, secteurs, formations liées au métier |
| France Travail, API Accès à l'emploi des demandeurs d'emploi | retour à l'emploi des demandeurs d'emploi qui recherchent le métier (indicateur ACC_1) |
| France Travail, API Sortants de formation et accès à l'emploi | sortants de formation (DE_3) et accès à l'emploi à 6 mois après une formation (ACC_2) |

Chaque ligne porte la mention suivante (`mention_source`), complétée de la version du ROME et des dates :

« Source : France Travail, API ROME 4.0 - Métiers (ROME version \[n]), API Accès à l'emploi des demandeurs d'emploi
et API Sortants de formation et accès à l'emploi, consultées le \[date] ; statistiques mises à jour par France
Travail le \[date]. Effectifs publiés arrondis par la source ; toute valeur portant sur moins de 5 personnes est
masquée (secret statistique). »

Toute réutilisation doit conserver cette mention. Les données sont mises à disposition par France Travail sous la
Licence Ouverte 2.0 (Etalab), selon les conditions d'utilisation de francetravail.io. Cet outil ne pose aucune
restriction supplémentaire à la réutilisation des données livrées.

### Données personnelles

L'outil ne traite **aucune donnée personnelle** : il ne lit que des statistiques agrégées publiées par France
Travail (nombres et taux par métier, territoire et trimestre) et des éléments du référentiel des métiers. Aucune
ventilation par sexe, âge ou autre caractéristique n'est publiée, et toute valeur qui porte sur moins de 5 personnes
est masquée. L'éditeur ne garde aucun résultat : les données sont lues à chaque exécution et enregistrées dans le
seul compte Apify de l'utilisateur.

***

### Conditions d'utilisation / Terms

Outil destiné aux professionnels. Les données viennent de France Travail (API ROME 4.0 - Métiers, Accès à l'emploi des demandeurs d'emploi, Sortants de formation et accès à l'emploi), interrogées avec vos identifiants ou avec la clé de l'éditeur. Elles sont mises à disposition par France Travail sous la Licence Ouverte 2.0 (Etalab), selon les conditions d'utilisation de francetravail.io ; cet outil ne pose aucune restriction supplémentaire à la réutilisation des données livrées. Conservez la mention de la source et des dates, et ne laissez pas croire à une caution de France Travail. Les taux sont des statistiques sur des demandeurs d'emploi inscrits à France Travail, pas une prévision ni une garantie d'embauche. Données lues au moment de l'exécution, sans garantie d'exhaustivité ni d'actualité. Dans les limites permises par la loi, l'éditeur ne répond pas des décisions prises sur la seule base de ces résultats, ni de l'usage que l'utilisateur en fait. Cette clause n'écarte aucun droit que la loi réserve aux consommateurs, notamment la garantie légale de conformité des contenus et services numériques.

Intended for business use. Data comes from France Travail (ROME 4.0 - Métiers, Accès à l'emploi des demandeurs d'emploi, Sortants de formation et accès à l'emploi APIs), queried with your credentials or the developer's key. It is made available by France Travail under the Licence Ouverte 2.0 (Etalab), subject to the francetravail.io terms of use; this tool adds no further restriction on the reuse of the delivered data. Keep the source and date notice and do not imply any endorsement by France Travail. Rates are statistics on jobseekers registered with France Travail, not a forecast or a guarantee of employment. No guarantee of completeness or freshness. To the extent permitted by law, the developer is not liable for decisions based solely on these results or for the user's use of them. Nothing here limits statutory consumer rights.

### Mentions légales / Legal notice

- Éditeur et vendeur / Publisher and seller : Audric Moussaoui, entrepreneur individuel (EI), pseudonyme « geckostar » / pseudonym "geckostar"
- Adresse / Address : 88 rue Oberkampf, 75011 Paris, France
- Téléphone / Phone : +33 6 95 11 28 15
- Courriel / E-mail : audricmm@gmail.com
- SIREN : en cours d'attribution, déclaration d'activité déposée le 24/10/2026 / being assigned, registration filed on 24 October 2026
- Directeur de la publication / Publication director : Audric Moussaoui
- TVA non applicable, art. 293 B du CGI / VAT not applicable (French VAT franchise, art. 293 B CGI)
- Hébergement / Hosting : Apify Technologies s.r.o., Vodičkova 704/36, 110 00 Prague 1, République tchèque / Czech Republic (hello@apify.com)

# Actor input Schema

## `clientId` (type: `string`):

Optional. Client ID of YOUR application on francetravail.io (free, subscribed to the “ROME 4.0 - Métiers”, “Accès à l'emploi des demandeurs d'emploi” and “Sortants de formation et accès à l'emploi” APIs): lowest price and higher limits. If you leave this field and the secret empty, the developer's key is used: higher price, 3 jobs, 5 areas and 10 profiles at most per run.

## `clientSecret` (type: `string`):

Optional, with the client ID. Secret of your francetravail.io application. You entrust it to this tool for the duration of the run only: it is encrypted by Apify and never appears in the log or in the results.

## `romeCodes` (type: `array`):

Jobs to study: M1805 (software developer), G1603 (fast-food crew member), J1501 (care assistant)… Up to 10 (3 with the developer's key). Find a code: France Travail's MétierScope, https://candidat.francetravail.fr/metierscope/.

## `departements` (type: `array`):

Department codes: 31, 75, 2A, 971… One profile per job and per area.

## `regions` (type: `array`):

Insee region codes: 11 (Île-de-France), 76 (Occitanie), 84 (Auvergne-Rhône-Alpes), 93 (Provence-Alpes-Côte d'Azur)…

## `france` (type: `boolean`):

Adds a profile for France as a whole, for each job.

## `compareFrance` (type: `boolean`):

Adds to each profile the national rate for the same quarter (return to work and each training course). A few more requests per job, at no extra cost.

## Actor input object example

```json
{
  "romeCodes": [
    "M1805"
  ],
  "departements": [
    "31"
  ],
  "france": false,
  "compareFrance": true
}
```

# Actor output Schema

## `results` (type: `string`):

Une fiche par métier et par territoire. Seules les fiches qui portent au moins une statistique publiable sont facturées (colonne « facturable »).

## `bilan` (type: `string`):

Compteurs de l'exécution : fiches enregistrées et facturées, codes ROME inconnus, valeurs masquées (secret statistique), consultations de France Travail, cause d'arrêt.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "romeCodes": [
        "M1805"
    ],
    "departements": [
        "31"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("geckostar/metiers-debouches-territoire").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "romeCodes": ["M1805"],
    "departements": ["31"],
}

# Run the Actor and wait for it to finish
run = client.actor("geckostar/metiers-debouches-territoire").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "romeCodes": [
    "M1805"
  ],
  "departements": [
    "31"
  ]
}' |
apify call geckostar/metiers-debouches-territoire --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,geckostar/metiers-debouches-territoire"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/yRkNXzRgJamoY7a89/builds/3ojc9xDWI1Hd0Xnfn/openapi.json