ケイコとナマブ & 資格と仕事 Webサービスを使うことで、ケイコとマナブ.net 及び 資格と仕事.netに掲載されている、学校情報、イベント情報にアクセスして、アプリケーションを構築することができます。
スクール（拠点）検索API
ケイコとマナブ.net、資格と仕事.netに掲載中のスクール情報から複数の軸での検索が可能です。
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| code | 拠点CD | 拠点毎のコード 。複数指定可能*2 | *1 | (例) 1234567890 |
| school | スクールCD | スクール毎のコード 。複数指定可能*2 | *1 | (例) S000000 |
| site | サイト区分 | サイト別に絞り込む事ができます。 KN:ケイコとマナブ.net SS:資格と仕事.net |
*1 | (例) KN |
| category | カテゴリコード | カテゴリマスタAPI参照。複数指定可能*2 特殊記法で AND 絞り込みも可 |
*1 | (例) G010005 |
| capsule | カプセルコード | カプセルマスタAPI参照。複数指定可能*2 特殊記法で AND 絞り込みも可 |
*1 | (例) G020015 |
| special | 特集コード | 特集マスタAPI参照。複数指定可能*2 特殊記法で AND 絞り込みも可 |
*1 | (例) K200001 |
| area | エリアコード | エリア(版)マスタAPI参照。複数指定可能*2 | *1 | (例) N1 |
| prefecture | 都道府県コード | 都道府県マスタAPI参照。複数指定可能*2 | *1 | (例) 13 |
| along | 沿線コード | 沿線マスタAPI参照。複数指定可能*2 | *1 | (例) 2720 |
| station | 駅コード | 駅で絞り込む。駅マスタAPI参照。複数指定可能*2 | *1 | (例) 2720111 |
| tel | 電話番号 | 前方一致、ハイフンなしで指定。複数指定可能*2 | *1 | 例:0300001000 |
| zip | 郵便番号 | 前方一致、ハイフンなしで指定。複数指定可能*2 | *1 | 例:23100 |
| wday | 拠点営業曜日 | 該当の拠点が営業している曜日の指定。1:月曜日〜7:日曜日。複数指定可能*2 | *1 | 例:1 |
| open_time_from | 営業時間 from | 営業時間が～時から | *1 | (例) 1000 |
| open_time_to | 営業時間 to | 営業時間が～時まで | *1 | (例) 1600 |
| lat | 緯度 | ある地点からの範囲内のスクールの検索を行う場合の緯度です。 | *1 | 例:35.222 |
| lng | 経度 | ある地点からの範囲内のスクールの検索を行う場合の経度です。 | *1 | 例:135.45 |
| range | 距離 | ある地点からの範囲内のスクールの検索を行う場合の範囲を5段階で指定できます。たとえば1km以内の検索ならrange=1を指定します | 1: 1km 2: 2km 3: 5km (初期値) 4: 10km 5: 20km 例:1 |
|
| datum | 測地系 | 緯度・経度の測地系を指定できます。world: 世界測地系、tokyo: 旧日本測地系。初期値は world | 例:world | |
| keyword | フリーワード | 文字コードはUTF8。半角スペース区切りの文字列を渡すことでAND検索になる。複数指定可能*2。 別途クエリ項目 kwic=1 を指定する事で Keyword In Context 機能も利用可能 (詳細はこちらを参照)。 フリーワードを指定して、かつ並び順 order に何も指定しない場合、検索結果は「フリーワードマッチ順」でソートされます。 |
*1 | 例: ネイル |
| keyword_or | フリーワード(OR検索) | 文字コードはUTF8。半角スペース区切りの文字列 (最大5単語まで) を渡すことでOR検索になる。上記フリーワード (keyword) 指定がある場合、こちらは無視される。複数指定可能*2。 別途クエリ項目 kwic=1 を指定する事で Keyword In Context 機能も利用可能 (詳細はこちらを参照)。 フリーワードを指定して、かつ並び順 order に何も指定しない場合、検索結果は「フリーワードマッチ順」でソートされます。 |
*1 | 例: ネイル パソコン |
| kwic | KWICレスポンス設定 | クエリ項目「フリーワード」を利用の際、追加でこの kwic に値 1 を指定する事で API レスポンスに KWIC コンテンツを追加させる事ができます (詳細はこちらを参照) 。 | 例:1 | |
| order | ソート順 | 検索結果の並び順を指定します。 ・緯度経度を指定して検索すると、近い順にソートされます ・検索クエリ項目「フリーワード」を指定しつつ、この order に何も指定をしなかった場合は自動的に「フリーワードマッチ順」でソートされます。 |
0:おすすめ順(デフォルト)、1:距離順(緯度経度指定の場合のみ): | |
| type | 情報量 | lite:一覧表示に必要な項目のみレスポンスします。(デフォルト) full:すべての項目をレスポンスします。 |
初期値:lite | |
| 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,...
個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
サンプルクエリ
都道府県コード(13)で絞り込む
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.00 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 251 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 10 |
| results_start | 検索結果の開始位置 | 1 |
| school_kyoten | スクール(拠点)情報 [複数要素] | |
| code | 拠点CD | 0005853874 |
| name | 拠点名 | 渋谷校 |
| name_kana | 拠点名カナ(type=liteのときはレスポンスされません) | シブヤコウ |
| school_cd | スクールCD | S000001 |
| school_name | スクール名 | 笑む丁江るアカデミー |
| school_name_kana | スクール名カナ(type=liteのときはレスポンスされません) | エムティーエルアカデミー |
| site | サイト区分 KN:ケイコとマナブ.net、SS:資格と仕事.net | KN |
| urls | スクール(拠点)の詳細ページのURL | |
| pc | パソコンのブラウザ用ページのURL | http://keikotomanabu............ |
| mobile | 携帯のブラウザ用ページのURL | http://keikotomanabu....... |
| qr | QRコード表示用のURL | http://keikotomanabu............ |
| prefecture | 都道府県 | |
| code | 都道府県コード | 13 |
| name | 都道府県名 | 東京都 |
| area | エリア | |
| code | エリアコード | N1 |
| name | エリア名 | 関東 |
| zip | 郵便番号 | 231-0821 |
| address | 住所 | 東京都中央区銀座8-4-17 |
| station | 駅 [複数要素] | |
| code | 駅コード | 2720123 |
| name | 駅名 | 東京 |
| along | 沿線 [複数要素] | |
| code | 沿線コード | 2729 |
| name | 沿線名 | 東海道線 |
| lat | 経度（測地系は検索時に指定したもの） | 35.6571138133 |
| lng | 緯度（測地系は検索時に指定したもの） | 139.7555103391 |
| lat_center | 地図表示する際の中心経度（測地系は検索時に指定したもの） | 35.6571138133 |
| lng_center | 地図表示する際の中心緯度（測地系は検索時に指定したもの） | 139.7555103391 |
| zoom | 地図表示する際のズームレベル | 10 |
| access | アクセス | 銀座駅徒歩10分 |
| wday | 営業曜日営業している曜日をカンマ(、)区切りの文字列でレスポンス | 月、火、金 |
| open_time | 営業開始時刻 | 9:00 |
| close_time | 営業終了時刻 | 21:00 |
| time_ext | 営業時間備考(type=liteのときはレスポンスされません) | 祝日の営業終了は18:00 |
| pr_catch | キャッチコピー | 大好きを仕事にしよう |
| pr | PRテキスト | 素晴らしい体験がまっています。 |
| capsule | カプセル[複数要素] (type=liteのときはレスポンスされません) | |
| code | カプセルコード | G010020 |
| name | カプセル名 | ファッション・ビューティー |
| category | カテゴリ | |
| code | カテゴリコード | G020020 |
| name | カテゴリ名 | エステ･美容 |
| summary | サマリー情報 | |
| capsule | カプセルのサマリー。全角カンマ区切りなので、長すぎる際は任意に加工してください。 | ワード、エクセル |
| kouza | 講座[複数要素] 最大２講座、スクールにひもづく講座が日替わりランダムでレスポンス | |
| code | 講座コード | 1234567890 |
| name | 講座名称 | 英会話５００時間 |
| content | 内容 | あきらめずに最後まで勉強できます |
イベント検索API
ケイコとマナブ.net、資格と仕事netに掲載中の体験レッスン・説明会情報から複数の軸での検索が可能です
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| code | イベントID | イベント毎のID。複数指定可能*2 | *1 | (例) 0000205761 |
| event_type | イベント種別コード | イベント種別の絞り込み。01: 体験、02: カウンセリング、03: セミナー、04: 説明会、05: 見学、指定なし: すべて (default)。複数指定可能*2 | *1 | (例) 01 |
| school_kyoten | 拠点CD | 拠点毎のコード。複数指定可能*2 | *1 | (例) 0005853874 |
| school | スクールCD | スクール毎のコード。複数指定可能*2 | *1 | (例) S000000 |
| site | サイト区分 | サイト別に絞り込む事ができます。 KN:ケイコとマナブ.net SS:資格と仕事.net |
*1 | (例) KN |
| category | カテゴリコード | カテゴリマスタAPI参照。複数指定可能*2 特殊記法で AND 絞り込みも可 |
*1 | (例) G010005 |
| area | エリアコード | エリア(版)マスタAPI参照。複数指定可能*2 | *1 | (例) N1 |
| prefecture | 都道府県コード | 都道府県マスタAPI参照。複数指定可能*2 | *1 | (例) 13 |
| along | 沿線コード | 沿線マスタAPI参照。複数指定可能*2 | *1 | (例) 1304 |
| station | 駅コード | 駅で絞り込む。駅マスタAPI参照。複数指定可能*2 | *1 | (例) 1727123 |
| tel | 電話番号 | 前方一致、ハイフンなしで指定。複数指定可能*2 | *1 | 例:0300001000 |
| zip | 郵便番号 | 前方一致、ハイフンなしで指定。複数指定可能*2 | *1 | 例:23100 |
| lat | 緯度 | ある地点からの範囲内のスクールの検索を行う場合の緯度です。 | *1 | 例:35.222 |
| lng | 経度 | ある地点からの範囲内のスクールの検索を行う場合の経度です。 | *1 | 例:135.45 |
| range | 距離 | ある地点からの範囲内のスクールの検索を行う場合の範囲を5段階で指定できます。たとえば1km以内の検索ならrange=1を指定します | 1: 1km 2: 2km 3: 5km (初期値) 4: 10km 5: 20km 例:1 |
|
| datum | 測地系 | 緯度・経度の測地系を指定できます。world: 世界測地系、tokyo: 旧日本測地系。初期値は world | 例:world | |
| start_time_from | 開始時間 from | 開始時間が～時から | *1 | (例) 1000 |
| start_time_to | 開始時間 to | 開始時間が～時まで | *1 | (例) 1600 |
| wday | 曜日指定 | 開催曜日の指定。 1: 月曜日～7: 日曜日 | *1 | (例) 1 |
| ymd_from | 開催日 from | 開催日が～から (年月日) | *1 | (例) 20080710 |
| ymd_to | 開催日 to | 開催日が～まで (年月日) | *1 | (例) 20080716 |
| event_times_from | 回数 from | 回数が～から | *1 | (例) 2 |
| event_times_to | 回数 to | 回数が～まで | *1 | (例) 7 |
| price | 費用 | 費用をコードで指定できます。複数指定可能*2 | *1 | 0:指定なし(デフォルト)、1:無料、2:〜1000円未満、3:1000円〜3000円未満、4:3000円～ |
| reserve | 日時予約可フラグ | 日時予約ができる場合はreserve=1として、リクエストします | *1 | (例) 0:指定なし(デフォルト)、1:日時予約できる、2:日時予約できない |
| request_reserve | リクエスト予約可フラグ | リクエスト予約ができる場合はrequest_reserve=1として、リクエストします | *1 | (例) 0:指定なし(デフォルト)、1:リクエスト予約できる、2:リクエスト予約できない |
| keyword | フリーワード | 文字コードはUTF8。半角スペース区切りの文字列を渡すことでAND検索になる。複数指定可能*2。 別途クエリ項目 kwic=1 を指定する事で Keyword In Context 機能も利用可能 (詳細はこちらを参照)。 フリーワードを指定して、かつ並び順 order に何も指定しない場合、検索結果は「フリーワードマッチ順」でソートされます。 |
*1 | 例: ネイル |
| keyword_or | フリーワード(OR検索) | 文字コードはUTF8。半角スペース区切りの文字列 (最大5単語まで) を渡すことでOR検索になる。上記フリーワード (keyword) 指定がある場合、こちらは無視される。複数指定可能*2。 別途クエリ項目 kwic=1 を指定する事で Keyword In Context 機能も利用可能 (詳細はこちらを参照)。 フリーワードを指定して、かつ並び順 order に何も指定しない場合、検索結果は「フリーワードマッチ順」でソートされます。 |
*1 | 例: ネイル パソコン |
| kwic | KWICレスポンス設定 | クエリ項目「フリーワード」を利用の際、追加でこの kwic に値 1 を指定する事で API レスポンスに KWIC コンテンツを追加させる事ができます (詳細はこちらを参照) 。 | 例:1 | |
| order | ソート順 | 検索結果の並び順を指定します。 ・緯度経度を指定して検索すると、近い順にソートされます ・検索クエリ項目「フリーワード」を指定しつつ、この order に何も指定をしなかった場合は自動的に「フリーワードマッチ順」でソートされます 。 |
0:おすすめ順(デフォルト)、1:距離順(緯度経度指定の場合のみ): | |
| type | 情報量 | lite:一覧表示に必要な項目のみレスポンスします。(デフォルト) full:すべての項目をレスポンスします。 |
初期値:lite | |
| 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,...
個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
サンプルクエリ
都道府県コード（13）で絞り込む
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| event | イベント [複数要素] | |
| event_type | イベント種別 | |
| code | イベント種別コード | 01 |
| name | イベント種別名 | 体験 |
| code | イベントID | 0001234567 |
| site | サイト区分 | KN |
| name | イベント名 | 今、大人気のプリザーブドフラワー会社帰りはプリザでリフレッシュ！ |
| category | カテゴリ | |
| code | カテゴリコード | G020020 |
| name | カテゴリ名 | エステ･美容 |
| summary | サマリー情報 | |
| date | 開催日。同上 | 8/5(火)、8/6(水)、8/7(木)... |
| event_times | 講座回数 | 1 |
| price | 金額 | 3800 |
| time | 1回当たりの時間 | 90分 |
| content | イベント内容 | プリザって難しそうと思っている方のための、プリザーブドフラワーアレンジメントレッスン。生花にはない青い... |
| urls | 詳細ページへのURL | |
| mobile | リンク先URL (携帯) | http://.../ |
| pc | リンク先URL (PC) | http://.../..._CD=0000376015 |
| qr | リンク先URL (QRコード) | http://.../common/qr?url= |
| school_kyoten | スクール(拠点) | |
| code | 拠点CD | 0001234567 |
| name | 拠点名 | 原宿校 |
| name_kana | 拠点名カナ | ハラジュクコウ |
| school_cd | スクールCD | S000000 |
| school_name | スクール名 | MTL |
| school_name_kana | スクール名カナ | エムティエル |
| prefecture | 都道府県 | |
| code | 都道府県コード | 13 |
| name | 都道府県名 | 東京都 |
| area | エリア | |
| code | エリアコード | N1 |
| name | エリア名 | 関東 |
| zip | 郵便番号 | 231-0821 |
| address | 住所 | 東京都中央区銀座8-4-17 |
| station | 駅 [複数要素] | |
| code | 駅コード | 1323123 |
| name | 駅名 | 東京 |
| along | 沿線 [複数要素] | |
| code | 沿線コード | 1232 |
| name | 沿線名 | 東海道線 |
| lat | 経度（測地系は検索時に指定したもの） | 35.6571138133 |
| lng | 緯度（測地系は検索時に指定したもの） | 139.7555103391 |
| access | アクセス | 銀座駅徒歩10分 |
| calendar | 予約枠日時[複数要素] (type=liteのときはレスポンスされません) | |
| datetime | 日時 | 2010-08-09T23:00:00 |
| text | 文字表示 | 11月11日（水） 14:50～ |
| reserve | 日時予約可フラグ 。日時予約ができる場合は1となる | 0 |
| request_reserve | リクエスト予約可能フラグ 。リクエスト予約ができる場合は1となる | 0 |
講座検索API
ケイコとマナブ.net、資格と仕事netに掲載中の講座・レッスン情報から複数の軸での検索が可能です。講座は開催拠点が異なれば、内容が同じであっても、別の講座コードを持ちます
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| code | 講座CD | 講座毎のコード。複数指定可能*2 | *1 | (例) 0020000367 |
| school_kyoten | 拠点CD | 拠点毎のコード。複数指定可能*2 | *1 | (例) 0005853874 |
| school | スクールCD | スクール毎のコード。複数指定可能*2 | *1 | (例) S000000 |
| site | サイト区分 | サイト別に絞り込む事ができます。 KN:ケイコとマナブ.net SS:資格と仕事.net |
*1 | (例) KN |
| ss_type | 仕事/資格の区別 | サイト区分がSSのデータを対象に、仕事／資格を区別して絞り込むことができます。 SK:資格 SG:仕事 |
*1 | (例) SK |
| category | カテゴリコード | カテゴリマスタAPI参照。複数指定可能*2 特殊記法で AND 絞り込みも可 |
*1 | (例) G010005 |
| capsule | カプセルコード | カプセルマスタAPI参照。複数指定可能*2 特殊記法で AND 絞り込みも可 |
*1 | (例) G020015 |
| special | 特集コード | 特集マスタAPI参照。複数指定可能*2 特殊記法で AND 絞り込みも可 |
*1 | (例) K010001 |
| area | エリアコード | エリア(版)マスタAPI参照。複数指定可能*2 | *1 | (例) N1 |
| prefecture | 都道府県コード | 都道府県マスタAPI参照。複数指定可能*2 | *1 | (例) 13 |
| along | 沿線コード | 沿線マスタAPI参照。複数指定可能*2 | *1 | (例) 3040 |
| station | 駅コード | 駅で絞り込む。駅マスタAPI参照。複数指定可能*2 | *1 | (例) 1727123 |
| tel | 電話番号 | 前方一致、ハイフンなしで指定。複数指定可能*2 | *1 | 例:0300001000 |
| zip | 郵便番号 | 前方一致、ハイフンなしで指定。複数指定可能*2 | *1 | 例:23100 |
| wday | 曜日指定 | 開催曜日の指定。 1: 月曜日～7: 日曜日。複数指定可能*2 | *1 | (例) 1 |
| start_time | 開講時間帯 | 開講時間帯をコードで指定できます。複数指定可能*2 | *1 | 0:指定なし(デフォルト) 1:朝（～9：55）2:昼（10：00～15：55）3:夕方（16:00～17:55）4:夜(18:00～） |
| price | 費用 | 費用をコードで指定できます。複数指定可能*2 | *1 | 0:指定なし(デフォルト)、1:〜1万円未満、2:1万〜3万円未満、3:3万〜5万円未満、4:5万～10万円未満、5:10万～30万円未満、6:30万～50万円未満、7:50万円〜 |
| term | 期間 | 期間をコードで指定できます。複数指定可能*2 | *1 | 0:指定なし(デフォルト)、1:１カ月未満、2:１～３カ月未満、3:３～６カ月未満、4:６カ月～ |
| kodaw | こだわりCD | こだわりコード。こだわりマスタAPI参照。複数指定可能*2 特殊記法で AND 絞り込みも可 |
*1 | (例) 00000 |
| request | 資料請求可能フラグ | 資料請求できる講座で絞り込めます。0:指定なし:絞り込まない。(デフォルト) 1:資料請求できる講座のみ | *1 | (例) 1 |
| lat | 緯度 | ある地点からの範囲内のスクールの検索を行う場合の緯度です。 | *1 | 例:35.222 |
| lng | 経度 | ある地点からの範囲内のスクールの検索を行う場合の経度です。 | *1 | 例:135.45 |
| range | 距離 | ある地点からの範囲内のスクールの検索を行う場合の範囲を5段階で指定できます。たとえば1km以内の検索ならrange=1を指定します | 1: 1km 2: 2km 3: 5km (初期値) 4: 10km 5: 20km 例:1 |
|
| datum | 測地系 | 緯度・経度の測地系を指定できます。world: 世界測地系、tokyo: 旧日本測地系。初期値は world | 例:world | |
| keyword | フリーワード | 文字コードはUTF8。半角スペース区切りの文字列を渡すことでAND検索になる。複数指定可能*2。 別途クエリ項目 kwic=1 を指定する事で Keyword In Context 機能も利用可能 (詳細はこちらを参照)。 フリーワードを指定して、かつ並び順 order に何も指定しない場合、検索結果は「フリーワードマッチ順」でソートされます。 |
*1 | 例: ネイル |
| keyword_or | フリーワード(OR検索) | 文字コードはUTF8。半角スペース区切りの文字列 (最大5単語まで) を渡すことでOR検索になる。上記フリーワード (keyword) 指定がある場合、こちらは無視される。複数指定可能*2。 別途クエリ項目 kwic=1 を指定する事で Keyword In Context 機能も利用可能 (詳細はこちらを参照)。 フリーワードを指定して、かつ並び順 order に何も指定しない場合、検索結果は「フリーワードマッチ順」でソートされます。 |
*1 | 例: ネイル パソコン |
| kwic | KWICレスポンス設定 | クエリ項目「フリーワード」を利用の際、追加でこの kwic に値 1 を指定する事で API レスポンスに KWIC コンテンツを追加させる事ができます (詳細はこちらを参照) 。 | 例:1 | |
| order | ソート順 | 検索結果の並び順を指定します。 ・緯度経度を指定して検索すると、近い順にソートされます ・検索クエリ項目「フリーワード」を指定しつつ、この order に何も指定をしなかった場合は自動的に「フリーワードマッチ順」でソートされます 。 |
0:おすすめ順(デフォルト)、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,...
個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
サンプルクエリ
都道府県コード（13）で絞り込む
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| kouza | 講座 [複数要素] | |
| code | 講座コード | 0102030405 |
| name | 講座名 | プロネイリスト導入コース/検定3級対応 |
| site | サイト区分 | KN |
| ss_type | 資格／仕事の区分 | |
| code | 資格／仕事の区分コード | SG |
| name | 資格／仕事の区分名 | 仕事 |
| summary | サマリー情報 | |
| station | 最寄り駅のサマリー。全角カンマ区切りなので、長すぎる際は任意に加工してください。 | 新宿、渋谷 |
| wday | 開講曜日。曜日を全角カンマ区切りの文字列でレスポンスします | 月、火、日 |
| price | 費用 | ［入］0円 ［受］35万7000円 ［他］6万3000円(教材費) |
| season | 開講時期 | 入学随時 |
| term_times | 期間・回数 | 約10ヶ月 全25回 |
| hours | 開講時間 | 100時間 |
| time | 1回あたりの受講時間 | 1時間 |
| content | 内容 | プリザって難しそうと思っている方のための、プリザーブドフラワーアレンジメントレッスン。生花にはない青い... |
| capsule | カプセル | |
| code | カプセルコード | G010020 |
| name | カプセル名 | ファッション・ビューティー |
| category | カテゴリ | |
| code | カテゴリコード | G020020 |
| name | カテゴリ名 | エステ･美容 |
| request | 資料請求可能フラグ 。資料請求できる場合は1となる | 0 |
| urls | 詳細ページへのURL | |
| mobile | リンク先URL (携帯) | http://.../ |
| pc | リンク先URL (PC) | http://.../..._CD=0000376015 |
| qr | リンク先URL (QRコード) | http://.../common/qr?url= |
| school_kyoten | スクール(拠点) | |
| code | 拠点CD | 0001234567 |
| name | 拠点名 | 原宿校 |
| name_kana | 拠点名カナ | ハラジュクコウ |
| school_cd | スクールCD | S00000 |
| school_name | スクール名 | MTL |
| school_name_kana | スクール名カナ | エムティエル |
| prefecture | 都道府県 | |
| code | 都道府県コード | 13 |
| name | 都道府県名 | 東京都 |
| area | エリア | |
| code | エリアコード | N1 |
| name | エリア名 | 関東 |
| zip | 郵便番号 | 231-0821 |
| address | 住所 | 東京都中央区銀座8-4-17 |
| station | 駅 [複数要素] | |
| code | 駅コード | 1312123 |
| name | 駅名 | 東京 |
| along | 沿線 [複数要素] | |
| code | 沿線コード | 1111 |
| name | 沿線名 | 東海道線 |
| lat | 経度（測地系は検索時に指定したもの） | 35.6571138133 |
| lng | 緯度（測地系は検索時に指定したもの） | 139.7555103391 |
| access | アクセス | 銀座駅徒歩10分 |
こだわりマスタ API
講座の特徴一覧を取得できます。全件をレスポンスします
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| format | レスポンス形式 | レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 | 初期値:xml。xmlまたはjsonまたはjsonp |
サンプルクエリ
こだわり一覧を取得
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| kodaw | こだわり(特徴) [複数要素] | |
| code | こだわりコード | 00010 |
| name | こだわり名称 | 駅から５分以内 |
都道府県マスタAPI
都道府県の一覧を取得できます。
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| prefecture | 都道府県 | 都道府県毎のコード。複数指定可能*1 | (例) 13 | |
| area | エリアコード | エリア毎のコード。複数指定可能*1 | (例) N1 | |
| keyword | キーワード | フリーワード | (例) 東京都 | |
| start | 検索の開始位置 | 検索結果の何件目から出力するかを指定します。 | 初期値:1 | |
| count | 1ページあたりの取得数 | 検索結果の最大出力データ数を指定します。 | 初期値：10、最小1、最大100 | |
| format | レスポンス形式 | レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 | 初期値:xml。xmlまたはjsonまたはjsonp |
- *1：複数可のパラメータの指定方法
name=value1&name=value2&...または name=value1,value2,...
個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
サンプルクエリ
都道府県一覧を取得
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| prefecture | 都道府県 [複数要素] | |
| code | 都道府県コード | 13 |
| name | 都道府県名 | 東京都 |
| area | エリア | |
| code | エリアコード | N1 |
| name | エリア名 | 関東 |
エリア(版)マスタ API
エリア(版)の一覧を取得できます。全件をレスポンスします
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| format | レスポンス形式 | レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 | 初期値:xml。xmlまたはjsonまたはjsonp |
サンプルクエリ
エリア一覧を取得
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| area | エリア [複数要素] | |
| code | エリアコード | N1 |
| name | エリア名 | 関東 |
沿線マスタ API
沿線の一覧を取得できます。
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| along | 沿線コード | 沿線毎のコード。複数指定可能*1 | (例) XXXXXX | |
| along_type | 沿線タイプコード | 沿線タイプ毎のコード。複数指定可能*1 | (例) XXXX | |
| prefecture | 都道府県 | 都道府県毎のコード。複数指定可能*1 | (例) 13 | |
| keyword | キーワード | フリーワード | (例) 東海道 | |
| start | 検索の開始位置 | 検索結果の何件目から出力するかを指定します。 | 初期値:1 | |
| count | 1ページあたりの取得数 | 検索結果の最大出力データ数を指定します。 | 初期値：10、最小1、最大100 | |
| format | レスポンス形式 | レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 | 初期値:xml。xmlまたはjsonまたはjsonp |
- *1：複数可のパラメータの指定方法
name=value1&name=value2&...または name=value1,value2,...
個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
サンプルクエリ
沿線一覧を取得
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| along | 沿線 [複数要素] | |
| code | 沿線コード | XXXXXX |
| name | 沿線名 | 東海道線 |
| along_type | 沿線タイプ | |
| code | 沿線タイプコード | 00490 |
| name | 沿線タイプ名 | JR |
| prefecture | 都道府県 [複数要素] | |
| code | 都道府県コード | 13 |
| name | 都道府県名 | 東京都 |
駅マスタ API
駅の一覧を取得できます。
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| station | 駅コード | 駅毎のコード。複数指定可能*1 | (例) 0001263 | |
| along | 沿線コード | 沿線毎のコード。複数指定可能*1 | (例) 1234 | |
| prefecture | 都道府県 | 都道府県毎のコード。複数指定可能*1 | (例) 13 | |
| keyword | キーワード | フリーワード | (例) 両国 | |
| start | 検索の開始位置 | 検索結果の何件目から出力するかを指定します。 | 初期値:1 | |
| count | 1ページあたりの取得数 | 検索結果の最大出力データ数を指定します。 | 初期値：10、最小1、最大100 | |
| format | レスポンス形式 | レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 | 初期値:xml。xmlまたはjsonまたはjsonp |
- *1：複数可のパラメータの指定方法
name=value1&name=value2&...または name=value1,value2,...
個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
サンプルクエリ
駅一覧を取得
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| station | 駅 [複数要素] | |
| code | 駅コード | 0001263 |
| name | 駅名 | 両国 |
| along | 沿線 [複数要素] | |
| code | 沿線コード | 1234 |
| name | 沿線名 | 東海道線 |
| along_type | 沿線タイプ | |
| code | 沿線タイプコード | 00490 |
| name | 沿線タイプ名 | JR |
| prefecture | 都道府県 [複数要素] | |
| code | 都道府県コード | 13 |
| name | 都道府県名 | 東京都 |
カテゴリマスタ API
カテゴリの一覧を取得できます。サイト区分を指定する事で、ケイコとマナブ.net、資格と仕事.net向けの一覧をそれぞれ取得できます
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| category | カテゴリ | カテゴリ毎のコード。複数指定可能*1 | (例) G010020 | |
| site | サイト区分 | サイト別に絞り込む事ができます。 KN:ケイコとマナブ.net SS:資格と仕事.net |
(例) KN | |
| start | 検索の開始位置 | 検索結果の何件目から出力するかを指定します。 | 初期値:1 | |
| count | 1ページあたりの取得数 | 検索結果の最大出力データ数を指定します。 | 初期値：10、最小1、最大100 | |
| format | レスポンス形式 | レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 | 初期値:xml。xmlまたはjsonまたはjsonp |
- *1：複数可のパラメータの指定方法
name=value1&name=value2&...または name=value1,value2,...
個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
サンプルクエリ
カテゴリ一覧を取得
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| category | カテゴリ [複数要素] | |
| code | カテゴリコード | G010020 |
| name | カテゴリ名 | 整体・カイロ・ボディケア |
| site | サイト区分 | KN |
カプセルマスタ API
カプセルの一覧を取得できます。サイト区分を指定する事で、ケイコとマナブ.net、資格と仕事.netの「仕事」「資格」向けの一覧をそれぞれ取得できます
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| capsule | カプセル | カプセル毎のコード。複数指定可能*1 | (例) G020020 | |
| category | カテゴリ | カテゴリ毎のコード。複数指定可能*1 | (例) G010020 | |
| site | サイト区分 | サイト別に絞り込む事ができます。複数指定可能*1 KN:ケイコとマナブ.net SSL:資格と仕事.netの資格 SSW:資格と仕事.netの仕事。 |
(例) KN | |
| keyword | キーワード | フリーワード | (例) エステ・美容 | |
| start | 検索の開始位置 | 検索結果の何件目から出力するかを指定します。 | 初期値:1 | |
| count | 1ページあたりの取得数 | 検索結果の最大出力データ数を指定します。 | 初期値：10、最小1、最大100 | |
| format | レスポンス形式 | レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 | 初期値:xml。xmlまたはjsonまたはjsonp |
- *1：複数可のパラメータの指定方法
name=value1&name=value2&...または name=value1,value2,...
個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
サンプルクエリ
カプセル一覧を取得
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| capsule | カプセル [複数要素] | |
| code | カプセルコード | G020020 |
| name | カプセル名 | エステ・美容 |
| site | サイト区分 | KN |
| category | カテゴリ [複数要素] | |
| code | カテゴリコード | G010020 |
| name | カテゴリ名 | ビューティー |
特集マスタ API
特集の一覧を取得できます。
リクエストURL
検索クエリ
| パラメータ | 項目名 | 説明 | 必須 | 値 |
|---|---|---|---|---|
| key | APIキー | APIを利用するために割り当てられたキーを設定します。 | ○ | |
| special | 特集 | 特集毎のコード。複数指定可能*1 | (例) K200001 | |
| site | サイト区分 | サイト別に絞り込む事ができます。 KN:ケイコとマナブ.net SS:資格と仕事.net |
(例) KN | |
| start | 検索の開始位置 | 検索結果の何件目から出力するかを指定します。 | 初期値:1 | |
| count | 1ページあたりの取得数 | 検索結果の最大出力データ数を指定します。 | 初期値：10、最小1、最大100 | |
| format | レスポンス形式 | レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 | 初期値:xml。xmlまたはjsonまたはjsonp |
- *1：複数可のパラメータの指定方法
name=value1&name=value2&...または name=value1,value2,...
個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
サンプルクエリ
特集一覧を取得
※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。
レスポンスフィールド
| フィールド | 説明 | 例 |
|---|---|---|
| results | ||
| api_version | APIのバージョン | 1.01 |
| results_available | クエリー条件にマッチする、検索結果の全件数 | 7 |
| results_returned | このＸＭＬに含まれる検索結果の件数 | 7 |
| results_start | 検索結果の開始位置 | 1 |
| special | 特集 [複数要素] | |
| code | 特集コード | K200001 |
| name | 特集名 | 一生続けられる仕事を手に入れる講座特集 |
| site | サイト区分 | KN |
エラー時のレスポンス
<?xml version="1.0" encoding="UTF-8"?>
<results xmlns="http://webservice.recruit.co.jp/manabi/">
<api_version>1.00</api_version>
<error>
<message>keyは必須パラメーターです</message>
</error>
</results>
エラーの際でも、HTTPレスポンスステータスは常に "200 OK" が返ります。実装側では常にレスポンスXMLの内容を見てエラー判断を行ってください。
Flashからの利用方法
Flash Action Script 2.0にて本APIを利用するには1フレーム目に下記の記述を追加する必要があります:
System.security.loadPolicyFile("http://webservice.recruit.co.jp/manabi/crossdomain.xml");
このように crossdomain.xml を指定する事で、ご自身のサイト上にある Flash SWF ファイルから、本APIを利用することが可能になります。
