GROUPON API

2016年6月15日
グルーポンWebサイトリニューアルに伴う公開APIの廃止について

平素はグルーポンをご利用いただきまして、誠にありがとうございます。
グルーポンでは、2016年7月中旬にグルーポンWebサイトのリニューアルを予定しております。
リニューアル後、公開APIが廃止となります。

これまでご利用いただいた皆様にはご不便をおかけいたしますが、何卒ご理解いただきますようお願い申し上げます。

リニューアルにつきましては、こちらをご確認ください。

ご不明点がございましたら、グルーポンお客様センターまでお問い合わせください。
グルーポンお客様センター: https://www.groupon.jp/site/contact/


エリア一覧取得

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

Version.1

※今まで通りご利用いただけます
  • 送信パラメータ
URL http://www.groupon.jp/api-v1/?type=area&format=[データフォーマット]
パラメータ
(GETで指定)
パラメータ 説明
type area 必須(固定)
format xml,json,php 任意
指定がない場合はjson形式での取得となります
  • 受信データ
  • 送信パラメータのformat形式で、開催されている地域一覧とクーポン番号が取得されます。
    複数地域で同一クーポンが提供されている場合、同一のクーポン番号が地域毎に取得されます。
パラメータ 説明
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

※受信データにパラメータが追加されました
  • 送信パラメータ
URL http://www.groupon.jp/api-v2/?type=area&format=[データフォーマット]
パラメータ
(GETで指定)
パラメータ 説明
type area 必須(固定)
format xml,json,php 任意
指定がない場合はjson形式での取得となります
  • 受信データ
  • 送信パラメータのformat形式で、開催されている地域一覧とクーポン番号が取得されます。
    複数地域で同一クーポンが提供されている場合、同一のクーポン番号が地域毎に取得されます。
パラメータ 説明
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に対応しています。
※緯度経度を指定して座標近くのクーポンを取得できます。
※色の付いている項目は任意ですが、正しく値を色のセット毎に各項目に入れないと動作しません。
※任意のパラメータがない場合は、全てを取得します。
※任意の座標パラメータがある場合は、ショッピング系のクーポンを取得しません。
  • 送信パラメータ パターン1
  • ※中心点を指定して近隣データを取得します。
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
  • 送信パラメータ パターン2
  • ※北東と南西の座標を指定して四角に囲まれたエリア情報を取得します。
URL http://www.groupon.jp/api-v3/?type=area&format=[データフォーマット]
パラメータ
(GETで指定)
パラメータ 説明
type area 必須(固定)
format xml,json,php 任意
指定がない場合はjson形式での取得となります
nelat [緯度] 北東緯度を任意で指定します。
北東・南西の緯度経度も設定が必要です。
nelon [経度] 北東経度を任意で指定します。
北東・南西の緯度経度も設定が必要です。
swlat [緯度] 南西緯度を任意で指定します。
北東・南西の緯度経度も設定が必要です。
swlon [経度] 南西経度を任意で指定します。
北東・南西の緯度経度も設定が必要です。
  • 受信データ
  • 送信パラメータのformat形式で、開催されている地域一覧とクーポン番号が取得されます。
    複数地域で同一クーポンが提供されている場合、同一のクーポン番号が地域毎に取得されます。
パラメータ 説明
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

※今まで通りご利用いただけます
  • 送信パラメータ
URL http://www.groupon.jp/api-v1/?type=coupon&area_code=[エリアコード]&cid=[クーポン番号]&format=[データフォーマット]
パラメータ
(GETで指定)
パラメータ 説明
type coupon 必須(固定)
area_code [エリアコード] 必須
エリア一覧で取得したエリアコードを数値で指定。
cid [クーポン番号] 必須
エリア一覧で取得したクーポン番号を数値で指定。
format xml,json,php 任意
指定がない場合はjson形式での取得となります
  • 受信データ
  • 送信パラメータのformat形式で、指定エリアのクーポン詳細が取得されます。
パラメータ 説明
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

※受信データに変更はございません
  • 送信パラメータ
URL http://www.groupon.jp/api-v2/?type=coupon&area_code=[エリアコード]&cid=[クーポン番号]&format=[データフォーマット]
パラメータ
(GETで指定)
パラメータ 説明
type coupon 必須(固定)
area_code [エリアコード] 必須
エリア一覧で取得したエリアコードを数値で指定。
cid [クーポン番号] 必須
エリア一覧で取得したクーポン番号を数値で指定。
format xml,json,php 任意
指定がない場合はjson形式での取得となります
  • 受信データ
  • 送信パラメータのformat形式で、指定エリアのクーポン詳細が取得されます。
パラメータ 説明
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対応になりました。
  • 送信パラメータ
URL http://www.groupon.jp/api-v3/?type=coupon&area_code=[エリアコード]&cid=[クーポン番号]&format=[データフォーマット]
パラメータ
(GETで指定)
パラメータ 説明
type coupon 必須(固定)
area_code [エリアコード] 必須
エリア一覧で取得したエリアコードを数値で指定。
cid [クーポン番号] 必須
エリア一覧で取得したクーポン番号を数値で指定。
format xml,json,php 任意
指定がない場合はjson形式での取得となります
  • 受信データ
  • 送信パラメータのformat形式で、指定エリアのクーポン詳細が取得されます。
パラメータ 説明
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)
【 基本的な流れ 】
  1. エリア一覧取得によって開催されているクーポンの地域一覧などを取得します。
  2. 取得した一覧を元にエンドユーザが地域などを選択します。
  3. エンドユーザが選択した地域情報を元にクーポンデータを取得しエンドユーザに表示します。
【 更 新 履 歴 】
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のデータも取得できます。

  • すべて

地域のクーポン

  • 北海道・東北
    北海道 青森 岩手 宮城 秋田 山形 福島
  • 関西
    大阪 京都 兵庫 奈良 和歌山 滋賀
  • 関東
    東京 神奈川 千葉 埼玉 茨城 群馬 栃木
  • 中国
    広島 岡山 島根 鳥取 山口
  • 甲信越・北陸
    山梨 長野 新潟 富山 石川 福井
  • 四国
    香川 徳島 高知 愛媛
  • 東海
    愛知 静岡 三重 岐阜
  • 九州・沖縄
    福岡 佐賀 長崎 大分 熊本 宮崎 鹿児島 沖縄
  • ショッピング
  • トラベル