XML フィードリファレンス
XML フィードのノード、要素、例です。
Indeed の API の使用について Indeed と書面による契約を締結していない場合、この API またはそのドキュメントを使用することにより、Indeed の API の使用には Indeed API Terms および Additional API Terms and Guidelines が適用されることに同意したものとみなされます。
Indeed は XML フィードで HTML entities をサポートしていません。HTML entities(< など)ではなく、リテラル文字(< など)を使用してください。HTML entities を使用すると、Indeed がコンテンツを拒否したり、正しく書式設定できなかったりする場合があります。
開始する前に、応募者追跡システム(ATS)連携の Indeed + Your ATS をご覧ください。
Indeed の XML フィードには、Indeed に表示される求人情報が含まれます。XML フィードを維持することで、Indeed での求人の表示方法を管理できます。また、求人に Indeed エントリーのラベルを追加することもできます。
顧客がシステムで求人を作成すると、XML フィードがそれらの求人情報を直接 Indeed に送信します。
XML フィード
求人を定義する XML ドキュメントを作成し、維持します。Indeed は、次のいずれかの方法でファイルの変更を監視します。
- XML URL のクロール
- クライアントがホストする FTP サイトのクロール(SFTP もサポートされています)
- Indeed の FTP サーバーでのファイルの直接受信(zip ファイルを推奨します)
キャリ アページのすべての求人を XML フィードに含めます。Indeed は不完全な XML フィードを受け付けず、一部の求人のみのオプトインはサポートしていません。XML ファイルにすべての求人が含まれていない場合、Indeed はそれを拒否するか、求職者への表示を制限することがあります。
自社のウェブサイトで求職者が確認できるすべての情報を XML に含めます。たとえば、求人情報に給与が表示されている場合は、<salary> などのデータ要素を含めます。給与情報が自社のウェブサイトに表示されていない場合は、インデックス作成のために含める必要はありません。
基本的なフィードノード
基本的なフィードノードは、XML バージョンやエンコーディング、ATS 情報(ATS 開発者向け)など、XML フィードの一般的な詳細を定義します。
Indeed からフィードの修正を依頼された場合は、その修正を行ってください。修正しない場合、Indeed はフィード読み込みリクエストを拒否したり、すでに有効なフィードの読み込みを停止したりすることがあります。
| 要素 | 説明 |
|---|---|
必須 XML 宣言。 例: | |
必須 XML フィードドキュメントのルートノード。 | |
ATS 開発者のみ この求人を公開した ATS の名称。 例: | |
ATS 開発者のみ この求人を公開した ATS の URL。 例: | |
必須 求人固有のメタデータ。 Indeed に表示する求人ごとに |
求人フィードのエレメント
求人フィードのエレメントは、ノードの求人固有のメタデータを定義します。
| エレメント | 説明 |
|---|---|
必須(日本を除く) 求人のタイトル。給与、雇用形態、勤務地、説明、キャッチコピーは含めないでください。 誤解を招くコンテンツとアクティビティもご覧ください。 例: <![CDATA[Sales Executive]]> | |
必須 この求人が最初に公開された日付。ISO-8601形式を使用します。 サイトに公開日を表示する場合は、XMLの日付と一致させる必要があります。 例: <![CDATA[2014-12-19T22:49:39Z]]> | |
必須 この求人インスタンスの一意のID。 複数の勤務地に掲載する求人は、勤務地ごとに一意の値を設定してください。設定後は変更しないでください。 例: <![CDATA[unique123131]]> | |
必須 求人のリクイジションID(旧称external job ID)。 貴社のシステムでは、この値を使って元の職務と応募者を追跡している場合があります。 貴社の公開キャリアページに表示される場合があります。 同じ求人の場合、フィードや勤務地が異なっても同じ値にしてください。一意である必要はありません。 例: <![CDATA[ab1212]]> | |
求人ID。
Candidate Sync などの Indeed の連携機能が、応募者情報を貴社のシステムに送信するために使用します。 例: <![CDATA[ab1212]]> | |
必須 貴社サイト上のこの求人掲載の URL。 応募ページではなく、仕事内容ページのURLを使用します。 Indeedからのクリックを追跡するため、 例: | |
必須 この職務の採用を行う親組織。 複数の勤務地で運営する子会社やフランチャイズの場合は、すべての求人に同じ 例: <![CDATA[[ABC Hospital]]> | |
ATS開発者のみ 必須 この職務の採用を行う親組織。 複数の勤務地で運営する子会社やフランチャイズの場合は、すべての求人に同じ 例: <![CDATA[ABC Medical Group]]> | |
必須 求人の勤務地の市区町村及び町域まで。 例: <![CDATA[Phoenix]]> | |
必須 この求人の勤務地の州または地域。 郵便上の略称を使用します。米国外の場合は、対応する州、県、または地域を使用してください。 例: <![CDATA[AZ]]> | |
必須 この求人の勤務地の国。 例: <![CDATA[US]]> | |
キャリアサイトに掲載する場合は必須 この求人の勤務地の郵便番号。 例: <![CDATA[85003]]> | |
キャリアサイトに掲載する場合は必須 求人の主要な勤務地の住所。 番地を含めて記載します。 Indeed はこの情報を、所在地ベースの検索と表示に使用します。 例:
| |
必須 このクライアントの Indeed アカウントに紐付くメールアドレス。 Indeed の検索品質チームが、求人を掲載する事業者を確認するために使用します。 例: | |
必須 Indeed上で求職者に表示される仕事内 容。学歴や経験の詳細も含め、 Indeedは、Indeedの文脈に合わないボタンやリンクテキストをフィルタリングする場合があります。 HTML フォーマットを含めてください。対応するエレメントについては、フォーマットのガイドラインを参照してください。 例: | |
キャリアサイトに掲載する場合は必須 この求人で提示される給与。 ベストプラクティスについては、求人情報での給与情報の表示方法を参照してください。 求人に給与がない場合は、その求人のXMLでこのフィールドを空欄のままにしてください。 Indeed は、 このXMLフィールドの給与やその他の報酬データが正しい数値形式で入力されていない場合、Indeedはそのデータを表示しないことがあります。最良で予測可能な結果を得るには、ベストプラクティスに従ってこのXMLフィールドに給与情報を指定してください。 例: <![CDATA[$50000 per year]]><![CDATA[$4000 - $5000 per month]]><![CDATA[年収500万円]]><![CDATA[月給40万円~50万円]]> | |
キャリアサイトに掲載する場合は必須 この求人で求められる学歴。 例: <![CDATA[Bachelors]] | |
キャリアサイトに掲載する場合は必須 雇用形態(フルタイムまたはパートタイム)。 Indeedは、この情報を提供された他の求人コンテンツから直接抽出することもあります。 例: <![CDATA[fulltime, parttime]] | |
求職者の検索に役立つ求人カテゴリーをカンマ区切りで指定したリスト。 求人管理、カテゴリーに基づくクライアントによるスポンサー化、求人詳細ページからの追加情報の反映に役立てるため、Indeedはこのフィールドの指定を強く推奨します。 たとえば、施設や部門の情報をこのフィールドに含めると便利です。 例: <![CDATA[Category1, Category2, CategoryN]]> | |
キャリアサイトに掲載する場合は必須 この求人で求められる経験。 例: <![CDATA[5+ years]]> | |
キャリアサイトに掲載する場合は必須 この職務の積極的な採用活動が終了する日付。 この日付以降、Indeed は求人を検索結果から削除することがあります。デフォルトでは、この日付は CST タイムゾーンとして解釈されます。 例: <![CDATA[2021-11-08]]> | |
注:この機能は日本では利用できません。 求人ごとに一意の URL。Indeed はこの求人のクリックを追跡するために使用します。求人がクリックされるたびに、Indeed はこの URL に 例: | |
リモートワークの種類。有効な値は次のとおりです。
Indeed はこのエレメントを勤務地の判定に使用しません。 求人に含められるテキストとリモート求人の掲載方法の詳細については、XML フィードの FAQをご覧ください。 例: <![CDATA[COVID-19]]> | |
この求人に対して貴社のシステムが行った操作の最新タイムスタンプ。 操作には、応募者のレビューや求人の更新などが含まれます。 例: <![CDATA[2014-12-19T22:49:39Z]]> | |
クライアントが社内で自社の事業単位を識別するために使用する ID。 例: abc123 | |
求人投稿を Indeed 検索に表示するかどうかを制御します。次の理由コードのいずれかを指定します。
例: <![CDATA[OPT_OUT]]> |
XML フィードの例
次の XML フィードの例では、求人を 1 件定義しています。
<?xml version="1.0" encoding="utf-8"?><source> <!--publisher is applicable to ATS developers only--> <publisher>ATS Name</publisher> <!--publisherurl is applicable to ATS developers only--> <publisherurl>http://www.atssite.com</publisherurl> <job> <title> <![CDATA[Sales Executive]]> </title> <date> <![CDATA[2021-06-29T22:49:39Z]]> </date> <referencenumber> <![CDATA[unique123131]]> </referencenumber> <requisitionid> <![CDATA[ab1212]]> </requisitionid> <url> <![CDATA[http://www.examplesite.com/viewjob.cfm?jobid=unique123131&source=Indeed]]> </url> <company> <![CDATA[ABC Hospital]]> </company> <sourcename> <![CDATA[ABC Medical Group]]> </sourcename> <city> <![CDATA[Phoenix]]> </city> <state> <![CDATA[AZ]]> </state> <country> <![CDATA[US]]> </country> <postalcode> <![CDATA[85003]]> </postalcode> <streetaddress> <![CDATA[123 fake street Phoenix AZ, 85003]]> </streetaddress> <email> <![CDATA[example@abccorp.com]]> </email> <description> <![CDATA[Do you have 1-3 years of sales experience? Are you relentless at closing the deal? Are you ready for an exciting and high-speed career in sales? If so, we want to hear from you! [...] We provide competitive compensation, including stock options and a full benefit plan. As a fast-growing business, we offer excellent opportunities for exciting and challenging work. As our company continues to grow, you can expect unlimited career advancement! ]]> </description> <salary> <![CDATA[$50000 per year]]> </salary> <education> <![CDATA[Bachelors]]> </education> <jobtype> <![CDATA[fulltime, parttime]]> </jobtype> <category> <![CDATA[Category1, Category2, CategoryN]]> </category> <experience> <![CDATA[5+ years]]> </experience> <expirationdate> <![CDATA[2021-11-08]]> </expirationdate> <remotetype> <![CDATA[Fully remote]]> </remotetype> <indeed-apply-data>COVERED IN A LATER SECTION</indeed-apply-data> </job></source>この XML フィードは、次のような Indeed の求人を表示します。

書式設定ガイドライン
XML フィードで求人詳細を定義する場合は、CDATA タグ内に HTML 書式を含めてください。Indeed は、Web サイトで使用しているものと同じ HTML 書式を CDATA タグ内で使用することを想定しています。
Indeed は HTML 標準への厳密な準拠よりも、HTML コンテンツを標準化された形式に正規化して求職者に表示することを優先しています。
Indeed は XML フィードで HTML entities をサポートしていません。HTML entities(< など)ではなく、リテラル文字(< など)を使用してください。HTML entities を使用すると、Indeed がコンテンツを拒否したり、正しく書式設定できなかったりする場合があります。
| タグ | 説明 |
|---|---|
<b> | 太字テキスト。 |
| ヘッダー。 ヘッダータグ内のテキストは、Indeed上で一定のサイズで表示されます。 |
<br> | 単一改行。 |
<p> | 段落。Indeedは段落タグ間に自動的に空白行を挿入します。 |
<ul> | 順序なしリスト(箇条書き)。 |
<li> | リストアイテム。 |
<strong> | 強調(太字)テキスト。 |
<em> | 強調(斜体)テキスト。 |
| シンプルなテーブル。 |
| ノード | 説明 |
|---|---|
| 太字テキスト。 |
| インラインテキスト。 デフォルトでは、 |
<p>タグの上下のマージンとパディングはデフォルトで正の値に設定されています。これを上書きしないでください。
新規要素の設定について
日本のみ。既存の要素に加えて、これらの新規要素を設定できます(任意)。
- キーワードと画像 URL は、カンマ区切りの複数値として指定できます。
- Indeed はこれらの新規要素をテストしながら段階的に展開しているため、指定したすべての要素が表示されることを保証しません。詳細については、担当の Alliance Manager にお問い合わせください。
- 既存要素または新規要素を追加または変更する場合は、Indeed 側で対応する設定を追加するよう依頼してください。変更を行うたびに Indeed に通知してください。
その他の注意事項
日本のみ。- フィードは 1 日に 1 回以上更新してください。
- XML フィードの内容と求人詳細ページの内容が完全に一致するようにしてください。
- テスト求人、求人サイトの求人、ショッピングモール求人を含めないでください。
書式ガイドライン(日本)
日本のみ。XML フィードで求人の説明 を定義するには、CDATA タグの中に HTML 書式を含めてください。CDATA タグ内では、ウェブサイトで使用しているものと同じ HTML 書式を使用してください。
Indeed は HTML コンテンツを正規化し、HTML 標準に厳密には準拠しない標準化された形式で求職者に表示します。
Indeed は HTML エンティティをサポートしていません。たとえば、HTML エンティティの < ではなく < を使用してください。
Indeed は、これらの書式ガイドラインに従わない HTML を拒否したり、書式の問題がある状態で表示したりすることがあります。
Indeed では次の HTML タグをサポートしています。
| タグ | 説明 |
|---|---|
<b> | 太字。 |
| 見出し。 注: Indeed のページでは、見出しタグ内のテキストは統一されたサイズで表示されます。 |
<br> | 単一の改行。 |
<p> | 段落。Indeed は段落タグの間に空白行を挿入します。 |
<ul> | 順序なしリスト(箇条書き)。 |
<li> | リスト項目。 |
<strong> | 太字テキスト。 |
<em> | 強調テキスト(斜体)。 |
| 基本的な表。Indeed は各セルを改行して表示します。 |
Indeed では次の computed style node もサポートしています。
| ノード | 説明 |
|---|---|
<font style="font-weight:bold">Some bold text</font> | 太字。 |
<div> <h2 style="display:inline">Label: </h2> Text </div> | インラインテキストを表示します。
|
段落タグの上下の margin 値と padding 値には正の数値を使用してください。これは <p> タグのデフォルトの動作です。