退会申請
リクルート進学ネット リファレンス

ref

ref学校検索API

URL

ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
code 学校コード 学校に割り当てられた番号で検索します。*2 *1 （例）SC999999
name 学校名 学校名で検索します。（部分一致）（UTF-8、URLエンコーディング） *1 （例）銀座大学
kana 学校名カナ 学校名のカナで検索します。（部分一致）（UTF-8、URLエンコーディング） *1 （例）リクルート
faculty 学部名 学部名称で検索します。（部分一致）（UTF-8、URLエンコーディング） *1 （例）広告学部
department 学科名 学科名で検索します。（部分一致）（UTF-8、URLエンコーディング） *1 （例）メディア学科
pref_cd エリアコード エリアに割り当てられた番号で検索します。*2 *1 （例）13
category_cd 校種コード 校種に割り当てられた番号で検索します。*2 *1 （例）11
address 住所 住所で検索します。（部分一致）（UTF-8、URLエンコーディング） *1 （例）東京都中央区銀座8
lat 緯度 ある地点からの範囲内の学校の検索を行う場合の緯度です。 *1 (例)35.66922072646455
lng 経度 ある地点からの範囲内の学校の検索を行う場合の経度です。 *1 (例)139.7614574432373
range 検索範囲 ある地点からの範囲内の学校の検索を行う場合の検索範囲です。 1:300m,2:500m,3:1000m,4:2000m,5:3000m。デフォルト3
datum 測地系 緯度・経度の測地系を指定できます。world (世界測地系)、tokyo (日本測地系) 初期値はworld
station 駅名 駅名で検索します。（UTF-8、URLエンコーディング） *1 （例）新橋
keyword フリーワード 学校名、学校名かな、学部、学科、キャンパス名、住所、説明のフリーワード検索が可能です。（UTF-8、URLエンコーディング） *1 （例）東京 広告
subject_cd 学問コード 学問に割り当てられた番号で検索します。*2 *1 （例）a1010
work_cd 仕事コード 仕事に割り当てられた番号で検索します。*2 *1 （例）a2010
order ソート順 検索結果の並び順を指定します。 0:進学ネットおすすめ順(デフォルト）、1:距離順（位置検索をした場合のデフォルト）、2:エリア順、3:学校名五十音順
start 検索の開始位置 検索結果の何件目から出力するかを指定します。 初期値:1
count 1ページあたりの取得数 検索結果の最大出力データ数を指定します。 初期値：10、最小1、最大100
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xml または json または jsonp。
*1　いずれか最低1つが必要
*2 複数可のパラメータの指定方法
name=value1&name=value2&...、あるいはname=value1,value2&...
ページトップへ

サンプルクエリ

東京または千葉で数学に関連がある学校を検索(結果は進学ネットお勧め順)

http://webservice.recruit.co.jp/shingaku/school/v1/?key=[APIキー]&pref_cd=12&pref_cd=13&keyword=%E6%95%B0%E5%AD%A6

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

ページトップへ

レスポンスフィールド

フィールド 説明 例
results    
api_version APIのバージョン 1.01
results_available クエリー条件にマッチする、検索結果の全件数 251
results_returned このＸＭＬに含まれる検索結果の件数 10
results_start 検索結果の開始位置 1
school [複数要素]
code 学校コード SC999999
name 学校名 リクルート大学
kana 学校名カナ リクルートダイガク
campus 所在地 [複数要素]
name キャンパス名 本部所在地
address 住所 〒105-0021東京都港区東新橋1-2-5
datum 測地系 tokyo
latitude 緯度(一部登録されていないキャンバスがあります。その場合は0がレスポンスされます) 35.049349
longitude 経度(一部登録されていないキャンバスがあります。その場合は0がレスポンスされます) 137.05293
station 駅名 新橋
category
code 校種コード 0011
name 校種 国立大学
faculty 学部 [複数要素]
name 学部名 工芸学部
department 学科コース 芸術・表現行動学科
pref
code エリアコード 13
name エリア名 東京
urls
mobile 携帯URL
pc URL
qr QRコード
画像サイズ等の変更方法はこちら
ページトップへ

サンプルレスポンス

<?xml version="1.0" encoding="utf-8"?>
<results xmlns="http://webservice.recruit.co.jp/shingaku/">
	<api_version>1.00</api_version>
	<results_available>1</results_available>
	<results_returned>1</results_returned>
	<results_start>1</results_start>
	<school>
		<code>SC999999</code>
		<name>リクルート大学</name>
		<kana>リクルートダイガク</kana>
		<campus>
			<name>本部所在地</name>
			<address>〒105-0021東京都港区東新橋１－２－５</address>
			<datum>world</datum>
			<latitude>35.7187301383</latitude>
			<longitude>139.7325561977</longitude>
			<station>新橋</station>
		</campus>
		<category>
			<code>0011</code>
			<name>国立大学</name>
		</category>
		<faculty>
			<department>食物栄養学科</department>
			<department>人間・環境科学科</department>
			<department>人間生活学科</department>
			<name>生活科学部</name>
		</faculty>
		<faculty>
			(以下学部分繰り返し）
		</faculty>
		<pref>
			<code>13</code>
			<name>東京</name>
		</pref>
		<urls>
			<mobile>http://shingakunet.com/m/...</mobile>
			<pc>http://shingakunet.com/...</pc>
			<qr>http://webservice.recruit.co.jp/common/...</qr>
		</urls>
	</school>
</results>
ページトップへ

ref

ref学問検索API

URL

ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
code 学問コード 学問に割り当てられた番号で検索します。*2 *1 （例）a1010
keyword フリーワード 学問名や説明文などのフリーワード検索が可能です。（UTF-8、URLエンコーディング） *1 （例）東京 広告
start 検索の開始位置 検索結果の何件目から出力するかを指定します。 初期値:1
count 1ページあたりの取得数 検索結果の最大出力データ数を指定します。 初期値：10、最小1、最大100
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xml または json または jsonp。
*1　いずれか最低1つが必要
*2 複数可のパラメータの指定方法
name=value1&name=value2&...、あるいはname=value1,value2&...
ページトップへ

サンプルクエリ

数学に関する学問を検索

http://webservice.recruit.co.jp/shingaku/subject/v1/?key=[APIキー]&keyword=%E6%95%B0%E5%AD%A6

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

ページトップへ

レスポンスフィールド

フィールド 説明 例
results    
api_version APIのバージョン 1.01
results_available クエリー条件にマッチする、検索結果の全件数 251
results_returned このＸＭＬに含まれる検索結果の件数 10
results_start 検索結果の開始位置 1
subject [複数要素]
code 学問コード a1050
name 学問名 日本文化学
desc 説明 日本独自の文化について研究する
license [複数要素]
code 資格コード v0530
name 資格名 葬祭ディレクター
work [複数要素]
code 仕事コード q1020
name 仕事名 中学校教諭
urls
mobile 携帯URL
pc URL
qr QRコード
画像サイズ等の変更方法はこちら
ページトップへ

サンプルレスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<results xmlns="http://webservice.recruit.co.jp/shingaku/"><api_version>1.00</api_version>
	<results_available>1</results_available>
	<results_returned>1</results_returned>
	<results_start>1</results_start>
	<subject>
		<code>a1050</code>
		<name>日本文化学</name>
		<desc>日本独自の文化について研究する</desc>
		<license>
			<code>v0530</code>
			<name>葬祭ディレクター</name>
		</license>
		<license>
			（該当件数分くりかえし）
		</license>
		<work>
			<code>q1020</code>
			<name>中学校教諭</name>
		</work>
		<work>
			（該当件数分繰り返し）
		</work>
		<urls>
			<mobile>http://shingakunet.com/m/...</mobile>
			<pc>http://shingakunet.com/...</pc>
			<qr>http://webservice.recruit.co.jp/...</qr>
		</urls>
	</subject>
</results>
ページトップへ

ref

ref仕事検索API

URL

ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
code 仕事コード 仕事に割り当てられた番号で検索します。*2 *1 （例）a1010
keyword フリーワード 仕事名や説明文などのフリーワード検索が可能です。（UTF-8、URLエンコーディング） *1 （例）東京 広告
start 検索の開始位置 検索結果の何件目から出力するかを指定します。 初期値:1
count 1ページあたりの取得数 検索結果の最大出力データ数を指定します。 初期値：10、最小1、最大100
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xml または json または jsonp。
*1　いずれか最低1つが必要
*2 複数可のパラメータの指定方法
name=value1&name=value2&...、あるいはname=value1,value2&...
ページトップへ

サンプルクエリ

財務に関連がある仕事を検索

http://webservice.recruit.co.jp/shingaku/work/v1/?key=[APIキー]&keyword=%E8%B2%A1%E5%8B%99

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

ページトップへ

レスポンスフィールド

フィールド 説明 例
results    
api_version APIのバージョン 1.01
results_available クエリー条件にマッチする、検索結果の全件数 251
results_returned このＸＭＬに含まれる検索結果の件数 10
results_start 検索結果の開始位置 1
work [複数要素]
code 仕事コード a1050
name 仕事名 刑務官
desc 説明 服役中の人たちの生活指導や職業訓練にあたる
license [複数要素]
code 資格コード v0020
name 資格名 刑務官＜国＞
subject [複数要素]
code 学問コード b1010
name 学問名 法学
urls
mobile 携帯URL
pc URL
qr QRコード
画像サイズ等の変更方法はこちら
ページトップへ

サンプルレスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<results xmlns="http://webservice.recruit.co.jp/shingaku/"><api_version>1.00</api_version>
	<results_available>1</results_available>
	<results_returned>1</results_returned>
	<results_start>1</results_start>
	<work>
		<code>a1050</code>
		<name>刑務官</name>
		<desc>服役中の人たちの生活指導や職業訓練にあたる</desc>
		<license>
			<code>v0020</code>
			<name>刑務官＜国＞</name>
		</license>
		<license>
			（該当件数分繰り返し）
		</license>
		<subject>
			<code>b1010</code>
			<name>法学</name>
		</subject>
		<subject>
			（該当件数分繰り返し）
		</subject>
		<urls>
			<mobile>http://shingakunet.com/m/...</mobile>
			<pc>http://shingakunet.com/...</pc>
			<qr>http://webservice.recruit.co.jp/common/...</qr>
		</urls>
	</work>
</results>
ページトップへ

ref

ref資格検索API

URL

ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
code 資格コード 資格に割り当てられた番号で検索します。*2 *1 （例）a1010
keyword フリーワード 資格名や説明文などのフリーワード検索が可能です。（UTF-8、URLエンコーディング） *1 （例）東京 広告
start 検索の開始位置 検索結果の何件目から出力するかを指定します。 初期値:1
count 1ページあたりの取得数 検索結果の最大出力データ数を指定します。 初期値：10、最小1、最大100
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xml または json または jsonp。
*1　いずれか最低1つが必要
*2 複数可のパラメータの指定方法
name=value1&name=value2&...、あるいはname=value1,value2&...
ページトップへ

サンプルクエリ

数学に関連がある資格を検索

http://webservice.recruit.co.jp/shingaku/license/v1/?key=[APIキー]&keyword=%E6%95%B0%E5%AD%A6

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

ページトップへ

レスポンスフィールド

フィールド 説明 例
results    
api_version APIのバージョン 1.01
results_available クエリー条件にマッチする、検索結果の全件数 251
results_returned このＸＭＬに含まれる検索結果の件数 10
results_start 検索結果の開始位置 1
license [複数要素]
code 資格コード v5402
name 資格名 児童福祉司任用資格
desc 説明 児童の保護や福祉に携わる児童福祉司になるための資格
subject [複数要素]
code 学問コード c1010
name 学問名 社会学
work [複数要素]
code 仕事コード a1020
name 仕事名 地方公務員
urls
mobile 携帯URL
pc URL
qr QRコード
画像サイズ等の変更方法はこちら
ページトップへ

サンプルレスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<results xmlns="http://webservice.recruit.co.jp/shingaku/">
	<api_version>1.00</api_version>
	<license>
		<code>v5402</code>
		<name>児童福祉司任用資格</name>
		<desc>児童の保護や福祉に携わる児童福祉司になるための資格</desc>
		<subject>
			<code>c1010</code>
			<name>社会学</name>
		</subject>
		<subject>
			（該当件数分繰り返し）
		</subject>
		<work>
			<code>a1020</code>
			<name>地方公務員</name>
		</work>
		<work>
			（該当件数分繰り返し）
		</work>
		<urls>
			<mobile>http://shingakunet.com/m/...</mobile>
			<pc>http://shingakunet.com/...</pc>
			<qr>http://webservice.recruit.co.jp/...</qr>
		</urls>
	</license>
	<results_available>1</results_available>
	<results_returned>1</results_returned>
	<results_start>1</results_start>
</results>
ページトップへ

ref

refエリアマスタAPI

リクエストURL

ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xmlまたはjsonまたはjsonp
ページトップへ

レスポンスフィールド

フィールド 説明 例
results    
api_version APIのバージョン 1.00
results_available クエリー条件にマッチする、検索結果の全件数 47
results_returned このＸＭＬに含まれる検索結果の件数 47
results_start 検索結果の開始位置 1
pref [複数要素]
code エリアコード 13
name エリア名 東京
ページトップへ

ref

ref校種マスタAPI

リクエストURL

ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xmlまたはjsonまたはjsonp
ページトップへ

レスポンスフィールド

フィールド 説明 例
results    
api_version APIのバージョン 1.00
results_available クエリー条件にマッチする、検索結果の全件数 7
results_returned このＸＭＬに含まれる検索結果の件数 7
results_start 検索結果の開始位置 1
category [複数要素]
code 校種コード 0011
name 校種テキスト 国立大学
ページトップへ

ref

refエラー時のレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns="http://webservice.recruit.co.jp/shingaku/">
  <api_version>1.00</api_version>
  <error>
    <message>keyは必須パラメーターです</message>
  </error>
</results>

エラーの際でも、HTTPレスポンスステータスは常に "200 OK" が返ります。なので実装側では常にレスポンスXMLの内容を見てエラー判断を行ってください。

ページトップへ


ref

refFlashからの利用方法

Flash Action Script 2.0にて本APIを利用するには1フレーム目に下記の記述を追加する必要があります:

System.security.loadPolicyFile("http://webservice.recruit.co.jp/shingaku/crossdomain.xml");

このように crossdomain.xml を指定する事で、ご自身のサイト上にある Flash SWF ファイルから、本APIを利用することが可能になります。

ページトップへ