求人情報取得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 求人の職種コード(厚生労働省編 職業分類小分類まで)です。
    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 情報提供元の名称です。

    サンプルレスポンス

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

    {
    "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": "2019-06-30T23:59:59",
      "status": 0,
      "title": "データサイエンティスト募集!移住したら最大100万円支給!【移住支援金対象】",
      "postalCode": 1530051,
      "localGovernmentCode": 131105,
      "workLocationPrefecture": "東京都",
      "workLocationCity": "目黒区",
      "workLocationTown": "上目黒",
      "workLocationBlock": "37021",
      "workLocationBuilding": "目黒マンション110号室",
      "accessRoute": "中目黒駅から徒歩2分。駅東口の目の前のビルです。",
      "industryCode": "A7281",
      "officeAtmosphere": "エンジニアは20名弱で30代~40代のメンバーが中心です。",
      "employmentTypeCode": 100,
      "employmentTypeNote": "総合正社員",
      "employmentPeriodCode": 0,
      "employmentPeriodStart": "43556",
      "employmentPeriodEnd": "43921",
      "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年以上5年未満の勤続者1.0(2) 5年以上10年未満の勤続者1.4(3) 10年以上15年未満の勤続者1.9(4) 15年以上20年未満の勤続者3.0(5) 20年以上の勤続者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": "就業場所:地下2階 エレベーター:有 車椅子移動:可 出入口段差:無 階段手すり:有(片) 車椅子用トイレ:有",
      "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": "ヤフー",
      "yJobId": "yahoojobtest"
    }
    ]
    }

    エラー

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

    アプリケーションの管理

    目次

    開発のヒント