求人

企業情報取得API

企業情報取得Web APIを利用してアプリケーションを開発

求人情報を登録している企業の情報を取得できます。

リクエストURL
JSON
https://job.yahooapis.jp/v1/furusato/company/

企業情報を取得する機能を提供します。

リクエストパラメータ

RESTリクエストの構築(GET)」をご参照ください。

パラメータ 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
localGovernmentCode number 総務省 全国地方公共団体コードです。6桁の市区町村単位で指定できます。
ex) 宇都宮市:092011
start number 表示開始位置(デフォルト: 1)です。
results number 表示件数(デフォルト: 10、最大:100)です。
yCompanyId string 企業単位の管理番号です。企業ごとに一意です。

サンプルリクエストURL

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



レスポンスフィールド

フィールド 説明
total 全データ件数です。
start レスポンス情報に含まれる、全データからの取得開始位置です。
count レスポンス情報に含まれる、データ件数です。
results 取得結果です。
yCompanyId 企業単位の管理番号です。企業ごとに一意です。
corporationId 法人番号です。番号法に基づいて発番された法人の法人番号で、国税庁法人番号公表サイトにて検索可能な番号です。
name 法人名です。
nameKana 法人名ふりがなです。
nameEn 法人名英語です。
postalCode 法人の本店郵便番号です。ハイフンは入りません。
localGovernmentCode 法人の本店住所、全国地方公共団体コードです。6桁の市区町村単位です。
prefecture 法人の本店住所、都道府県名です。
city 法人の本店住所、市区町村名です。
town 法人の本店住所、町字名です。
block 法人の本店住所、丁目番地号です。
building 法人の本店住所、建物名等です。
presidentPosition 代表者の役職名です。
presidentName 代表者名です。
capital 資本金です。
employees 従業員数です。
establishmentDate 本社の業種コード(総務省 日本標準産業分類を4階層)です。
listed 上場区分です。
  • 0:非上場
  • 1:上場
  • stockCode 証券コードです。日本の証券取引所に上場する企業に対し「証券コード協議会」が付与するアラビア数字で構成される識別番号です。
    averageAge 平均年齢です。
    femaleRate 従業員に占める女性の割合です。
    averageAnnualIncome 平均年収(単位: 千円)です。
    paidHolidayDigestibility 有給消化率です。
    turnoverRate 離職率です。
    femaleManagerRate 管理職に占める女性の割合です。
    handicappedEmployeeRate 障がい者雇用率です。
    averageDuration 平均勤続年数です。
    sales 売上高(単位: 百万円)です。
    salesDate 売上高(年月)です。
    currentEarnings 経常利益(単位: 百万円)です。
    currentEarningsDate 経常利益(年月)です。
    branch 支店等の情報です。
    facebookUrl FacebookURLです。
    twitterUrl TwitterURLです。
    tel 代表電話番号です。
    webUrl WebサイトURLです。
    logoImgUrlPc 法人ロゴ(PC用)です。
    logoImgUrlSp 法人ロゴ(スマートフォン用)です。
    prText 法人の特徴です。
    remarks その他の情報です。
    cpName 情報提供元の名称です。



    サンプルレスポンス

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

    {
      "total": 1,
      "start": 1,
      "count": 1,
      "results": [
        {
          "corporationId": 8013201017061,
          "name": "ヤフー株式会社",
          "nameKana": "やふーかぶしきがいしゃ",
          "nameEn": "Yahoo!Japan.Corporation",
          "postalCode": 1530051,
          "localGovernmentCode": 131105,
          "prefecture": "東京都",
          "city": "目黒区",
          "town": "上目黒",
          "block": "1-5-10",
          "building": "目黒マンション110号室",
          "presidentPosition": "代表取締役社長",
          "presidentName": "ヤフー太郎",
          "capital": 1000000,
          "employees": 5000,
          "establishmentDate": "2018-10-01",
          "industryCode": "A7281",
          "listed": 1,
          "stockCode": 2055,
          "averageAge": "35.0",
          "femaleRate": "25.0",
          "averageAnnualIncome": "7670",
          "paidHolidayDigestibility": "25.0",
          "turnoverRate": "2.0",
          "femaleManagerRate": "14.0",
          "handicappedEmployeeRate": "2.0",
          "averageDuration": "20.5",
          "sales": 500,
          "salesDate": "2018-10",
          "currentEarnings": -200,
          "currentEarningsDate": "2018-10",
          "branch": "札幌、八戸、石巻、東京",
          "facebookUrl": "https://ja-jp.facebook.com/oo-corp.jp",
          "twitterUrl": "https://twitter.com/oo-corp",
          "tel": "09-9999-9999",
          "webUrl": "https://oo-corp.jp",
          "logoImgUrlPc": "https://oo-corp.jp/pic/logo.jpg",
          "logoImgUrlSp": "https://oo-corp.jpp/pic/logo_smartphone.jpg",
          "prText": "◇◆◇データサイエンス界のNo.1コミュニティを目指しています◆◇◆―現在日本に1,000人程度しかいないデータサイエンティストを育成中!『世の中に求められる人材』を育成する当社で、自身のキャリアを描きませんか?",
          "remarks": "〔事業内容〕■ビッグデータ、人工知能、機械学習をはじめとするデータサイエンスに関わる教育・研修事業■データサイエンティスト育成プログラムの運営■有料職業紹介許可番号:13-ユ-308748■ビッグデータ、人工知能、機械学習に関する法人向け研修■ビッグデータ、人工知能、機械学習に関するコンサルティング〔Facebook〕https://ja-jp.facebook.com/id10.jp/",
          "cpName": "情報提供元の名前",
          "yCompanyId": "1111"
        }
      ]
    }
     



    エラー

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