企業情報取得API

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

リクエストURL

リクエストパラメータ

パラメータ	値	説明
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	設立年月日です。
industryCode	本社の業種コード（総務省 日本標準産業分類を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に共通のエラーメッセージおよびコードを返します。