Description de l'API USAJobs

L’API USAJobs permet d’interroger la base officielle des offres d’emploi du gouvernement fédéral des États-Unis. Elle fournit des informations complètes sur les postes à pourvoir, y compris la localisation, le salaire, les qualifications, les dates de publication et de clôture. L'API est RESTful, gratuite et nécessite une clé d’API pour fonctionner.

Qu'est-ce que l'API USAJobs ?

USAJobs est la plateforme officielle de recrutement de la fonction publique américaine. Son API permet aux développeurs d’intégrer ces offres dans leurs propres applications, sites web ou tableaux de bord RH. L’API est particulièrement utile pour les entreprises, les écoles ou les agrégateurs d’offres d’emploi ciblant les opportunités dans le secteur public américain.

Caractéristiques de l'API USAJobs

• Source officielle : Accès direct aux offres gouvernementales fédérales.
• Données détaillées : Titre du poste, salaires, agences, date limite, description, etc.
• Recherche filtrée : Par mot-clé, lieu, agence, catégorie, série, grade, et plus.
• Pagination et tri : Résultats paginés et triables (par pertinence, date, etc.).
• Documentation complète : Guides, endpoints, modèles JSON disponibles sur developer.usajobs.gov.

Comment intégrer l'API USAJobs : Exemple d'implémentation

Voici un exemple en JavaScript (Node.js avec axios) pour rechercher les offres de “software engineer” à Washington, DC via l’API USAJobs :

const axios = require('axios');

async function getUsaJobs() {
    try {
        const response = await axios.get('https://data.usajobs.gov/api/search', {
            headers: {
                'Host': 'data.usajobs.gov',
                'User-Agent': 'monapp@example.com',
                'Authorization-Key': 'VOTRE_CLE_API'
            },
            params: {
                Keyword: 'software engineer',
                LocationName: 'Washington, DC'
            }
        });

        console.log(response.data.SearchResult.SearchResultItems);
    } catch (error) {
        console.error('Erreur USAJobs API:', error);
    }
}
                

import requests

headers = {
    'Host': 'data.usajobs.gov',
    'User-Agent': 'monapp@example.com',
    'Authorization-Key': 'VOTRE_CLE_API'
}

params = {
    'Keyword': 'software engineer',
    'LocationName': 'Washington, DC'
}

response = requests.get('https://data.usajobs.gov/api/search', headers=headers, params=params)

if response.status_code == 200:
    data = response.json()
    for job in data['SearchResult']['SearchResultItems']:
        print(job['MatchedObjectDescriptor']['PositionTitle'])
else:
    print("Erreur:", response.status_code)
                

-- php --
$url = 'https://data.usajobs.gov/api/search';
$headers = [
    "Host: data.usajobs.gov",
    "User-Agent: monapp@example.com",
    "Authorization-Key: VOTRE_CLE_API"
];
$params = http_build_query([
    'Keyword' => 'software engineer',
    'LocationName' => 'Washington, DC'
]);

$context = stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => implode("\r\n", $headers)
    ]
]);

$response = file_get_contents($url . '?' . $params, false, $context);
$data = json_decode($response, true);

foreach ($data['SearchResult']['SearchResultItems'] as $job) {
    echo $job['MatchedObjectDescriptor']['PositionTitle'] . "<br>";
}
?>
                

Idées d'utilisation de l'API USAJobs

• Application de carrière pour étudiants : Affichez les opportunités fédérales pour les jeunes diplômés.
• Site RH bilingue : Intégrez les offres USAJobs pour des profils franco-américains.
• Tableau de bord gouvernemental : Analysez les tendances de recrutement par agence ou métier.
• Moteur de recherche d’emploi personnalisé : Combinez plusieurs APIs dont USAJobs pour plus de portée.