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がコンテンツを拒否したり、不正な形式で表示したりする可能性があります。
Before you start, review Applicant tracking system | ATS integrations.
The Indeed XML feed contains the job information that appears on Indeed. When you maintain an XML feed, you control how jobs appear on Indeed. You can also add the Indeed Apply label to jobs.
When your customers create jobs in your system, your XML feed sends those listings directly to Indeed.
The XML feed
Create and maintain an XML document that defines your jobs. Indeed monitors the file for changes in one of these ways:
- Crawling an XML URL
- Crawling a client-hosted FTP site (SFTP is also supported)
- Receiving the file directly on an Indeed FTP server (zipped files are recommended)
Include all jobs from your career page in the XML feed. Indeed does not accept incomplete XML feeds and does not support partial job opt-in. If your XML file does not include all jobs, Indeed might reject it or limit its visibility to job seekers.
Include in the XML all information that job seekers can see on your website. For example, if your job listings show salaries, include a data element such as <salary>. If salary information does not appear on your website, you do not need to include it for indexing.
基本的なフィードノード
基本的なフィードノードは、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を参照してください。 Indeedはこのエレメントのデータを勤務地の判定には使用しません。リモート求人の掲載方法については、XMLフィードのFAQを参照してください。 例: <![CDATA[COVID-19]]> | |
この求人に対して貴社のシステムが行った操作の最新タイムスタンプ。 操作には、応募者のレビューや求人の更新などが含まれます。 例: <![CDATA[2014-12-19T22:49:39Z]]> | |
クライアントが社内で自社の事業単位を識別するために使用する識別子。 例: 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 formattingを含めてください。Indeedは、Webサイトで使用しているものと同じHTML formattingをCDATAタグ内で使用することを想定しています 。
IndeedはHTML標準へ厳密に準拠するのではなく、HTMLコンテンツを標準化された形式に正規化して求職者へ表示します。
IndeedはXML フィード内でHTML entitiesをサポートしていません。HTML entitiesではなく、リテラル文字を使用してください。たとえば、<ではなく<を使用します。HTML entitiesを使用すると、Indeedがコンテンツを拒否したり、不正な形式で表示したりする可能性があります。
| タグ | 説明 |
|---|---|
<b> | 太字テキスト。 |
| ヘッダー。 ヘッダータグ内のテキストは、Indeed上で一定のサイズで表示されます。 |
<br> | 単一改行。 |
<p> | 段落。Indeedは段落タグ間に自動的に空白行を挿入します。 |
<ul> | 順序なしリスト(箇条書き)。 |
<li> | リストアイテム。 |
<strong> |