「トクポAPI」では、TOKUPOに掲載されている激安クーポン情報、画像情報の一部を提供しています。 ご利用登録いただければこれらの情報を取得して、新しいサイトや既存サービスのコンテンツとしてご利用することができます。

トクポは3人紹介すると1枚分のクーポンの金額がポイントとして付与され、10000円分以上のポイントをためると 現金でキャッシュバックできるアフィリエイトシステムがあります。APIでシステムに組み込むことで、常に最新の クーポン情報を表示することができ、ユーザ名とアフィエイト報酬を紐付けてカウントし収益を得ることが可能です。 詳細な仕様や取得条件等は下記APIの仕様からご確認ください。

1. TOKUPOに会員登録をします。
2. お問い合わせフォームからAPIの使用目的、使用するサイトのURL、会員ユーザ名と登録メールアドレスをお伝えください。
3. 当社のほうで簡単な審査をさせていただき、問題ないようでしたらこちらユーザ専用のアクセスキーを発行させていただきます。
4. APIを利用したアフィリエイトの収益（紹介インセンティブ）は登録したユーザのマイページ上に表示されます。
5. 10000円（10000ポイント）以上で換金できますので、マイページから振り込み先口座情報をお送りください。

---

■クーポン一覧取得

TOKUPOで公開されているクーポンのリストを取得できます。
パラメータを追加することにより、地域およびカテゴリーを絞って表示することができます。

送信データ（GET形式）

URL	http://www.tokupo.jp/api_v2/list/
パラメータ (GETで指定)	パラメータ	説明	補足
	key	アクセスキー	（必須項目）
	area	地域	指定しない場合は全地域
	detail	詳細地域	指定しない場合は全詳細地域
	bigcategory	大カテゴリ	指定しない場合はすべての大カテゴリ
	category	カテゴリ	指定しない場合はすべてのカテゴリ
	nam	取得件数	指定しない場合は50件（1～100件まで取得可能）

受信データ（XML形式）

パラメータ 内容 id クーポンのＩＤ url クーポンのURL suburl アフィリエイト付きクーポンURL title タイトル subtitle サブタイトル type_id クーポンタイプ start_date 開始日 end_date 終了日 area_name エリア名 area_code エリア名コード detail_name 詳細エリア名 detail_id 詳細エリア名ID bigcategory_name 大カテゴリー名 bigcategory_id 大カテゴリーＩＤ

パラメータ 内容 category_name カテゴリー名 category_id カテゴリー名ID fixed_price 定価 discount_price 割引後の価格 sales_max 最大販売数 details1 チケット詳細 details2 提示条件 details3 利用条件 details4 有効期限 buyer_count 購入者数 top_img1 トップページ画像アドレス1 top_img2 トップページ画像アドレス2 top_img3 トップページ画像アドレス3 list_img サムネイル画像アドレス

■クーポン情報取得

TOKUPOで公開されているクーポンのIDを指定して詳細情報を取得できます。

送信データ（GET形式）

URL	http://www.tokupo.jp/api_v2/coupon/
パラメータ (GETで指定)	パラメータ	説明	補足
	key	アクセスキー	（必須項目）
	id	クーポンＩＤ	（必須項目）

受信データ（XML形式）

パラメータ 内容 id クーポンのＩＤ url クーポンのURL suburl アフィリエイト付きクーポンURL title タイトル subtitle サブタイトル type_id クーポンタイプ start_date 開始日 end_date 終了日 area_name エリア名 area_code エリア名コード detail_name 詳細エリア名 detail_id 詳細エリア名ID bigcategory_name 大カテゴリー名 bigcategory_id 大カテゴリーＩＤ category_name カテゴリー名 category_id カテゴリー名ID fixed_price 定価 discount_price 割引後の価格 sales_max 最大販売数 details1 チケット詳細 details2 提示条件

パラメータ 内容 details3 利用条件 details4 有効期限 buyer_count 購入者数 top_img1 トップページ画像アドレス1 top_img2 トップページ画像アドレス2 top_img3 トップページ画像アドレス3 list_img サムネイル画像アドレス msg 店舗メッセージ shopname 店名 tel 電話番号 address 住所 traffic 交通手段 businesshours 営業時間 holiday 定休日 hp ホームページ link1 リンク1 link2 リンク2 map_n googleMAP座標データ1 map_e googleMAP座標データ2 shop_img 店舗画像アドレス

■API利用時の注意事項

ご利用につきましては、常にデータを取得する形にせず一度データを保存する形式でご利用ください。
また、API利用者のアクセス負荷が大きい場合、APIのご利用を一時制限させていただく場合もありますのでご注意ください。
※目安としましては15～30分ほど間を空けてのアクセスですと問題ありません。

■各ID表

APIをご利用になられる際のデータ形式を記載しております。
こちらのリストを参考にデータ送信を行ってください。

エリア 北海道 hokkaido 青森 aomori 岩手 iwate 宮城 miyagi 秋田 akita 山形 yamagata 福島 fukushima 東京 tokyo 神奈川 kanagawa 埼玉 saitama 千葉 chiba 茨城 ibaraki 栃木 tochigi 群馬 gunma 山梨 yamanashi 新潟 niigata 長野 nagano 富山 toyama 石川 ishikawa 福井 fukui 愛知 aichi 岐阜 gifu 静岡 shizuoka 三重 mie 大阪 osaka 兵庫 hyogo 京都 kyoto 滋賀 shiga 奈良 nara 和歌山 wakayama 鳥取 tottori 島根 shimane 岡山 okayama 広島 hiroshima 山口 yamaguchi 徳島 tokushima 香川 kagawa 愛媛 ehime 高知 kochi 福岡 fukuoka 佐賀 saga 長崎 nagasaki 熊本 kumamoto 大分 oita 宮崎 miyazaki 鹿児島 kagoshima 沖縄 okinawa 全国 all 大カテゴリ 大カテゴリ名 大カテゴリID すべて 0 グルメ 1 美容・健康 2 生活・娯楽 3 カテゴリ 小カテゴリ名 ID 親大カテゴリ 居酒屋 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 生活・娯楽 クーポンタイプ ID 内容 0 通常 1 通販 2 懸賞

詳細地域 地域詳細名 詳細地域ID 親エリア名 函館・道南 101 北海道 釧路・帯広・道東 102 北海道 旭川・道央・道北 103 北海道 札幌駅・大通・すすきの 104 北海道 小樽・千歳・札幌近郊 105 北海道 その他 199 北海道 八戸・十和田・下北 201 青森 弘前・津軽 202 青森 青森市 203 青森 その他 299 青森 雫石・二戸・内陸北部 301 岩手 盛岡市 302 岩手 一関・花巻・遠野・内陸南部 303 岩手 釜石・久慈・宮古・沿岸部 304 岩手 その他 399 岩手 仙台駅周辺 401 宮城 国分町・一番町 402 宮城 泉区 403 宮城 松島・塩釜・三陸 404 宮城 その他 499 宮城 能代・男鹿・本荘・沿岸部 501 秋田 秋田市 502 秋田 横手・田沢湖・大館・内陸部 503 秋田 その他 599 秋田 鶴岡・酒田・新庄・最上 601 山形 寒河江・天童・村山 602 山形 米沢・南陽・置賜 603 山形 山形市 604 山形 その他 699 山形 会津・会津若松・喜多方 701 福島 中通り・福島・郡山・白河 702 福島 浜通り・いわき・原町 703 福島 その他 799 福島 恵比寿・代官山 801 東京 東京・大手町・日本橋 802 東京 渋谷・原宿 803 東京 池袋・巣鴨・大塚 804 東京 神田・神保町・秋葉原 805 東京 新宿 806 東京 赤坂・六本木・麻布十番・広尾 807 東京 上野・御徒町・浅草 808 東京 銀座・有楽町・新橋・築地 809 東京 中目黒・祐天寺・学大 810 東京 品川・目黒・田町・浜松町 811 東京 青山・表参道 812 東京 お台場・豊洲 813 東京 中野・高円寺 814 東京 吉祥寺・国分寺・立川 815 東京 四谷 816 東京 下北沢 817 東京 その他 899 東京 横浜市 901 神奈川 鎌倉・藤沢・湘南・江の島 902 神奈川 川崎市 903 神奈川 横須賀・逗子・葉山・三浦 904 神奈川 相模原・大和周辺 905 神奈川 海老名・厚木周辺 906 神奈川 小田原周辺 907 神奈川 箱根・湯河原 908 神奈川 その他 999 神奈川 さいたま市 1001 埼玉 川口・越谷・春日部・三郷 1002 埼玉 和光・新座・志木・川越 1003 埼玉 上尾・久喜・行田 1004 埼玉 熊谷・本庄・東松山・寄居 1005 埼玉 所沢・飯能 1006 埼玉 秩父・長瀞 1007 埼玉 その他 1099 埼玉 千葉市 1101 千葉 船橋・市川・浦安 1102 千葉 柏・松戸 1103 千葉 成田・佐倉・佐原 1104 千葉 銚子・九十九里 1105 千葉 市原・木更津・富津 1106 千葉 勝浦・鴨川・館山 1107 千葉 その他 1199 千葉 日立・茨城北部 1201 茨城 水戸・ひたちなか・茨城中部 1202 茨城 土浦・つくば・取手・茨城南西部 1203 茨城 鹿島・潮来・鹿行 1204 茨城 その他 1299 茨城 日光・那須・栃木北部 1301 栃木 宇都宮市 1302 栃木 小山・両毛・栃木南部 1303 栃木 その他 1399 栃木 草津・伊香保・みなかみ・県北 1401 群馬 高崎・南西部 1402 群馬 前橋・伊勢崎・桐生・南東部 1403 群馬 その他 1499 群馬 甲府・南アルプス・山梨中西部 1501 山梨 大月・富士五湖・山梨東部 1502 山梨 その他 1599 山梨 村上・新発田・下越 1601 新潟 新潟市 1602 新潟 長岡・柏崎・湯沢・中越 1603 新潟 上越・妙高 1604 新潟 佐渡 1605 新潟 その他 1699 新潟 長野・野沢温泉・北信 1701 長野 松本・白馬・木曽・中信 1702 長野 上田・佐久・軽井沢・東信 1703 長野 諏訪・伊那・飯田・南信 1704 長野 その他 1799 長野 富山市 1801 富山 高岡・氷見・富山西部 1802 富山 黒部・立山・富山東部 1803 富山 その他 1899 富山 金沢市 1901 石川 七尾・輪島・能登 1902 石川 小松・加賀・河北・石川南部 1903 石川 その他 1999 石川 福井市 2001 福井 鯖江・武生・嶺北 2002 福井 敦賀・小浜・嶺南 2003 福井 その他 2099 福井 名古屋駅周辺 2101 愛知 伏見・丸の内 2102 愛知 栄・矢場町 2103 愛知 新栄・千種・今池・池下 2104 愛知 大須・金山・鶴舞 2105 愛知 覚王山・本山・東山公園 2106 愛知 久屋大通・高岳 2107 愛知 一社・上社 2108 愛知 本郷・藤が丘 2109 愛知 緑区 2110 愛知 天白区 2111 愛知 新瑞橋 2112 愛知 刈谷市 2113 愛知 一宮・春日井 2114 愛知 三重県四日市市 2115 愛知 岐阜駅周辺 2116 愛知 西区 2117 愛知 上小田井 2118 愛知 中川区 2119 愛知 熱田区 2120 愛知 港区 2121 愛知 昭和区 2122 愛知 長久手 2123 愛知 豊橋 2124 愛知 南区 2125 愛知 瑞穂区 2126 愛知 その他 2199 愛知 高山・下呂・飛騨 2201 岐阜 関・多治見・中濃・東濃 2202 岐阜 岐阜・羽島・大垣・西濃 2203 岐阜 その他 2299 岐阜 静岡・藤枝・焼津・静岡中部 2301 静岡 浜松・磐田・掛川・静岡西部 2302 静岡 三島・沼津・富士・静岡東部 2303 静岡 熱海・修善寺・下田・伊豆 2304 静岡 その他 2399 静岡 桑名・四日市・三重北部 2401 三重 津・松阪・三重中部 2402 三重 伊勢・鳥羽・志摩・三重南部 2403 三重 その他 2499 三重 梅田 2501 大阪 ミナミ 2502 大阪 京橋・天満橋 2503 大阪 本町 2504 大阪 淀屋橋・肥後橋・北浜 2505 大阪 天王寺 2506 大阪 福島・野田 2507 大阪 北摂・茨木・高槻 2508 大阪 新大阪・南方・十三 2509 大阪 堺・泉州 2510 大阪 京阪沿線エリア 2511 大阪 天満・天神橋筋 2512 大阪 その他 2599 大阪 神戸 2601 兵庫 三宮・元町 2602 兵庫 西宮・芦屋 2603 兵庫 尼崎 2604 兵庫 明石 2605 兵庫 姫路 2606 兵庫 宝塚・伊丹・三田 2607 兵庫 灘・東灘 2608 兵庫 川西池田 2609 兵庫 その他 2699 兵庫 京都 2701 京都 河原町・木屋町・先斗町 2702 京都 烏丸・西院 2703 京都 伏見・山科・宇治 2704 京都 祇園・岡崎・清水寺 2705 京都 京都駅周辺・東寺 2706 京都 京都市左京区 2707 京都 京都市右京区 2708 京都 その他 2799 京都 大津市 2801 滋賀 彦根・長浜・湖北・湖西 2802 滋賀 草津・近江八幡・湖南 2803 滋賀 その他 2899 滋賀 奈良市 2901 奈良 生駒・大和郡山・天理・橿原 2902 奈良 吉野・十津川・奈良南部 2903 奈良 その他 2999 奈良 和歌山市 3001 和歌山 橋本・岩出・有田・御坊 3002 和歌山 田辺・白浜・串本町・新宮 3003 和歌山 その他 3099 和歌山 鳥取・八頭・鳥取東部 3101 鳥取 倉吉・米子・鳥取中西部 3102 鳥取 その他 3199 鳥取 浜田・益田・津和野・島根西部 3201 島根 松江・出雲・島根東部 3202 島根 その他 3299 島根 岡山市 3301 岡山 倉敷市 3302 岡山 備前・総社・笠岡・岡山南部 3303 岡山 新見・津山・岡山北部 3304 岡山 その他 3399 岡山 広島市・宮島 3401 広島 中区・流川・紙屋町 3402 広島 南区・東区・広島駅・安芸郡 3403 広島 安佐南区・安佐北区 3404 広島 西区・横川・商工センター 3405 広島 佐伯区・廿日市・宮島 3406 広島 その他 3499 広島 萩・長門・山口北部 3501 山口 下関・宇部・山口西部 3502 山口 山口・防府・周南・山口中部 3503 山口 岩国・山口東部 3504 山口 その他 3599 山口 徳島・鳴門・徳島北部 3601 徳島 阿南・徳島南部 3602 徳島 その他 3699 徳島 高松市 3701 香川 坂出・丸亀・観音寺・香川西部 3702 香川 さぬき・東かがわ・香川東部 3703 香川 小豆島 3704 香川 その他 3799 香川 中予 3801 愛媛 東予 3802 愛媛 南予 3803 愛媛 その他 3899 愛媛 高知・土佐・南国・高知中部 3901 高知 中村・宿毛・高知西部 3902 高知 安芸・室戸・高知東部 3903 高知 その他 3999 高知 中洲（西中洲）・春吉 4001 福岡 博多 4002 福岡 天神 4003 福岡 久留米 4004 福岡 北九州 4005 福岡 警固・今泉・薬院 4006 福岡 大名・赤坂 4007 福岡 西新・百道 4008 福岡 大濠・大手門・港 4009 福岡 大橋・高宮 4010 福岡 香椎周辺 4011 福岡 その他 4099 福岡 佐賀・鳥栖 4101 佐賀 伊万里・唐津・有田 4102 佐賀 小城・武雄・嬉野 4103 佐賀 その他 4199 佐賀 長崎市 4201 長崎 大村・諫早・島原・長崎南部 4202 長崎 佐世保・平戸・長崎北部 4203 長崎 五島列島 4204 長崎 壱岐・対馬 4205 長崎 その他 4299 長崎 熊本市内 4301 熊本 玉名・山鹿・熊本北部 4302 熊本 八代・宇土・熊本中部 4303 熊本 天草・葦北 4304 熊本 人吉・球磨 4305 熊本 阿蘇 4306 熊本 その他 4399 熊本 大分・別府･大分中部 4401 大分 日田・湯布院・竹田・大分西部 4402 大分 中津・宇佐・国東・大分北部 4403 大分 佐伯・津久見・大分南部 4404 大分 その他 4499 大分 宮崎・日南・都城・宮崎南部 4501 宮崎 西都・日向・延岡・宮崎北部 4502 宮崎 その他 4599 宮崎 鹿児島・指宿・川内・薩摩半島 4601 鹿児島 鹿屋・大隅半島 4602 鹿児島 名瀬・与論・奄美諸島 4603 鹿児島 種子島・屋久島 4604 鹿児島 その他 4699 鹿児島 本島中部 4701 沖縄 那覇 4702 沖縄 沖縄離島 4703 沖縄 本島南部 4704 沖縄 本島北部 4705 沖縄 その他 4799 沖縄

---

ご不明な点等ございましたら下記からお問い合わせください。