2025年3月31日をもって求人APIの利用を終了いたします。
詳細はお知らせをご覧ください。
企業情報取得API
求人情報を登録している企業の情報を取得できます。
リクエストURL
JSON
https://job.yahooapis.jp/v1/furusato/company/
リクエストパラメータ
パラメータ | 値 | 説明 |
---|---|---|
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 | 上場区分です。
|
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に共通のエラーメッセージおよびコードを返します。
目次
- 求人情報取得API
- 企業情報取得API
- 住まい情報取得API
- よくある質問(FAQ)