ATSパートナー向けスポンサー求人APIガイド

キャンペーンの予測やオーガニック求人のパフォーマンスと予測など、プライベートエンドポイントにアクセスします。

 

法的注意

Indeed の API の使用について Indeed と書面による契約を締結していない場合、この API またはそのドキュメントを使用することにより、Indeed の API の使用には Indeed API Terms （新しいウィンドウで開きます） および Additional API Terms and Guidelines が適用されることに同意したものとみなされます。

ここに記載する技術的な詳細は、ATSパートナー向けスポンサー求人APIリファレンスを補足するものであり、連携で使用できるエンドポイントを説明します。一部のエンドポイントは公開されています。それ以外はプライベートで、ATSパートナーのみが使用できます。

ベースURL

ATSパートナーは、次のベースURLでAPIにアクセスします。

/adsエンドポイント

https://apis.indeed.com/ads （新しいウィンドウで開きます）

エンドポイント

公開エンドポイント

ATSパートナー向けスポンサー求人APIリファレンスでは、次のエンドポイントを説明しています。

エンドポイントが広告代理店向けと直接の採用企業向けの両方の利用方法に対応している場合は、直接の採用企業向けの方法を使用してください。

• アカウント管理
• キャンペーン管理
• レポート

プライベートエンドポイント

次のエンドポイントは、このプログラム向けにセットアップされたATSパートナーのみが使用できます。

• キャンペーン予測
• オーガニック求人のパフォーマンスと予測

OAuthスコープ

OAuth認可コードリクエストでは、呼び出すエンドポイントのスコープを渡します。エンドユーザーは、それらのスコープをまったく付与しない、一部だけ付与する、またはすべて付与できます。各エンドポイントのスコープは、次の表で確認してください。

キャンペーン予測

キャンペーン予測のスコープ

APIエンドポイント	OAuthスコープ	アクセストークンの種類
POST /v1/campaignpredictions	employer_access	employer_accessスコープ付き。採用企業を表すアクセストークンを取得するをご覧ください。

オーガニック求人予測

オーガニック求人予測のスコープ

APIエンドポイント	OAuthスコープ	アクセストークンの種類
POST /v1/organicjobpredictions	employer_access	任意

認可エラーを処理する

ユーザーがリクエストしたスコープにアクセスできない場合、またはアプリを認可しない場合に発生するエラーを処理してください。付与されたスコープを確認するには、アクセストークンレスポンスのscopeフィールドを確認します。

エラーコードは次のとおりです。

認可エラーコード

エラーコード	説明
403 INSUFFICIENT_SCOPE	アクセストークンは有効ですが、必要なスコープが付与されていません。
401 INVALID_TOKEN	アクセストークンがない、無効である、または期限切れです。

これらのエラーの対処方法については、推奨ベストプラクティスをご覧ください。ユーザーにOAuth認可コードグラントを再度実行させて、より多くのスコープを認可してもらうこともできますが、一部のユーザーは権限が制限されているため、リクエストしたすべてのスコープを認可できません。

アプリにリクエストしたすべてのスコープが付与されない場合は、制限付きの機能セットで動作できるようにしてください。

推奨ベストプラクティス

APIは結果整合性です。POST /v1/campaignsでキャンペーンを作成した後、短時間GET /v1/campaigns/{campaignId}がそのキャンペーンを返さないことがあります。作成または変更の直後にリソースをリクエストする場合は、再試行の仕組みを追加してください。

API利用上の問題を検知するために、4XXレスポンスを監視してください。OAuthスコープを使用すると、401 INVALID_TOKENや403 INSUFFICIENT_SCOPEエラーが発生することがあります。

5XXレスポンスは通常、一時的な内部サービスの問題です。少し待ってから再試行してください。エラーが解消しない場合は、marketplacesupport@indeed.comにメールでお問い合わせください。

リクエストパスに/adsが付いていない場合、レスポンスはIndeedがリクエストをスポンサー求人APIにルーティングできなかったことを示します。たとえば、https://apis.indeed.com/v1/accountではなくhttps://apis.indeed.com/ads/v1/accountを使用します。

アカウント管理

アカウント管理

メソッド	エンドポイント	参照
GET	/v1/account	採用企業のIndeed広告アカウント情報を取得する

このエンドポイントを使用して、採用企業の基本情報を取得します。

次のレスポンスは、採用企業が採用企業アカウントをセットアップするを完了する必要があることを示します。

• 400 NOT_EMPLOYER_ACCOUNTは、ユーザーがIndeedの採用企業アカウントを持っていないことを示します。

• billingActiveがfalseの場合、ユーザーは求人をスポンサーするために必要なIndeedアカウントのセットアップを完了していません。

  レスポンスに請求ステータスを含めるには、fields=id,email,contact,company,jobSourceList,billingActiveを渡します。

キャンペーン管理

採用企業のキャンペーンは、採用企業がIndeed Analytics （新しいウィンドウで開きます）ダッシュボードで管理する内容と一致します。すべての求人キャンペーンには、784e4acec9x100z2のような一意のIDがあります。

次のエンドポイントを使用します。

• キャンペーンの予算見積もりを取得する
• キャンペーンを作成する
• キャンペーンの基本情報を更新する
• キャンペーンの予算と期間を取得する
• キャンペーンの予算と期間を更新する

キャンペーンの予算見積もりを取得する

採用企業が平均日予算（ADB）キャンペーンを作成する前に、このエンドポイントを使用して、求人ごとの推奨日予算とキャンペーン単位の平均日予算を取得します。

キャンペーンの予算見積もりを取得する

メソッド	エンドポイント	参照
POST	/v1/campaignbudgetquote	キャンペーンの予算見積もりを取得する

レスポンスには、スポンサープランの平均予算見積もり、一致した各求人の見積もり、STANDARDおよびPREMIUMティアの推奨が含まれます。

推奨日予算は目標であり、保証ではありません。Indeedはこの金額に近づくよう最適化しますが、日々の消化額は変動します。たとえば、平均日予算が$25の場合、1日目は$20、2日目は$30になることがあります。

このエンドポイントへの呼び出しは、スポンサー求人APIの利用ポリシーの対象として課金されません。

• 新しい求人を掲載してから2〜3時間待ってから、キャンペーンを作成してください。
• 予算推奨の呼び出しから1時間以内にキャンペーンを作成してください。それ以降は市場状況が変わる可能性があり、キャンペーン作成時には最新の推奨予算が使用されます。
• 手動で追加された求人、およびクエリベースの求人解決によって自動的に追加された求人は、推奨予算がデフォルトの日次消化額として使用されます。

リクエスト:

curl -L -X POST 'https://apis.indeed.com/ads/v1/campaignbudgetquote' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
   "jobsQuery": "title:\"financial analyst\" AND city:(toronto OR \"new york\")",
   "jobsTitle": "Healthcare Intern",
   "jobsCompany": "Indeed",
   "jobsLocation": "Austin, TX",
   "jobsLocationRadius": 25,
   "jobsSourceId": "8977ac341a3c4527",
   "jobsSourceName": "CompanyABC",
   "jobsToInclude": "ALL"
}'

レスポンス:

{
  "meta": {
    "status": 200,
    "errors": [{
      "type": "RESOURCE_NOT_FOUND",
      "description": "Couldn't locate the requested resource"
    }],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 25,
    "links": [{
      "rel": "next",
      "href": "/v1/campaigns/3141592653589793"
    }]
  },
  "data": {
    "sponsorshipPlanBudgetQuotes": [{
      "sponsorshipPlan": "PREMIUM",
      "dailyAvgBudgetPerJob": {
        "amount": 0,
        "currency": "string"
      },
      "jobBudgetQuotes": [{
        "jobKey": "89deb9de58ebe149",
        "dailyBudget": {
          "amount": 0,
          "currency": "string"
        }
      }]
    }]
  }
}

キャンペーンを作成する

スポンサー求人キャンペーンを作成します。

前提条件

• 新しい求人を掲載してから2〜3時間待ってから、キャンペーンを作成してください。
• 採用企業アカウントが求人ソースに関連付けられている必要があります。アカウントの求人ソースを一覧表示するには、GET /v1/accountを使用します。求人ソースがない場合は、Indeedカスタマーサポートにお問い合わせください。
• キャンペーンが求人をスポンサーするには、採用企業アカウントに有効な請求情報 （新しいウィンドウで開きます）が登録されている必要があります。

スポンサー求人キャンペーンを作成する

メソッド	エンドポイント	参照
POST	/v1/campaigns	キャンペーンを作成する

このエンドポイントを使用してキャンペーンを作成します。このエンドポイントは新しいキャンペーンのIDを返します。このキャンペーンIDを保存し、キャンペーンの変更やレポート取得に使用してください。

キャンペーンを作成するときは、採用企業が選択した予算と期間を設定します。採用企業のデフォルト通貨を使用してください。

• 最小予算と最小期間は、それぞれ$50と7日間です。

• 各求人には、XMLフィードの一意の参照番号を使用します。
• 日付はYYYY-MM-DD形式で、米国中部時間で指定します。

キャンペーンを作成するには、これらのパラメータを設定する

キャンペーン作成に必要なパラメータ

フィールド	説明
jobsToInclude	常にqueryを設定します。
jobsQuery	refnum:xxxxxを使用します。xxxxxは求人の一意の参照番号です。XML求人フィードのreferencenumberノードと一致する必要があります。 例: refnum:12345
jobsSourceName	この求人のソースまたは会社です。XML求人フィードにある求人のsourcenameノードと完全に一致する必要があります。 例: Robertson Recruiting

採用企業が月次キャンペーンを選択した場合

月次の定期キャンペーンは暦月に従います。

月次の定期キャンペーン

フィールド	説明
budgetMonthlyLimit	予算額。
budgetFirstMonthBehavior	startNowProratedAmountに設定します。

採用企業が固定期間キャンペーンを選択した場合

固定期間キャンペーン

フィールド	説明
budgetOnetimeLimit	予算額。
startDate	キャンペーンの開始日です。YYYY-MM-DD形式、米国中部時間で指定します。デフォルトは当日です。
targetEndDateまたはfixedEndDate	キャンペーンの終了日です。YYYY-MM-DD形式、米国中部時間で指定します。 targetEndDate Indeedはこの日付に向けて予算消化を最適化しますが、予算が残っている場合はこの日付を過ぎても消化を続けます。 fixedEndDate 完全に停止します。Indeedはこの日付に向けて予算消化を最適化し、この日付を過ぎた消化を許可しません。

キャンペーンの基本情報を更新する

キャンペーンの基本情報を更新する

メソッド	エンドポイント	参照
PATCH	/v1/campaigns/{campaignId}	キャンペーンの基本情報を更新する

このエンドポイントを使用して、キャンペーンのステータスを変更します。

採用企業は、キャンペーンに次のいずれかのステータスを設定できます。

キャンペーンのステータス

ステータス	説明
ACTIVE	キャンペーンは求人をスポンサーできます。
PAUSED	採用企業がアクティブにするまで、キャンペーンは求人をスポンサーしません。
DELETED	採用企業がキャンペーンを削除しました。

ステータスはキャンペーンにのみ適用され、採用企業の請求ステータスや残りの予算とは独立しています。

アクティブなキャンペーンでも、次の確認が必要な場合があります。

キャンペーンのステータス確認

キャンペーンステータス	追加チェック	説明
Active	アカウント管理エンドポイントを使用して、請求が有効であることを確認します。	請求が有効でない場合、キャンペーンは消化できません。次のようにユーザーに通知します。 「キャンペーンに資金を割り当てるには、まずIndeedアカウントに請求情報を追加する必要があります。」 その後、ユーザーを採用企業アカウントをセットアップするにリダイレクトします。
Active	キャンペーンの予算と期間を取得すると期間を指定してキャンペーンの統計を取得するのエンドポイントを使用して、残りの予算を確認します。	予算が残っていない場合、キャンペーンは求人のスポンサーを継続できません。予算を更新するかどうかをユーザーに確認し、キャンペーンの予算と期間を更新するエンドポイントで、元の金額に追加分を加えた新しい合計額を設定します。

キャンペーンの予算と期間を取得する

キャンペーンの予算と期間を取得する

メソッド	エンドポイント	参照
GET	/v1/campaigns/{campaignId}/budget	キャンペーンの予算と期間を取得する

このエンドポイントを使用して、キャンペーンの予算と期間を取得します。返されるフィールドは、キャンペーンの予算が期間全体で1回のみか、毎月繰り返されるかによって異なります。

月次の定期キャンペーン

これらのキャンペーンは暦月に従います。レスポンスには、月次の予算額を示すbudgetMonthlyLimitが含まれます。

固定期間キャンペーン

固定期間キャンペーン

フィールド	説明
budgetOnetimeLimit	予算額。
startDate	キャンペーンの開始日です。YYYY-MM-DD形式、米国中部時間で指定します。デフォルトは当日です。
targetEndDateまたはfixedEndDate	キャンペーンの終了日です。YYYY-MM-DD形式、米国中部時間で指定します。 targetEndDate Indeedはこの日付に向けて予算消化を最適化しますが、予算が残っている場合はこの日付を過ぎても消化を続けます。 fixedEndDate 完全に停止します。Indeedはこの日付に向けて予算消化を最適化し、この日付を過ぎた消化を許可しません。

キャンペーンの予算と期間を更新する

キャンペーンの予算を更新する

メソッド	エンドポイント	参照
PATCH	/v1/campaigns/{campaignId}/budget	キャンペーンの予算と期間を更新する

このエンドポイントを使用して、キャンペーンの予算と期間を変更します。

レポート

レポートエンドポイントを使用して、Indeedからキャンペーンパフォーマンスレポートを取得し、採用企業が利用できるようにします。

期間を指定してキャンペーンの統計を取得する

キャンペーンパフォーマンス

メソッド	エンドポイント	参照
GET	/v1/campaigns/{campaignId}/stats	期間を指定してキャンペーンの統計を取得する

このエンドポイントを使用して、指定した期間のキャンペーンパフォーマンスレポートを取得します。

ATSパートナーは、このレポートを使用して、集計済みのクリック、インプレッション、コンバージョン、コストの情報を採用企業に提示できます。

日付範囲は366日を超えることはできません。

キャンペーンパフォーマンスレポートを取得する

パラメータ	説明
startDate	レポート開始日。開始日を含みます。YYYY-MM-DD形式で、米国中部時間で指定します。
endDate	レポート終了日。終了日は含みません。YYYY-MM-DD形式で、米国中部時間で指定します。
merge	値は次のとおりです。 true 日付範囲のすべてのパフォーマンスデータを集計します。 false デフォルト値です。レスポンスは日付ごとにデータを分けて返します。

キャンペーンの予算を取得するを使用し、キャンペーンパフォーマンスレポートの情報と組み合わせて、求人の現在の予算と、これまでに発生したコストを表示します。

そのためには、このエンドポイントのstartDateパラメータにキャンペーン作成日を渡します。

また、データを集計するためにmerge=trueを渡します。

これにより、キャンペーン開始日からそのキャンペーンで消化した金額を確認できます。

返されるキャンペーンパフォーマンスデータには、次の項目が含まれます。

• インプレッション
• クリック
• コンバージョン（応募）
• コスト
• 通貨コード（USD、GBPなど）

キャンペーン予測を取得する

キャンペーン予測を取得する

メソッド	エンドポイント	参照
POST	/v1/campaignpredictions	プライベート — キャンペーン予測を取得する

このエンドポイントは、次のことを行います。

• 予算に対する期待される求人パフォーマンスを、総応募数の観点から推定します。
• 希望するパフォーマンスに基づいて、求人をスポンサーするための予算を推奨します。

特定の求人とそのプロパティに対するこれらの予測は、Indeed上の類似求人の過去のパフォーマンスに基づきます。 複数の求人を含むキャンペーンのパフォーマンスも予測できます

予測は現在、米国の英語求人でのみ利用でき、1日あたりUSD $100未満の予算に対するパフォーマンスを推定します。すべての予算額は米ドル（USD）で指定します。

予測は、求人のプロパティ、およびキャンペーンの種類と期間に基づきます。

採用企業が推奨予算を承認したら、同じパラメータでキャンペーンを作成してください。

複数の求人を含むキャンペーンの予測

パラメータ	説明
mode	求人モードの値です。 複数求人のキャンペーン予測にはmulti-jobを設定します。

リクエストボディ

キャンペーン予測のリクエスト

フィールド	必須	説明	型
body	required	求人、キャンペーン、および予測の情報。	CampaignPredictions

CampaignPredictions

キャンペーン予測

フィールド	必須	説明	型
jobInfo	required	求人とそのプロパティを説明します。	JobInfo
campaignInfo	required	希望するキャンペーンタイプを説明します。	CampaignInfo
predictionsInfo	required	予測に使用する希望応募数または希望予算を指定します。	PredictionsInfo

JobInfo

求人情報

フィールド	必須	説明	型
jobsLocation	required	求人所在地の都市。 例: Austin, TX	String
jobsQuery	required	refnum:xxxxxを使用し、xxxxxを求人に定義された一意の参照番号に置き換えます。これはXML求人フィードのreferencenumberノードの値と一致する必要があります。refnum:xxxxx形式で指定してください。 例: refnum:12345	String
jobsSourceName	required	この求人のソースまたは会社です。XML求人フィード内の求人のsourcenameノードと完全に一致する必要があります。 例: Robertson Recruiting	String
jobsTitle	required	求人タイトル。 例: Software Engineer	String

CampaignInfo

キャンペーン情報

フィールド	必須	説明	型
campaignType	required	ONETIMEまたはMONTHLYのいずれか 例: MONTHLY	String
startDate	conditional	キャンペーン開始日。YYYY-MM-DD形式で、米国中部時間で指定します。デフォルトは当日です。campaignTypeがONETIMEの場合にのみ適用されます。 例: 2021-08-01	String
endDate	conditional	キャンペーン終了日。YYYY-MM-DD形式で、米国中部時間で指定します。campaignTypeがONETIMEの場合は必須です。 例: 2021-08-10	String

PredictionsInfo

予測情報

フィールド	必須	説明	型
predictionType	required	BUDGET_BASEDまたはAPPLY_BASEDのいずれか 例: BUDGET_BASED	String
budgets	conditional	推定パフォーマンスを取得する予算です。パフォーマンスは応募数で推定されます。配列には1つの数値のみを渡します。predictionTypeがBUDGET_BASEDの場合は必須です。 例: [75.50]	Double配列
totalApplies	conditional	推奨予算を取得したい、求人全体の希望応募総数です。これにはオーガニック応募とスポンサー応募の両方が含まれます。配列には1つの数値のみを渡します。predictionTypeがAPPLY_BASEDで、appliesPerJobが設定されていない場合は必須です。 例: [5]	Integer配列
appliesPerJob	conditional	推奨予算を取得したい、求人ごとの希望応募数です。これにはオーガニック応募とスポンサー応募の両方が含まれます。配列には1つの数値のみを渡します。predictionTypeがAPPLY_BASEDで、totalAppliesが設定されていない場合は必須です。 例: [5]	Integer配列

レスポンス

キャンペーンのレスポンス

名前	説明	型
currencyCode	予算額の通貨コード。 例: USD	String
predictions	すべての求人全体に対する推定パフォーマンスまたは推奨予算。	Predictionの配列
jobLevelPredictions	各求人に対する推定パフォーマンスまたは推奨予算。	JobLevelPredictionsの配列

JobLevelPredictions

求人単位の予測

名前	説明	型
job	求人の詳細	求人の詳細
predictions	求人に対する推定パフォーマンスまたは推奨予算。	Predictionの配列

求人の詳細

求人の詳細

名前	説明	型
jobKey	求人キー。	String
refNum	求人参照番号。	String
title	求人タイトル。	String
location	求人所在地。	String

Prediction

キャンペーン予測

名前	説明	型
budget	BUDGET_BASEDリクエストでは、推定応募数の基準となる予算です。APPLY_BASEDリクエストでは、希望する総応募数を達成するための推奨予算です。	Double
organicApplies	BUDGET_BASEDリクエストでは、スポンサーしない場合の求人のオーガニック応募数の推定値です。スポンサーによって生じる推定応募数を計算するには、totalAppliesとorganicAppliesを使用します。	Integer
totalApplies	BUDGET_BASEDリクエストでは、予算値に対するオーガニックおよびスポンサー求人の応募総数の推定値です。 APPLY_BASEDリクエストでは、推奨予算の基準となる応募総数です。	Integer
estimatedLowerApplies	BUDGET_BASEDリクエストでは、予算値に対するオーガニックおよびスポンサー求人の応募数の推定下限値です。 APPLY_BASEDリクエストでは、レスポンスにこのフィールドは含まれません。	Integer
estimatedHigherApplies	BUDGET_BASEDリクエストでは、予算値に対するオーガニックおよびスポンサー求人の応募数の推定上限値です。 APPLY_BASEDリクエストでは、レスポンスにこのフィールドは含まれません。	Integer

予測のJSONリクエスト例

{
  "jobInfo": {
    "jobsLocation": "Austin, TX",
    "jobsQuery": "refnum:12345",
    "jobsSourceName": "Bob’s Recruiting",
    "jobsTitle": "Software Engineer"
  },
  "campaignInfo": {
    "campaignType": "ONETIME",
    "startDate": "2021-08-10",
    "endDate": "2021-08-11"
  },
  "predictionsInfo": {
    "predictionType": "BUDGET_BASED",
    "budgets": [75.50]
  }
}

予測のJSONレスポンス例

{
  "currencyCode": "USD",
  "predictions": [{
    "predictionType": "BUDGET_BASED",
    "budget": 151,
    "organicApplies": 3,
    "totalApplies": 7,
    "estimatedLowerApplies": 3,
    "estimatedHigherApplies": 10
  }],
  "jobLevelPredictions": [{
      "job": {
        "jobKey": "80fdf7e9de72243f",
        "refNum": "12800649-92-99",
        "title": "Firmware Engineer",
        "location": "Irvine"
      },
      "predictions": [{
        "predictionType": "BUDGET_BASED",
        "budget": 75.5,
        "organicApplies": 2,
        "totalApplies": 4,
        "estimatedLowerApplies": 2,
        "estimatedHigherApplies": 5
      }]
    },
    {
      "job": {
        "jobKey": "79db86f75cbbde08",
        "refNum": "12800649-93-100",
        "title": "Principal Software Engineer",
        "location": "Irvine"
      },
      "predictions": [{
        "predictionType": "BUDGET_BASED",
        "budget": 75.5,
        "organicApplies": 1,
        "totalApplies": 3,
        "estimatedLowerApplies": 1,
        "estimatedHigherApplies": 5
      }]
    }
  ]
}

オーガニック求人のパフォーマンスと予測を取得する

オーガニック求人のパフォーマンスと予測を取得する

メソッド	エンドポイント	参照
POST	/v1/organicjobpredictions	プライベート — オーガニック求人のパフォーマンスと予測を取得する

このエンドポイントは、次の情報を提供します。

• 単一求人の過去30日間のオーガニックトラフィック統計
• 今後30日間のオーガニックトラフィック統計の推定値
• 求人をスポンサーした場合のトラフィック改善の推定値

パフォーマンスはクリック数で表されます。

すべての予算額はUSDで指定します。

このエンドポイントを使用するには、採用企業の管理者ユーザーが採用企業アカウントをセットアップするの手順に従ってIndeedのアカウントを作成しておく必要があります。ただし、スポンサー用の請求情報が設定されていない場合は、URLにtype=loginパラメータを渡してセットアップフローを簡略化できます。

オーガニック求人のパフォーマンスと予測のリクエスト

パフォーマンスのリクエスト

名前	必須	説明	型
body	required	求人関連情報。	OrganicJobPrediction

OrganicjobPredictionフィールド

オーガニック求人の予測

名前	必須	説明	型
jobInfo	required	求人説明とそのプロパティ。	JobInfo

JobInfoフィールド

JobInfoフィールド

名前	必須	説明	型
jobsQuery	required	求人を識別する一意の参照番号です。「refnum:xxxxx」形式で指定します。XML求人フィードのreferencenumberノードと一致する必要があります。 例: refnum:12345	String
jobsSourceName	required	この求人のソースまたは会社です。XML求人フィードの求人のsourcenameノードと完全に一致する必要があります。 例: Robertson Recruiting	String

オーガニック求人のパフォーマンスと予測のレスポンス

レスポンスは、求人にトラフィックがあったかどうか、およびその求人のスポンサーが推奨されるかどうかによって異なる場合があります。

• 求人が過去30日間にトラフィックを受けていない場合、metricオブジェクト内のclicksフィールドの値は0です。
• 求人が30日間存在していない場合、トラフィック統計はその求人が存在した日数分について返されます。ただし、daysレスポンスフィールドの値は30のままです。
• 推奨が利用できない場合、recommendationフィールドは返されません。

パフォーマンス予測のレスポンス

名前	必須	説明	型
metric	required	指定した求人の過去30日間のオーガニックトラフィック統計。	OrganicMetric
prediction	required	指定した求人の今後30日間のオーガニックトラフィック統計の推定値。	OrganicPrediction
recommendation	optional	利用可能な場合、推奨予算に基づく指定求人のスポンサーパフォーマンス推定値。	SponsoredPrediction

OrganicMetricフィールド

OrganicMetricフィールド

名前	説明	型
clicks	過去n日間にその求人が獲得したクリック数。	Integer
days	日数。デフォルトは30日です。	Integer

OrganicPredictionフィールド

OrganicPredictionフィールド

名前	説明	型
clicks	今後n日間における、その求人の推定クリック数。	Integer
days	日数。デフォルトは30日です。	Integer

SponsoredPredictionフィールド

SponsoredPredictionフィールド

名前	説明	型
clicks	今後n日間における、その求人の推定クリック数。	Integer
days	日数。デフォルトは30日です。	Integer
budget	スポンサーに推奨される予算。	Double

JSONリクエスト例

{
  "jobInfo": {
    "jobsQuery": "refnum:12345",
    "jobsSourceName": "Bob’s Recruiting"
  }
}

JSONレスポンス例

{
  "metric": {
    "clicks": 30,
    "days": 30
  },
  "prediction": {
    "clicks": 40,
    "days": 30
  },
  "recommendation": {
    "budget": 250.0,
    "clicks": 70,
    "days": 30
  }
}

---

 

このページは役に立ちましたか？