合コンサーチAPI


全国各地で、各社のお見合い合コン情報を開催場所や日時順で取得できるAPIです。
ご利用は自由ですがクレジットの表記をお願いいたします。

リクエストURL


http://goucon.jp/top/api/get



リクエストパラメータ


パラメータ 説明
results integer: 10(デフォルト), 20(最大) 結果数です。
start integer: 0(デフォルト) 返却結果の先頭位置です。最終位置(start + results - 1)は、1000を超えられません。
format xml(デフォルト),json 返却のフォーマットです。
callback 任意の関数名(JSONP対応のため) 値が入っていて、formatがjsonの場合 callback名() をつけて返します。xmlの場合は必要ありません。
pref(必須) integer: 13(デフォルト) 1:北海道  2:青森県  3:岩手県  4:宮城県  5:秋田県  6:山形県  7:福島県  8:茨城県  9:栃木県  10:群馬県  11:埼玉県  12:千葉県  13:東京都  14:神奈川県  15:新潟県  16:富山県  17:石川県  18:福井県  19:山梨県  20:長野県  21:岐阜県  22:静岡県  23:愛知県  24:三重県  25:滋賀県  26:京都府  27:大阪府  28:兵庫県  29:奈良県  30:和歌山県  31:鳥取県  32:島根県  33:岡山県  34:広島県  35:山口県  36:徳島県  37:香川県  38:愛媛県  39:高知県  40:福岡県  41:佐賀県  42:長崎県  43:熊本県  44:大分県  45:宮崎県  46:鹿児島県  47:沖縄県 

レスポンスフィールド


パラメータ
Result 各個別レスポンス
Title 合コン名
Place 開催場所
Date 日時
ReserveMan (男性)予約状況
ReserveWoan (女性)予約状況
AgeMan (男性)対象年齢
AgeWoan (女性)対象年齢
Url ページのURL
AreaName エリア名
Article 内容
Image 画像URL

サンプルレスポンス


(URL): http://goucon.jp/top/api/get?format=xml&pref=13&results=2&start=0



クレジット表示方法と注意


クレジットとは、合コンサーチで提供されるAPIを利用して作成されたアプリであることを示すとともに、「合コンサーチAPI利用規約」に従っていることを表すための表示です。
 合コンサーチによって提供されたAPIを利用するすべてのサイトやアプリには、クレジットを表示する必要があります。
表示位置は自由ですが、そのアプリやサイトが合コンサーチを利用し制作されていることがわからなくなるような表示方法は行わないでください。
また以下のHTMLソースを利用してください。ソースの改変はできません。
スマートフォンアプリなどでどうしてもクレジット表示ができない場合は事前にご連絡ください。
表示はAPIを利用しているページすべてに設置をお願いいたします。ただし、トップページに設置した場合はトップページのみで結構です。



注意事項


過度に不可がかかるようなプログラム設計は控えていただくようお願いいたします。 (制限はありませんが、1時間当たり500リクエストを超えないようにしてください。15分以内の同一リクエストにキャッシュを利用してくだい。)