退会申請
スタディサプリ進路 リファレンス

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&...
ページトップへ

サンプルクエリ

東京または千葉で数学に関連がある学校を検索(結果はスタディサプリ進路お勧め順)

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

ページトップへ

レスポンスフィールド

フィールド 説明
results    
api_version APIのバージョン 1.01
results_available クエリー条件にマッチする、検索結果の全件数 251
results_returned このXMLに含まれる検索結果の件数 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東京都港区東新橋1-2-5</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&...
ページトップへ

サンプルクエリ

数学に関する学問を検索

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

ページトップへ

レスポンスフィールド

フィールド 説明
results    
api_version APIのバージョン 1.01
results_available クエリー条件にマッチする、検索結果の全件数 251
results_returned このXMLに含まれる検索結果の件数 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&...
ページトップへ

サンプルクエリ

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

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

ページトップへ

レスポンスフィールド

フィールド 説明
results    
api_version APIのバージョン 1.01
results_available クエリー条件にマッチする、検索結果の全件数 251
results_returned このXMLに含まれる検索結果の件数 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&...
ページトップへ

サンプルクエリ

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

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

ページトップへ

レスポンスフィールド

フィールド 説明
results    
api_version APIのバージョン 1.01
results_available クエリー条件にマッチする、検索結果の全件数 251
results_returned このXMLに含まれる検索結果の件数 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 このXMLに含まれる検索結果の件数 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 このXMLに含まれる検索結果の件数 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を利用することが可能になります。

ページトップへ