BLOG

【2026年版】求人ボックスのデータフィード仕様を解説|XMLの必須項目・作り方・運用の注意点

求人ボックスのリスティング広告では、求人情報を連携する方法として、クローリングとXMLフィードが用意されています。XMLフィードを利用すると、求人情報を求人ボックスの仕様に合わせて構造化し、連携できます。

本記事では、求人ボックスのXMLフィードについて、基本仕様から必須項目、作成方法、広告運用への活用方法まで解説します。

1. 求人ボックスとは?広告掲載の仕組みを解説

求人ボックスは、さまざまな求人サイトや企業の採用ページに掲載された求人情報を検索できる、求人検索サービスです。
求人ボックスには、次のような特徴があります。

  • 求人情報をまとめて検索できる求人検索サービス
  • 職種・勤務地・給与・雇用形態などから求人を探せる
  • 求人情報の掲載方法には複数の仕組みがある
  • 求人企業や求人サイトが広告を活用できる

求人ボックスのリスティング広告とは?

求人ボックスのリスティング広告は、求人ボックスの検索結果などに求人広告を掲載できるサービスです。公式の法人向け案内では、注力キーワード設定や注力ユーザー設定など、広告配信を調整する機能も紹介されています。

本記事では広告の概要にとどめます。料金体系や入札方式などは変更されることがあるため、最新の公式案内でご確認ください。

2. 求人ボックスのXMLフィードとは?クローリングとの違い

求人ボックスの公式ヘルプでは、リスティング広告に利用する求人情報の連携方法として、クローリングとXMLフィードの2種類が紹介されています。それぞれの違いを整理します。

項目クローリングXMLフィード
連携方法求人ページを自動取得XMLファイルを連携
導入準備比較的少ないXML作成・連携設定が必要
求人情報の調整取得内容を直接制御しにくい項目ごとに情報を調整できる
更新クローリングのタイミングに依存フィードの更新・取得設定に基づく
広告運用取得された求人情報を利用求人情報や分類項目を管理しやすい

クローリングが求人ページを自動で巡回して情報を取得する方式なのに対し、XMLフィードは、求人サイトや採用管理システム(ATS)に保存されている求人情報を、求人ボックスが指定するXML形式へ変換して連携する仕組みです。項目ごとに構造化したデータとして渡すため、求人情報を細かく制御できる点が大きな違いです。

基本的な流れは、次のとおりです。

職種名・企業名・仕事内容・勤務地などを項目ごとに構造化したデータとして渡し、求人ボックスは、この構造化された情報をもとに、求人を検索・分類・掲載します。

XMLフィードが向いているケース

XMLフィードは、次のような企業に向いています。

  • 求人掲載件数が多い
  • 求人情報の更新頻度が高い
  • 複数の求人媒体を利用している
  • 広告配信する求人を細かく管理したい
  • 求人情報を自社システムから自動生成したい

3. 求人ボックスのXMLフィードの基本仕様

求人ボックスのXMLフィードの基本仕様を解説します。
公式仕様書(ver.3.3)では、フィードの連携方法として2種類が用意されています。

項目自社サーバーへアップロード求人ボックス側サーバーへアップロード
ファイル形式XML / ZIP / gzipXML / ZIP / gzip
ファイル名任意の固定ファイル名任意の固定ファイル名
データ取得・更新回数1日最大2回1日最大4回
通信方式HTTPS / FTPFTP
接続制限IP制限またはBasic認証(任意)IP制限およびログイン認証(必須)
その他取得時間の指定が可能認証情報の定期更新が必要

特に押さえておきたいポイントが3つあります。

① 更新回数が連携方法によって異なる 自社サーバーに設置する場合は1日最大2回、求人ボックス側のサーバーへアップロードする場合は1日最大4回です。「求人ボックスは1日4回更新できる」と一律に理解すると誤りになります。更新頻度を重視する場合は、どちらの連携方法を選ぶかが関わってきます。

② XMLの構造が決められている 求人情報は<job>要素で管理します。決められた構造に沿って記述する必要があります(詳しくは次章)。

③ フィードを置くだけでは連携完了にならない フィードを設置したら即配信、ではありません。求人ボックス側によるフィードの確認・調整といった導入工程があります。

4. XMLフィード全体の構造と必須要素

まず、XMLファイル全体の構造です。公式仕様では、次の要素が必須とされています。

要素必須内容
XML宣言必須XMLのバージョン・文字コード
publisher必須サイト名
publisherUrl必須サイトURL
lastBuildDate必須フィード更新日時
job必須求人情報

このうち、publisher・publisherUrl・lastBuildDateは、フィード全体に関する情報(サイト名・サイトURL・更新日時)を表します。一方、jobは個々の求人情報を表す要素で、1つのXMLファイル内に複数のjob要素を記述できます。XMLの記述イメージは、次のとおりです。

<?xml version="1.0" encoding="utf-8"?>
<source>
  <publisher><![CDATA[サンプル採用サイト]]></publisher>
  <publisherUrl><![CDATA[https://example.com/]]></publisherUrl>
  <lastBuildDate><![CDATA[2026-10-30 10:00:00]]></lastBuildDate>
  <job>
    <url><![CDATA[https://example.com/jobs/12345]]></url>
    <title><![CDATA[Webマーケティング担当]]></title>
    <company><![CDATA[株式会社サンプル]]></company>
    <description><![CDATA[Web広告の運用・分析業務<br>経験者歓迎]]></description>
    <postDate><![CDATA[2026-10-01 00:00:00]]></postDate>
    <referenceNumber><![CDATA[12345]]></referenceNumber>
  </job>
</source>

※説明用の最小構成例です。実際の連携では、公式仕様や求人内容に応じて必要な情報を追加します。

<source>の中に、求人の数だけ<job>を並べる構造になります。求人が100件あれば、<job>が100個並ぶイメージです。

ここで、公式仕様書で定められている2つの重要なルールを押さえておきましょう。

  • 各要素の値は、すべて<![CDATA[ ]]>で囲む:上のサンプルのように、値をCDATAで囲んで記述します。これは、HTMLタグや特殊文字がXMLの解析を壊さないようにするためです。
  • <br>タグ以外のHTMLタグや、絵文字・制御文字は含めない:使えるのは<br>タグ(または改行コード)だけです。それ以外のHTMLタグを含めると、連携できない可能性があります。

5. 求人情報(job)の必須項目

求人ボックスのXMLフィードでは、求人ごとに必ず設定する項目が定められています。公式仕様書(ver.3.3)に基づき、主な必須項目を紹介します。

要素必須条件内容
url必須求人の遷移先URL
title必須求人タイトル・職種
company必須雇用主となる企業名
agency紹介案件の場合は必須人材紹介会社名
description必須仕事内容
postDate必須掲載開始日
referenceNumber必須求人固有のID

求人ボックスと併用されやすいスタンバイと比較すると、スタンバイでは、給与(salary)・雇用形態(jobtype)・勤務地(state/city)などが必須項目なのに対し、求人ボックスでは、これらは「任意項目」という扱いです。公式仕様書でも、salary・jobType・state・cityなどは任意項目(記載がなくても連携できる項目)に分類され、「広告効果を高めるためにも記載を推奨」とされています。

ただし、「任意だから重要ではない」という意味ではありません。勤務地・給与・雇用形態は、求職者が仕事を探す際の重要な情報であり、公式も記載を推奨しています。必須ではなくても、可能な限り正確に連携することをおすすめします。本記事では、この「記載が推奨される任意項目」を、以降わかりやすく「推奨項目」と呼びます。

なお、求人ボックス側の審査・掲載要件は、XMLの必須項目とは別に存在する可能性があります。「XMLとして必須の項目」と「掲載が認められるための要件」は、混同しないようにしましょう。

6. 求人ボックスで重要な推奨項目・任意項目

必須項目以外も整理します。求人ボックスでは、次のような推奨項目があります。

要素区分内容
jobType推奨雇用形態
salary推奨給与
state推奨都道府県
city推奨市区町村
station推奨最寄り駅
address推奨勤務先住所
experience推奨応募資格
workingHours推奨勤務時間
benefits推奨待遇・福利厚生
insurance推奨加入保険
preventSmoke推奨受動喫煙防止措置
trialPeriod推奨試用期間
contractPeriod推奨契約期間

これらの項目を適切に設定することで、求人情報をより詳細かつ正確に伝えられます。特に勤務地・給与・雇用形態などは、求職者が求人を比較する際に重要な情報です。

descriptionなど長文項目の改行対応

一点、長文項目で注意したいことがあります。求人ボックスでは、<br>タグまたは改行コードを利用した、可読性への配慮が求められています。公式仕様書では、改行対応がない場合、フィード連携できない可能性があると注意されています。

特にdescription(仕事内容)のような長文項目では、改行なしで文章を詰め込むと、読みにくいだけでなく連携自体に影響することがあります。適切に改行を入れることが大切です。

7. 必須項目を設定する際の注意点

必須項目における注意点を整理します。

① url:求人ページのURL 求人ごとに適切なURLを指定します。同一URLの重複に注意が必要です。公式仕様では、同一URL(パラメータを含む)の求人が複数ある場合、フィード内で最初に記述された<job>の情報のみが連携される、とされています。また、リダイレクトURLの利用には制限があります。

② title:求人タイトル 具体的な職種名を記載します。過度な装飾や誇張表現を避け、求人内容と一致させることが基本です。なお公式仕様では、titleに用いる記号は「」・/ を主に推奨しており、括弧内の文字列などは求人ボックス側の独自整形によって削除される可能性がある、とされています。記号の使い方にも注意しましょう。

③ company:雇用主の企業名 companyは必須項目です。人材紹介会社名ではなく、雇用主となる企業名を指定します。紹介案件の場合は、企業名をcompanyに、人材紹介会社名を別途agencyに記載します。
なお公式仕様では、例外として、非公開案件の場合に限り「非公開」と記載するか、空欄とすることが認められています。これはあくまで非公開案件に限った例外的な扱いであり、通常は雇用主となる企業名を必ず記載します。

④ referenceNumber:求人固有ID 求人ごとに一意のIDを設定します。重要なのは、更新のたびにIDを変更しないことです。元データとの対応関係を管理し、同じ求人には常に同じreferenceNumberを使います。

⑤ postDate:掲載開始日 掲載開始日を指定します。これは、フィード全体の更新日時を示すlastBuildDateとは意味が異なります。postDateは「その求人がいつ掲載開始されたか」、lastBuildDateは「フィードをいつ更新したか」となります。

8. categoryを使った求人のグループ分けと広告運用

求人ボックスのデータフィードならではの活用ポイントを紹介します。

公式仕様では、categoryがキャンペーン設定時の絞り込み用項目として用意されています。たとえば、次のように記述します。

<category><![CDATA[営業職,東京都,正社員]]></category>

このように、カンマ区切りで複数の分類情報を設定できます。注意点として、公式仕様では記号を使用しないよう指定されているため、区切りのカンマを除くラベル値には記号を含めないようにします。

活用例

categoryは、広告運用で次のような分類に使えます。

  • 職種別:営業職、エンジニア、事務職
  • 勤務地別:東京都、大阪府、福岡県
  • 雇用形態別:正社員、アルバイト、派遣
  • 採用優先度別:重点募集、通常募集

ここで理解しておきたいのは、categoryが単なる求人分類ではなく、広告キャンペーンの対象求人を管理するための属性だという点です。たとえば「重点募集」のcategoryを付けた求人だけを対象にキャンペーンを組む、といった運用ができます。データフィードの設計が、そのまま広告運用のしやすさにつながるわけです。

ただし、分類を設定すれば自動的に広告成果が改善する、という意味ではありません。あくまで、運用を管理しやすくするための仕組みです。

9. 画像・動画・応募URLのフィード仕様

求人ボックスでは、求人の情報だけでなく、画像・動画・応募導線もフィードで管理できます。

画像URL:imageUrls

公式仕様では、画像URLをカンマ区切りで最大6件(1求人6枚)まで記載できます。主な要件は次のとおりです。

  • 形式:JPG・PNG・静的GIF・HEIC
  • 容量:8MBまで
  • 解像度:「横200px以上かつ縦20px以上」または「横100px以上かつ縦230px以上」のどちらかを満たすこと
  • 推奨サイズ:横750px以上×縦464px以上(縦横比1:1.618)
  • 画像URLはリダイレクトのないURLを使う
  • 求人ページに実際に表示されている画像を使う

注意点として、画像を変更した場合は画像URLも変更する必要があります。URLが同じままだと、画像が更新されない可能性があります。

動画URL:movieUrls

2026年7月版の仕様では、動画の埋め込みURLを登録できます。ただし、対応しているのはYouTubeの埋め込み形式のURLで、パラメータのないものに限られます。登録できるのは、現時点では1件のみです。通常の動画視聴ページのURLとは形式が異なるため、注意が必要です。

応募URL:applyUrl

applyUrlは、応募ページへ直接遷移させるためのURLです。公式仕様では、applyUrlを指定すると、求人詳細ページ(ジョブビュー)からの遷移先が、応募URLを基準としたURL(トラッキングパラメータ付き)になります。applyUrlを指定しない場合は、url(遷移先URL)に遷移します。

一点、タイミングの注意があります。公式仕様では、フィードの更新から求人ボックスへの反映までに数時間程度かかるため、applyUrlを記載する場合は、フィードの内容がジョブビューに反映されていない状態で応募が発生する可能性がある、とされています。応募導線を変更する際は、この反映タイムラグを念頭に置く必要があります。

求人の情報だけでなく、応募までの導線もフィードで管理できる点もXMLフィードを使うメリットの一つです。

10. 派遣求人向けの専用項目

2026年7月版の仕様には、派遣求人向けの項目も用意されています。

要素内容
workplaceName派遣先の勤務先名
workplaceNameAlt勤務先名の代替表記
workplaceDepartment配属先部署
workplaceSummary勤務先概要
staffingNumber派遣会社の許可番号
staffingOffice派遣会社の拠点・事業所
staffingDescription派遣会社の説明・PR
staffingEmployeeCount派遣会社の従業員数
staffingRegistration登録に関する案内

これらは、jobTypeに「派遣」を含む求人でのみ取り込み・表示される項目とされています。

ここで重要なのが、「派遣求人」の判定ルールです。公式仕様では、「派遣求人」とは雇用形態(jobType)に「派遣」が含まれる求人を指す、とされています。複数の雇用形態が設定されている場合でも、いずれかに「派遣」が含まれていれば派遣求人として扱われます。

つまり、上記の派遣求人向け項目を取り込んでもらうには、jobTypeに「派遣」という文字列を含めることが前提です。公式では、無期雇用派遣の求人の場合も、jobTypeに「派遣」を含めるよう案内されています(含まれていないと、これらの派遣向け項目は取り込まれません)。派遣求人を扱う場合は、まずjobTypeの記載を確認したうえで、専用項目を設定しましょう。

11. 求人ボックスのXMLフィードを作成・連携する手順

公式仕様書の導入フローに沿って、連携までの流れを整理します。

STEP1:求人ボックスの有料掲載サービスへ申し込む まず、リスティング広告の利用申込みを行います。

STEP2:XMLフィードを作成する 公式仕様に合わせて、求人データを作成します。

STEP3:求人ボックスの担当者へフィード情報を連絡する データフィードの設置場所や、連携に必要な情報を共有します。

STEP4:フィードの確認・調整 求人ボックス側でデータフィードを確認し、必要に応じて調整します。

STEP5:接続設定を行う 連携方法に応じて、接続情報などを共有します。

STEP6:連携開始 取り込みが正常に行われているかを確認します。

このように、求人ボックスのXMLフィードは「作って終わり」ではなく、申込みから確認・調整を経て連携開始に至る、6段階の工程があります。

12. XMLフィード運用でよくあるエラーと注意点

フィードに含めてはいけない求人

公式仕様書でフィードに含めないよう定められている求人があります。該当する求人を含めると、事前通知なく広告掲載が停止される可能性があるため、注意が必要です。

  • 掲載ガイドラインに違反した求人
  • 他の求人サイトの求人
  • 遷移先URL(url)で指定したページの閲覧に、ユーザーのログインが必要な求人
  • 掲載の期間切れや、募集が終了している求人
  • 求人ページに存在しない内容が入稿されている求人
  • テスト求人や存在しない求人、詐欺などの不適切な内容を含む求人
  • 応募可能なランディングページが用意されていない求人

運用チェックリスト

次に、データフィードの入稿・運用時に確認したいポイントを、チェックリストにまとめます。

チェック項目確認内容
XML構造タグの閉じ忘れや構造エラーがないか
必須項目必須要素が欠損していないか
求人IDreferenceNumberが求人ごとに一意か
求人URLURLが有効で、正しい求人ページへ遷移するか
仕事内容改行が適切に入っているか
求人情報給与・勤務地・雇用形態などが最新か
求人の終了募集終了した求人が残っていないか
画像URLが有効で、変更時にURLも更新されているか
動画YouTubeの埋め込み形式になっているか
category分類値が適切で、記号のルールに違反していないか
更新頻度連携方法に応じた回数を守っているか

構造が正しくても情報が古ければ求職者の体験を損ないますし、情報が正確でもXMLが壊れていれば連携できません。大切なのは、XMLとして正しいことと、求人内容が正確であることの両方が必要だという点です。

13. スタンバイ・Indeedと求人ボックスのフィード仕様は同じ?

複数の求人媒体を扱う場合に気になるのが、媒体間の仕様の違いです。結論から言うと、求人データの基本項目は似ていても、媒体ごとに仕様は異なります。

求人ボックスとスタンバイを比べると、違いが分かりやすくなります。なお、下表の「推奨/必須」は、あくまで各媒体のXMLフィード仕様上の項目区分を指しており、広告の審査・掲載が認められるための要件とは別の観点となるため注意してください。

比較項目求人ボックススタンバイ
データ形式XMLXML
求人IDreferenceNumberreferencenumber
職種名titletitle
企業名companycompany
給与salary(推奨)salary(必須)
雇用形態jobType(推奨)jobtype(必須)
求人分類category媒体独自の項目・ルール

※スタンバイ側の要件は、掲載方式・最新仕様に応じて再確認してください。

注目すべきは、同じ「給与」「雇用形態」でも、求人ボックスでは推奨、スタンバイでは必須という違いです。さらに、求人IDのタグ名も「referenceNumber」と「referencenumber」で大文字・小文字が異なります。同じ求人データを使う場合でも、タグ名や必須条件が異なるため、そのまま流用せずそれぞれ独自で作成を行った方が良いでしょう。

14. 複数の求人媒体を運用するならフィードの自動生成・変換が重要

求人ボックス・スタンバイ・Indeedなど、複数の求人媒体を利用する場合、媒体ごとにXMLを手作業で作成・更新するのは大きな負担です。

そこで、理想的なのは、次の構成です。

たとえば、元データの「雇用形態」を、媒体ごとのタグ名(jobType / jobtype)や指定形式へ変換します。求人ボックスなら推奨項目として、スタンバイなら必須項目として、それぞれの仕様に合わせて整えます。また、求人が募集終了になった場合には、元データの更新を各媒体へ反映させます。

こうした変換・更新を自動化すれば、求人件数が多い場合でも、媒体ごとに情報を更新する負担を減らせます。

まとめ

求人ボックスのXMLフィードについて、要点を3つに整理します。

① 求人ボックスのXMLフィードはリスティング広告向けの連携方式 クローリングとは異なり、求人情報を項目ごとに構造化して連携できます。オーガニック枠への直接利用はできない点も押さえておきましょう。

② 必須項目だけでなく、推奨項目や独自項目の理解が重要 必須はurl・title・company・description・postDate・referenceNumberが基本で、給与・雇用形態・勤務地は推奨項目です。さらにcategory、imageUrls、movieUrls、派遣求人向け項目など、求人ボックス独自の仕様があります。

③ 複数媒体を運用する場合はフィードの自動生成・更新が重要 求人情報を一元管理し、媒体ごとの仕様へ変換することで、継続的な運用を効率化できます。

特に、categoryを使ったキャンペーンの絞り込みや、動画・派遣求人向けの最新属性は、求人ボックスならではの活用ポイントです。媒体ごとの仕様を正しく押さえ、正確な求人データを継続的に届けることが、求人広告運用の土台になります。

※本記事は求人ボックスのXMLフィード仕様書(ver.3.3/2026年7月版)および公式ヘルプをもとに作成しています。求人ボックスのフィード仕様、必須・推奨項目、連携方法、各種要件は変更される場合があります。実際の連携・運用にあたっては、求人ボックスの公式仕様書・ヘルプで最新情報を必ずご確認ください。


メディアストリーム株式会社が提供する「FEED STREAM」は、月額1万円からはじめられるデータフィードサービスです。
今回ご紹介した求人ボックスのデータフィード作成も簡単な操作で実現できます。

専任スタッフが個別の相談やデータフィードの診断も無料で対応いたしますので、お気軽にお問い合わせください!

記事をシェアする:

FEED STREAMで、データフィードのあらゆる悩みを解決しましょう。

すぐ導入の予定がない、まずお悩みを相談したい等の場合も、お気軽にお問い合わせください。