GROUPON API

GROUPON(グルーポン)では、開催地域一覧、地域毎最新クーポン詳細情報を提供するためのAPIを用意しております。
下記のメニューからご参照ください。

更新履歴など
エリア一覧取得
クーポンデータ取得

エリア一覧取得Version.1 エリア一覧取得Version.2 エリア一覧取得Version.3

クーポンデータ取得Version.1 クーポンデータ取得Version.2 クーポンデータ取得Version.3

基本的な流れ更新履歴

エリア一覧取得

GROUPON(グルーポン)で開催されている地域の一覧を取得できます。

Version.1

※今まで通りご利用いただけます

送信パラメータ

パラメータ (GETで指定)
URL	http://www.groupon.jp/api-v1/?type=area&format=[データフォーマット]
	パラメータ	値	説明
	type	area	必須(固定)
	format	xml,json,php	任意指定がない場合はjson形式での取得となります

受信データ

パラメータ	説明
code	地域のコード番号
name	地域の日本語名称
cid	クーポン番号

【参考】

json	xml	php
[{"code": "13_01","name": "\u6771\u4eac\u90fd \u8db3\u7acb\u533a","cid": "61"},{"code": "13_02","name": "\u6771\u4eac\u90fd \u8352\u5ddd\u533a","cid": "61"},{"code": "13_03","name": "\u6771\u4eac\u90fd \u677f\u6a4b\u533a","cid": "61"},{"code": "14","name": "\u795e\u5948\u5ddd\u770c","cid": "61"}]	<response> 　　<area> 　　　　<code>13</code> 　　　　<name>東京都</name> 　　　　<cid>61</cid> 　　</area> … … </response>	a: 2:{i: 0;a: 2: {i: 0;a: 3: {s: 4: "code";s: 5: "13_01";s: 4: "name";s: 19: "東京都足立区";s: 3: "cid";s: 2: "61";}i: 1;a: 2: {s: 4: "code";s: 2: "14";s: 4: "name";s: 12: "神奈川県";s: 3: "cid";s: 2: "61";}}
	ルートノード<response> 親ノード<area>が付加されます	シリアライズされたデータが送信されます

エリア一覧取得

GROUPON(グルーポン)で開催されている地域の一覧を取得できます。

Version.2

※受信データにパラメータが追加されました

送信パラメータ

パラメータ (GETで指定)
URL	http://www.groupon.jp/api-v2/?type=area&format=[データフォーマット]
	パラメータ	値	説明
	type	area	必須(固定)
	format	xml,json,php	任意指定がない場合はjson形式での取得となります

受信データ

パラメータ	説明
code	地域のコード番号
name	地域の日本語名称
cid	クーポン番号
side	サイドディール判定　※サイドディールデータの場合のみ表示

【参考】

json	xml	php
[{": ": "13_01","name": "\u6771\u4eac\u90fd \u8db3\u7acb\u533a","cid": "61"},{"code": "13_02","name": "\u6771\u4eac\u90fd \u8352\u5ddd\u533a","cid": "61"},{"code": "13_03","name": "\u6771\u4eac\u90fd \u677f\u6a4b\u533a","cid": "61"},{"code": "14","name": "\u795e\u5948\u5ddd\u770c","cid": "61","side": "YES"}]	<response> 　　<area> 　　　　<code>13</code> 　　　　<name>東京都</name> 　　　　<cid>61</cid> 　　　　<side>YES</side> 　　</area> … … </response>	a: 2: {i: 0;a: 2: {i: 0;a: 3: {s: 4: "code";s: 5: "13_01";s: 4: "name";s: 19: "東京都足立区";s: 3: "cid";s: 2: "61";}i: 1;a: 2: {s: 4: "code";s: 2: "14";s: 4: "name";s: 12: "神奈川県";s: 3: "cid";s: 2: "61";s: 4"side";s: 3"YES";}}
	ルートノード<response> 親ノード<area>が付加されます	シリアライズされたデータが送信されます

エリア一覧取得

GROUPON(グルーポン)で開催されている地域の一覧を取得できます。

Version.3

※受信データにパラメータが追加され、GrouponNowに対応しています。
※緯度経度を指定して座標近くのクーポンを取得できます。
※色の付いている項目は任意ですが、正しく値を色のセット毎に各項目に入れないと動作しません。
※任意のパラメータがない場合は、全てを取得します。
※任意の座標パラメータがある場合は、配送・Web系のクーポンを取得しません。

送信パラメータ　パターン１

URL

http://www.groupon.jp/api-v3/?type=area&format=[データフォーマット]

パラメータ
(GETで指定)

パラメータ

値

説明

type

area

必須(固定)

format

xml,json,php

任意
指定がない場合はjson形式での取得となります

lat

[緯度]

緯度の値を任意で指定します。
経度も合わせて使用しないと無効になります。

lon

[経度]

経度の値を任意で指定します。
緯度も合わせて使用しないと無効になります。

scope

4-8

標準は6で動きます。
数値が減少するにつれて広域になり
増加するにつれて範囲が狭まります。

Scope	東西	南北
4	約95 km	約59 km
5	約12 km	約15 km
6	約3 km	約2 km
7	約370 m	約455 m
8	約90 m	約55 m

送信パラメータ　パターン２

パラメータ (GETで指定)
URL	http://www.groupon.jp/api-v3/?type=area&format=[データフォーマット]
	パラメータ	値	説明
	type	area	必須(固定)
	format	xml,json,php	任意指定がない場合はjson形式での取得となります
	nelat	[緯度]	北東緯度を任意で指定します。北東・南西の緯度経度も設定が必要です。
	nelon	[経度]	北東経度を任意で指定します。北東・南西の緯度経度も設定が必要です。
	swlat	[緯度]	南西緯度を任意で指定します。北東・南西の緯度経度も設定が必要です。
	swlon	[経度]	南西経度を任意で指定します。北東・南西の緯度経度も設定が必要です。

受信データ

パラメータ	説明
code	地域のコード番号
name	地域の日本語名称
cid	クーポン番号
category	カテゴリ情報
lat	緯度
lon	経度
now_flg	Groupon NowならYES

【参考】

json	xml	php
[{"code":"13_00","name":"\u6771\u4eac\u90fd", "cid":"61", "category":"\u30b0\u30eb\u30e1", "lat":"35.623062", "lon":"139.660083","now_flg":"NO"}]	<response> 　　<area> 　　　　<code>13</code> 　　　　<name>東京都</name> 　　　　<cid>61</cid> 　　　　<category>グルメ</category> 　　　　<lat>35.623062</lat> 　　　　<lon>139.660083</lon> 　　　　<now_flg>NO</now_flg> 　　</area> … … </response>	a:1:{i:0;a:7:{s:4:"code"; s:5:"13_01";s:4:"name"; s:19:"東京都足立区";s:3:"cid";s:2:"61"; s:8:"category";s:9:"グルメ";s:3:"lat";s:9: "35.657667";s:3:"lon"; s:10:"139.699510"; s:7:"now_flg";s:3:"YES";}}
	ルートノード<response> 親ノード<area>が付加されます	シリアライズされたデータが送信されます

クーポンデータ取得

一覧から取得した地域のエリアコードとクーポン番号を指定して、クーポンの詳細を取得できます。

Version.1

※今まで通りご利用いただけます

送信パラメータ

パラメータ (GETで指定)
URL	http://www.groupon.jp/api-v1/?type=coupon&area_code=[エリアコード]&cid=[クーポン番号]&format=[データフォーマット]
	パラメータ	値	説明
	type	coupon	必須(固定)
	area_code	[エリアコード]	必須エリア一覧で取得したエリアコードを数値で指定。
	cid	[クーポン番号]	必須エリア一覧で取得したクーポン番号を数値で指定。
	format	xml,json,php	任意指定がない場合はjson形式での取得となります

受信データ

パラメータ	説明
title	クーポンタイトル
sub_title	クーポンサブタイトル
start	販売開始日時
expire	販売終了日時
coupon_start	利用開始日
coupon_expire	利用期限
area_name	エリア名称
fixed_price※1	相当額（税込）※1
price	販売価格
buy_cnt	購入数
buy_limit	購入枚数上限
buy_flg	販売フラグ (YES:販売中,NO:販売終了)
buy_url	サイトURL
twitter_url	ツイート用URL
facebook_url	シェア用URL

※1「通常価格」「相当額」の記載が出来ないような
パッケージ商品や販売実績のない商品の場合は、0が返されます

パラメータ	説明
use_option	クーポン利用説明
note	クーポン補足情報
recommend	おすすめ文
ruby_says	Rubyのコメント
category_name	カテゴリ分野
shop_name	ショップ名
shop_zip	郵便番号
shop_address1	住所
shop_tel	電話番号
shop_near_station	最寄り駅
shop_open_hours	営業時間
shop_holiday	定休日等
shop_note	ショップ補足情報
shop_map_url	GoogleMapのURL
shop_img	お店の画像(PC)
shop_img_#	複数お店の画像がある場合は2枚目からのパラメータは shop_img_1, shop_img_2 ....
shop_img_mobile	お店の画像(Mobile)

クーポンデータ取得

一覧から取得した地域のエリアコードとクーポン番号を指定して、クーポンの詳細を取得できます。

Version.2

※受信データに変更はございません

送信パラメータ

パラメータ (GETで指定)
URL	http://www.groupon.jp/api-v2/?type=coupon&area_code=[エリアコード]&cid=[クーポン番号]&format=[データフォーマット]
	パラメータ	値	説明
	type	coupon	必須(固定)
	area_code	[エリアコード]	必須エリア一覧で取得したエリアコードを数値で指定。
	cid	[クーポン番号]	必須エリア一覧で取得したクーポン番号を数値で指定。
	format	xml,json,php	任意指定がない場合はjson形式での取得となります

受信データ

パラメータ	説明
title	クーポンタイトル
sub_title	クーポンサブタイトル
start	販売開始日時
expire	販売終了日時
coupon_start	利用開始日
coupon_expire	利用期限
area_name	エリア名称
fixed_price※1	相当額（税込）※1
price	販売価格
buy_cnt	購入数
buy_limit	購入枚数上限
buy_flg	販売フラグ (YES:販売中,NO:販売終了)
buy_url	サイトURL
twitter_url	ツイート用URL
facebook_url	シェア用URL

※1「通常価格」「相当額」の記載が出来ないような
パッケージ商品や販売実績のない商品の場合は、0が返されます

パラメータ	説明
use_option	クーポン利用説明
note	クーポン補足情報
recommend	おすすめ文
ruby_says	Rubyのコメント
category_name	カテゴリ分野
shop_name	ショップ名
shop_zip	郵便番号
shop_address1	住所
shop_tel	電話番号
shop_near_station	最寄り駅
shop_open_hours	営業時間
shop_holiday	定休日等
shop_note	ショップ補足情報
shop_map_url	GoogleMapのURL
shop_img	お店の画像(PC)
shop_img_#	複数お店の画像がある場合は2枚目からのパラメータは shop_img_1, shop_img_2 ....
shop_img_mobile	お店の画像(Mobile)

クーポンデータ取得

一覧から取得した地域のエリアコードとクーポン番号を指定して、クーポンの詳細を取得できます。

Version.3

※受信データの形式に変更はありません。
※Groupon Now対応になりました。

送信パラメータ

パラメータ (GETで指定)
URL	http://www.groupon.jp/api-v3/?type=coupon&area_code=[エリアコード]&cid=[クーポン番号]&format=[データフォーマット]
	パラメータ	値	説明
	type	coupon	必須(固定)
	area_code	[エリアコード]	必須エリア一覧で取得したエリアコードを数値で指定。
	cid	[クーポン番号]	必須エリア一覧で取得したクーポン番号を数値で指定。
	format	xml,json,php	任意指定がない場合はjson形式での取得となります

受信データ

パラメータ	説明
title	クーポンタイトル
sub_title	クーポンサブタイトル
start	販売開始日時
expire	販売終了日時
coupon_start	利用開始日
coupon_expire	利用期限
area_name	エリア名称
fixed_price※1	相当額（税込）※1
price	販売価格
buy_cnt	購入数
buy_limit	購入枚数上限
buy_flg	販売フラグ (YES:販売中,NO:販売終了)
buy_url	サイトURL
twitter_url	ツイート用URL
facebook_url	シェア用URL

※1「通常価格」「相当額」の記載が出来ないような
パッケージ商品や販売実績のない商品の場合は、0が返されます

パラメータ	説明
use_option	クーポン利用説明
note	クーポン補足情報
recommend	おすすめ文
ruby_says	Rubyのコメント
category_name	カテゴリ分野
shop_name	ショップ名
shop_zip	郵便番号
shop_address1	住所
shop_tel	電話番号
shop_near_station	最寄り駅
shop_open_hours	営業時間
shop_holiday	定休日等
shop_note	ショップ補足情報
shop_map_url	GoogleMapのURL
shop_img	お店の画像(PC)
shop_img_mobile	お店の画像(Mobile)

【　基本的な流れ　】

エリア一覧取得によって開催されているクーポンの地域一覧などを取得します。
取得した一覧を元にエンドユーザが地域などを選択します。
エンドユーザが選択した地域情報を元にクーポンデータを取得しエンドユーザに表示します。

【　更　新　履　歴　】

2011.10.20：Version.3を追加致しました。
2011.03.03：クーポンデータにて、相当額（税込）(fixed_price)が存在しない場合、0が返されるようになりました。
2011.03.03：クーポンデータにて、相当額（税込）(fixed_price)が存在しない場合、0が返されるようになりました。
2010.11.09：クーポンデータにて、販売成立条件(minimum)を削除致しました。
2010.11.01：クーポンデータにて、販売フラグ(buy_flg)を追加致しました。
2010.10.19：クーポンデータにて、残り枚数(coupon_rest)を削除し、購入数(buy_cnt)を追加致しました。
2010.09.15：Version.2を追加致しました。
※Version.2ではサイドディールのデータも取得できます。
※Version.3ではGroupon Nowのデータも取得できます。

メールアドレス：
パスワード：