【ITニュース解説】Federal jobs closing this week: a Monday CSV from the USAJOBS API (sorted by close date, in Eastern time)
2026年11月02日に「Dev.to」が公開したITニュース「Federal jobs closing this week: a Monday CSV from the USAJOBS API (sorted by close date, in Eastern time)」について初心者にもわかりやすく解説しています。
ITニュース概要
USAJOBS APIをPythonで活用し、今週締め切られる連邦政府の求人情報を効率的に取得し、CSVリストを作成する方法を解説する。締め切り日時の正確な処理やAPIキー設定も詳述。システムエンジニアを目指す初心者が、API連携の基本と実用的なデータ取得スクリプトを学ぶのに役立つ。
ITニュース解説
この記事は、アメリカ連邦政府の求人情報サイト「USAJOBS」で公開されている求人の中から、特定の条件に合致し、特に締め切りが近いものを自動的に抽出し、CSV形式のファイルとして生成する方法を解説する。システムエンジニアを目指す初心者にとって、プログラミングがどのように現実世界の課題解決に役立つかを示す具体的な例となるだろう。
多くのキャリアカウンセラーや求職者が抱える共通の課題は、「今週中に応募できる求人は何があるか」という問いだ。USAJOBSのウェブサイトで一つずつ検索するのは手間がかかる。しかし、API(Application Programming Interface)を利用すれば、一度の処理でこの情報を効率的に取得できる。APIとは、異なるソフトウェア同士がデータのやり取りを行うための窓口や規約のことで、これを使うとウェブサイトを人間が操作する代わりに、プログラムが直接データと対話できる。
この方法を実践するには、Python 3.9以降のバージョン、ウェブ上のデータにアクセスするためのrequestsライブラリ、そしてUSAJOBSの公式サイトで取得できる無料のAPIキーが必要となる。まずはセキュリティ確保のため、APIキーと登録したメールアドレスを直接プログラムに書き込むのではなく、環境変数として設定することが推奨される。これは、これらの機密情報をプログラムのコードとは別に管理し、安全性を高める一般的な手法だ。USAJOBSのAPIは、リクエストの際に、メールアドレスをUser-Agentヘッダーに、APIキーをAuthorization-Keyヘッダーに含めることを要求する。
次に、APIから求人情報を取得する際の重要な考慮点がある。USAJOBSのAPIのデフォルトのソート順は締め切り日ではないため、そのままでは締め切りが近い求人を効率的に見つけられない。そこで、SortField=closedateとSortDirection=Ascというパラメータを指定して、締め切り日が早い順にデータを並べ替える必要がある。これにより、プログラムは締め切りウィンドウ(例えば7日以内)を超えた最初の求人を見つけたら、それ以降のデータ取得を停止でき、無駄な処理を省ける。
さらに、求人の締め切り時刻にはタイムゾーンの問題が関わる。USAJOBSの求人情報はApplicationCloseDateにタイムゾーン情報を含んでいないが、すべての求人は東部時間(Eastern Time, ET)の午後11時59分に締め切られるという規則がある。そのため、スクリプトが動作するサーバーのタイムゾーンに関わらず、東部時間を基準として締め切り時刻を正確に解釈する必要がある。Pythonのdatetimeモジュールとzoneinfoモジュールを組み合わせることで、このタイムゾーンの課題を適切に処理し、例えば月曜日の早朝にスクリプトを実行した場合でも、その日の夜に締め切られる求人を正しく把握できる。
実際のプログラムの処理は、まず現在時刻と指定した日数(例:7日)後の締め切り時刻の境界を設定する。そして、定義された職種コードのリスト(例:連邦政府で一般的な0343の管理・プログラム分析、0201の人事管理)ごとにAPIへのリクエストを繰り返す。APIは一度に取得できる結果件数に上限があるため、Pageパラメータを増やしながら複数ページにわたってデータを取得する「ページング」という手法を用いる。取得した各求人について、まず締め切り時刻を東部時間で正確に計算し、すでに締め切られているものや、設定した期間外のものは除外する。締め切りが期間内の求人は、そのIDをキーとして辞書に保存する。ここで注意すべきは、一つの求人が複数の職種コードを持つ場合があるため、重複して登録されないように処理する点だ。
抽出された求人情報からは、締め切り日、残り日数、職種コード、職務タイトル、機関名、グレード、給与範囲、勤務地、URLなどの詳細が取得される。特に給与情報は、年俸(PA)や時給(PH)など、支払い間隔を示すコードが異なる場合があるため、比較する際にはそのコードを確認する必要がある。また、連邦政府のグレードシステムにはGS(General Schedule)以外のものもあり、その場合はグレードがSL-00/00のように表示されることがあるため、給与範囲で判断する必要がある。
これらの情報を全て集め、ソート(並び替え)した上で、最終的に「closing_this_week.csv」という名前のCSVファイルとして出力する。このCSVファイルには、締め切り日、残り日数、職種コード、職務タイトルなどが列挙される。スクリプトが正常に動作すれば、「211 public jobs close by Mon 09 Nov (ET)」といった形式で、期間内に締め切られる求人の総数と、各日に締め切られる求人の内訳がコンソールに表示される。
このスクリプトは柔軟にカスタマイズできる。例えば、対象とする職種コードのリスト(SERIES)や、何日先までの求人を対象とするか(DAYS)を変更できる。また、デフォルトでは一般公開されている求人のみを対象としているが、現在連邦政府に勤務している職員向けの求人も含めたい場合は、"WhoMayApply": "Public"というフィルタを削除すればよい。
このスクリプトは一度実行するだけでなく、自動的に毎週実行するように設定できる。Linuxなどのシステムではcronという機能を使って、毎週月曜日の特定の時刻にスクリプトを自動実行することが可能だ。このように自動化することで、常に最新の締め切り間近の求人リストを手に入れることができる。ただし、求人の中には、設定された締め切り日よりも早く募集が終了したり、応募者数の上限に達した時点で締め切られたりするものもあるため、求職者には応募前に必ず元のURLを確認するよう促す必要がある。
さらに、USAJOBSの「Public」というフィルターは、実際には退役軍人や軍人の配偶者など、特定のグループにのみ開かれた求人も含む場合があるため、求人の詳細にある「Hiring Paths(採用経路)」を確認することが重要だ。また、数ヶ月間開かれている長期の募集は、締め切りが近づいた時だけこのリストに表示されるため、常に開かれている求人を探したい場合は、別の方法で取得する必要がある。
もし自分でスクリプトを維持管理する手間を省きたい場合は、Apify Actorという外部サービスを利用する選択肢もある。これは、USAJOBS APIのデータ抽出をサービスとして提供しており、特定の職種コードや締め切りまでの日数などを入力するだけで、同じように求人情報を取得できる。このサービスは、実行ごとに料金が発生するが、自分でプログラムを書く知識やメンテナンスの労力が不要となるため、手軽に利用できるメリットがある。
このように、APIとプログラミングスキルを組み合わせることで、大量の公開データの中から必要な情報を効率的に抽出し、自動化されたシステムを構築できる。システムエンジニアを目指す上で、このようなデータの取得・加工・活用は非常に重要なスキルであり、この記事は、その第一歩として具体的な問題解決のプロセスを示していると言える。