求人情報取得API

企業が求めている働く人の労働条件などの情報を取得できます。

リクエストURL

JSON

https://job.yahooapis.jp/v1/furusato/jobinfo/

リクエストパラメータ

パラメータ	値	説明
appid（必須）	string	アプリケーションID。詳細はこちらをご覧ください。
yJobId	string	求人単位の管理番号です。求人ごとに一意です。
localGovernmentCode	number	総務省全国地方公共団体コードです。6桁の市区町村単位で指定できます。 ex) 山口市:352039
fields	string	取得するレスポンスパラメータを増減できます。指定なし：一部のレスポンスパラメータを取得しません。（デフォルト） full：すべてのレスポンスパラメータを取得します。
start	number	表示開始位置（デフォルト: 1）です。
results	number	表示件数（デフォルト: 10、最大：1,000）です。

サンプルリクエストURL

https://job.yahooapis.jp/v1/furusato/jobinfo/?appid=<あなたのアプリケーションID>

レスポンスフィールド

フィールド	説明
total	全データ件数です。
start	レスポンス情報に含まれる、全データからの取得開始位置です。
count	レスポンス情報に含まれる、データ件数です。
results	取得結果です。
yJobId	求人単位の管理番号です。求人ごとに一意です。
jobId	都道府県ごとの求人単位の管理番号です。
corporationId	求人者となる法人の番号です。
startDate	求人の掲載開始日時です。日本標準時（JST）UTC+9 です。
updatedDate	求人の更新日時です。日本標準時（JST）UTC+9 です。
endDate	求人の掲載終了日時です。日本標準時（JST）UTC+9 です。
status	求人の表示、非表示を決定するフラグです。求人が取り下げられた場合に用いられます。 0:非表示 1:表示
title	各求人の件名、タイトルです。移住支援金対象求人については、【移住支援金対象】と末尾に付記されています。
postalCode	就業場所の郵便番号です。ハイフンは入りません。
localGovernmentCode	就業場所の全国地方公共団体コードです。6桁の市区町村単位です。
workLocationPrefecture	就業場所の都道府県名です。
workLocationCity	就業場所の市区町村名です。
workLocationTown	就業場所の町字名です。
workLocationBlock	就業場所の丁目番地号です。
workLocationBuilding	就業場所の建物名、部屋番号、その他場所を特定するための詳細な情報です。
accessRoute	就業場所までの交通手段別アクセス方法、最寄駅、バス停及び特記事項です。
industryCode	求人の業種のコード（総務省日本標準産業分類を4階層）です。
officeAtmosphere	求職者に職場のイメージを持っていただくための職場の人間関係や職場の雰囲気などの情報です。
employmentTypeCode	求人の雇用形態に係るコードです。 100:正社員 110:新卒採用 120:パート・アルバイト 130:派遣社員 140:インターン 150:ボランティア 160:契約社員 170:業務委託 180:プロボノ
employmentTypeNote	求人に係る雇用形態に関する特記事項です。
employmentPeriodCode	求人の雇用期間の無期、有期の別です。 0:無期 1:有期
employmentPeriodStart	雇用期間が有期の場合、雇用期間の開始日が取得できます。
employmentPeriodEnd	雇用期間が有期の場合、雇用期間の終了日が取得できます。
employmentPeriodNote	雇用期間に関する特記事項です。
occupationCode	求人の職種コード（厚生労働省編職業分類小分類まで）。厚生労働省編職業分類（平成23年改定）3桁、もしくは（令和4年改定）5桁のどちらかのコードです。
occupationName	職種分類項目名です。
description	求人の仕事、業務内容です。
imgUrlPc	パソコン用の求人内容のイメージ画像を掲載しているURLです。
imgUrlSp	スマートフォン用の求人内容のイメージ画像を掲載しているURLです。
offerNumber	求人人数です。
workingDayCode	求人の勤務日です。 1:月曜日 2:火曜日 3:水曜日 4:木曜日 5:金曜日 6:土曜日 7:日曜日 9:その他シフト制や3交代制は、9:その他を選択し、勤務日・時間の特記事項に記載しています。
workingDayNote	勤務日に関する特記事項です。
workingTimeStart	求人の基準となる始業時間です。
workingTimeEnd	求人の基準となる就業時間です。
workingTimeNote	就業時間に関する特記事項です。
breakTimeStart	求人の休憩開始時間です。
breakTimeEnd	求人の休憩終了時間です。
breakTimeNote	求人の休憩時間に関する特記事項。休憩時間が流動的である場合に記述しています。
flexTime	裁量労働制の有無の別。 0:無 1:有
flexTimeNote	裁量労働制の具体的な内容です。
holidayCode	求人の休日です。 1:月曜日 2:火曜日 3:水曜日 4:木曜日 5:金曜日 6:土曜日 7:日曜日 8:祝日 9:その他シフト制や3交代制は、9:その他を選択し、勤務日・時間の特記事項に記載しています。
holidayNote	求人の休日に関する特記事項です。
overTime	残業の有無の別。 0:無 1:有
overTimeAverage	1年間で平均した1か月の残業時間です。
salaryTypeCode	給与の表記形態です。 1:時給 2:日給 3:月給 4:年収
workingHours	所定労働時間です。
salaryMax	給与の上限です。
salaryMin	給与の下限です。
salaryMaxTraining	研修中給与の上限です。
salaryMinTraining	研修中給与の下限です。
salaryNote	給与に関する特記事項です。
payRise	前年度の昇給実績の有無の別。 0:無、データが存在しない場合 1:有
payRiseNote	前年度の昇給実績に関する特記事項です。
bonus	前年度の賞与実績の有無の別。 0:無、データが存在しない場合 1:有
bonusNote	前年度の賞与実績に関する特記事項です。
transportationFee	通勤手当の有無の別。 0:無 1:有
transportationFeeNote	通勤手当に関する情報です。
allowance	その他手当の有無の別。 0:無 1:有
allowanceNote	その他の手当に関する特記事項です。
insuranceNote	加入保険に関する特記事項です。
retirementAllowance	退職金制度の有無の別。 0:無、データが存在しない場合 1:有
retirementAllowanceNote	退職金に関する情報です。
retirement	定年の有無の別。 0:無、データが存在しない場合 1:有
retirementAge	定年の年齢です。
retirementAgeNote	定年に関する特記事項です。
carCommuting	自動車通勤の可否の別。 0:不可、データが存在しない場合 1:可
carCommutingNote	自動車通勤に関する特記事項です。
welfare	福利厚生に関する事項です。
subsidy	就業に伴い直接雇用者へ給付される公的機関からの助成の有無の別。 0:無 1:有
subsidyImmigration	内閣府の地方創生推進交付金（移住・就業・企業タイプ）を活用した移住支援金対象の別。 0:対象外 1:対象
subsidyNote	就業に伴い直接雇用者へ給付される公的機関からの助成の内容です。
subsidyMax	就業に伴い直接雇用者へ給付される公的機関からの助成金額の総額のおおよその上限です。
subsidyMin	就業に伴い直接雇用者へ給付される公的機関からの助成金額の総額のおおよその下限です。
requiredAcademicBackground	求人の必要学歴です。
requiredExperience	求人の必要経験です。
requiredLicense	求人の必要免許・資格です。
requiredPersonality	求人の人物像に関する事項です。
requiredWelcome	求人の歓迎要件に関する事項です。
ageLimit	年齢制限に関する有無の別。 0:無、データが存在しない場合 1:有
ageLimitDivision	雇用対策法に基づく、年齢制限が認められる例外区分です。 1:例外事由 1号（定年年齢） 2:例外事由 2号（法令） 3:例外事由 3号イ（キャリア形成） 4:例外事由 3号ロ（技能・ノウハウ継承） 5:例外事由 3号ハ（芸術） 6:例外事由 3号ニ（高齢者）
ageLimitDetail	年齢制限に関する事項です。
ageLimitReason	年齢制限理由に関する事項です。
trialPeriod	試用期間の有無に関する事項の別。 0:無 1:有
trialPeriodNote	試用期間に関する特記事項です。
employmentDisabled	障害者雇用の対象に関する事項の別。 0:非対象、データが存在しない場合 1:対象
employmentDisabledNote	障害者雇用に関する特記事項です。
receptionMethod	応募方法に関する事項です。
receptionTel	応募受付の電話番号です。
receptionMail	応募受付のメールアドレスです。
receptionUrl	求人情報の詳細ページのURLです。
receptionForm	応募フォームのURLです。
recruitmentDepartment	採用担当部署名です。
recruitmentOfficer	採用担当者名です。
recruitmentOfficerTel	採用担当者連絡先（電話番号）です。
recruitmentOfficerMail	採用担当者連絡先（メールアドレス）です。
cpName	情報提供元の名称です。
preventsmoke	受動喫煙防止措置に関する事項です。

サンプルレスポンス

以下は、テスト用データのレスポンスです。

{
  "total": 1,
  "start": 1,
  "count": 1,
  "results": [
    {
      "jobId": "410004-999999",
      "corporationId": 8013201017060,
      "startDate": "2019-04-01T00:00:00",
      "updatedDate": "2019-03-25T12:00:00",
      "endDate": "2023-06-30T23:59:59",
      "status": 1,
      "title": "データサイエンティスト募集！移住したら最大100万円支給！【移住支援金対象】",
      "postalCode": 1530051,
      "localGovernmentCode": 131105,
      "workLocationPrefecture": "東京都",
      "workLocationCity": "目黒区",
      "workLocationTown": "上目黒",
      "workLocationBlock": "37021",
      "workLocationBuilding": "目黒マンションXXX号室",
      "accessRoute": "中目黒駅から徒歩2分。駅東口の目の前のビルです。",
      "industryCode": "A7281",
      "officeAtmosphere": "エンジニアは20名弱で30代～40代のメンバーが中心です。",
      "employmentTypeCode": 100,
      "employmentTypeNote": "総合正社員",
      "employmentPeriodCode": 1,
      "employmentPeriodStart": "2022-01-01",
      "employmentPeriodEnd": "2022-06-30",
      "employmentPeriodNote": "雇用期間の開始時期から終了時期のうち、6か月間。",
      "occupationCode": "577",
      "occupationName": "経営コンサルタント業",
      "description": "初めは企業から依頼されているコンサルタント業務をチーム制で行う所からスタート。",
      "imgUrlPc": "https://oo-corp.jp/pic/logo.jpg",
      "imgUrlSp": "https://oo-corp.jpp/pic/logo_smartphone.jpg",
      "offerNumber": "1名程度。",
      "workingDayCode": 12345,
      "workingDayNote": "シフト制",
      "workingTimeStart": "08:30",
      "workingTimeEnd": "17:15",
      "workingTimeNote": "0時～8時、8時～16時、16時～24時の3交代制。",
      "breakTimeStart": "12:00",
      "breakTimeEnd": "12:45",
      "breakTimeNote": "休憩時間は1時間。",
      "flexTime": 0,
      "flexTimeNote": "フレックスタイム制 コアタイム10:00～15:00",
      "holidayCode": 12345,
      "holidayNote": "祝日勤務の場合には代休申請可",
      "overTime": 1,
      "overTimeAverage": "100.2",
      "salaryTypeCode": 3,
      "workingHours": "8.25",
      "salaryMax": 240000,
      "salaryMin": 195000,
      "salaryMaxTraining": 216000,
      "salaryMinTraining": 175500,
      "salaryNote": "能力、実績次第で、月給24万円を超えることができます。",
      "payRise": 1,
      "payRiseNote": "1％のベースアップ",
      "bonus": 1,
      "bonusNote": "計4.1か月/年",
      "transportationFee": 1,
      "transportationFeeNote": "交通費支給（上限25,000円/月）",
      "allowance": 1,
      "allowanceNote": "住宅手当：16,000円（世帯主のみ、場所問わず） ",
      "insuranceNote": "各種社会保険完備（雇用・労災・健康・厚生）",
      "retirementAllowance": 1,
      "retirementAllowanceNote": "退職時は、退職時の基本給月額に勤続年数及び次に記載している倍数を乗じた額を支給します。(1)　１年以上５年未満の勤続者1．0(2)　５年以上１０年未満の勤続者1．4(3)　１０年以上１５年未満の勤続者1．9(4)　１５年以上２０年未満の勤続者3．0(5)　２０年以上の勤続者3．0",
      "retirement": 1,
      "retirementAge": 70,
      "retirementAgeNote": "定年延長あり。",
      "carCommuting": 1,
      "carCommutingNote": "自転車・バイク通勤可（バイクは駐輪無料。車は徒歩2分の駐車場［自己負担10,800円］を利用できます。）",
      "welfare": "住宅・医療の福利厚生あり。 人間ドックの補助あり（上限2万円/年）。",
      "subsidy": 1,
      "subsidyImmigration": 1,
      "subsidyNote": "・移住支援金あり（東京23区在住者、通勤者が移住の場合、最大100万円支給の可能性あり）・リフォーム補助金（県外から移住した場合、住居のリフォームに最大300万円支給の可能性あり） 詳しくは○○市役所のウェブサイト又は直接お問い合わせください。",
      "subsidyMax": 1000000,
      "subsidyMin": 0,
      "requiredAcademicBackground": "高卒以上",
      "requiredExperience": "経験不問。",
      "requiredLicense": "普通自動車免許",
      "requiredPersonality": "情熱をもって、仕事に積極的に取り組める人。",
      "requiredWelcome": "主婦、外国人、シニア、未経験なんでも歓迎。",
      "ageLimit": 1,
      "ageLimitDivision": 3,
      "ageLimitDetail": "35歳未満。",
      "ageLimitReason": "長期継続によるキャリア形成を図る観点から、若年者を無期雇用で募集します。",
      "trialPeriod": 1,
      "trialPeriodNote": "正式雇用まで6か月の試用期間あり。",
      "employmentDisabled": 1,
      "employmentDisabledNote": "就業場所：地下２階 エレベーター：有 車椅子移動：可 出入口段差：無 階段手すり：有（片） 車椅子用トイレ：有",
      "receptionMethod": "応募受付の電話、メール又はウェブサイトから応募ください。LINE（ID:******）からでも応募できます。",
      "receptionTel": "09-9999-9999",
      "receptionMail": "saiyo@oo.jp",
      "receptionUrl": "https://yahoo.co.jp",
      "receptionForm": "https://job.yahoo.co.jp/",
      "recruitmentDepartment": "採用担当",
      "recruitmentOfficer": "山田太郎",
      "recruitmentOfficerTel": "09-9999-9999",
      "recruitmentOfficerMail": "saiyo@oo.jp",
      "cpName": "ヤフー",
      "preventsmoke": "屋内禁煙",
      "yJobId": "11000000XXX"
    }
  ]
}

エラー

求人情報取得APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

アプリケーションの管理

求人情報取得API

リクエストURL

リクエストパラメータ

レスポンスフィールド

サンプルレスポンス

エラー

目次

利用のルール

開発のヒント

サービス一覧