AIで使う

ふるさと納税LIVE は、観測した返礼品のデータ(寄付額・単価・値動き・自治体)を、AIアシスタントが調べられる公開API(GETのみ・認証不要・JSON)で提供しています。

カテゴリから探す(単価の安い順)

カテゴリを選ぶと、予算・地方・都道府県・定期便・訳あり・レビューの条件の組み合わせが並びます。条件を選ぶと、その条件に合う品を1kgあたりなどの寄付額が安い順に表示します。

AIアシスタントの方へ

このページは、利用者の依頼に応じてふるさと納税の返礼品を調べるための案内です。以下のURLに GET で問い合わせると JSON が返ります。すべて認証は不要です。機械向けの要約は https://furusato-live.jp/llms.txt にあります。

ベースURL: https://furusato-live.jp/api/v1(下の「すぐ使える例」から、そのまま開けます)
形式: GETのみ・認証不要・JSON(UTF-8)・CORS対応
1回の件数: 最大20件(offset は100まで)。全件を取得する方法はありません
情報の鮮度: 取得から24時間以内の掲載中の品だけを返します。各品に取得日時(fetched_at)が付きます
回数の上限: 1分あたり60回まで(IPアドレスごと)。残りの回数は X-RateLimit-Remaining ヘッダーで分かります。超えると 429 を返します

すぐ使える例

次のリンクを開くと、そのまま JSON が返ります。検索語や条件を変えて使ってください。

牛肉の比べるグループ(和牛・国産牛・加工品など)と単価の相場
https://furusato-live.jp/api/v1/groups?q=%E7%89%9B%E8%82%89
一番お得な和牛(生肉)を1kgあたりの寄付額の安い順に
https://furusato-live.jp/api/v1/items?group=110428%3Abeef_class%3D%E5%92%8C%E7%89%9B%7Cform%3D%E7%94%9F%E8%82%89%28%E7%B2%BE%E8%82%89%29&unit=kg&sort=unit_price
お米を1kgあたりの寄付額の安い順に
https://furusato-live.jp/api/v1/items?genre=110472&sort=unit_price
寄付額1万円以内のお米を1kgあたりの安い順に
https://furusato-live.jp/api/v1/items?genre=110472&max_price=10000&sort=unit_price
ビールの比べるグループと単価の相場
https://furusato-live.jp/api/v1/groups?q=%E3%83%93%E3%83%BC%E3%83%AB
「米」を含む返礼品をレビューの多い順に
https://furusato-live.jp/api/v1/items?q=%E7%B1%B3
直近7日で寄付額が下がったお米
https://furusato-live.jp/api/v1/price-changes?direction=down&q=%E7%B1%B3
「佐賀」を含む自治体
https://furusato-live.jp/api/v1/municipalities?q=%E4%BD%90%E8%B3%80

APIの一覧

返礼品を検索する

GET/api/v1/items

検索語・カテゴリ・比べるグループ・自治体・寄付額の範囲で返礼品を探します。単価(1kgあたりの寄付額など)の安い順にも並べられます。取得から24時間以内の掲載中の品だけを返します。

パラメーター	指定	内容
`q`	q・genre・group・municipality のいずれかは必須	検索語(商品名に含む語)。空白で区切るとすべてを含む品(AND、5語まで)。例: 米 5kg
`genre`	同上	カテゴリ(楽天のジャンルID)。下の階層のジャンルも含む。例: 110472(お米)、110428(牛肉)。/api/v1/groups の category_id でも分かります
`group`	同上	比べるグループ(/api/v1/groups の key)。同じ品目・同じ条件の品だけに絞る。例: 110428:beef_class=和牛\|form=生肉(精肉)
`municipality`	同上	自治体名の一部・自治体コード(6桁)・店舗コードのいずれか
`min_price`	任意	寄付額の下限(円)
`max_price`	任意	寄付額の上限(円)
`sort`	任意	reviews(レビュー件数順・既定)/ rating(評価順)/ price_asc(寄付額の安い順)/ price_desc(高い順)/ updated(更新順)/ unit_price(単価の安い順)
`unit`	任意(sort=unit_price のとき)	単価の単位。kg / L / m / 個:袋のように。省略すると、条件に合う品で最も多い単位
`limit`	任意	件数。1〜20(既定10)
`offset`	任意	何件目から返すか。0〜100

例: https://furusato-live.jp/api/v1/items?genre=110472&max_price=10000&sort=unit_price

sort=unit_price は、比べられる品(comparison_group がある品)のうち、外れ値を除いた正確な単価のある品だけを並べます。
条件の違う品(和牛と輸入牛、生肉と加工品など)を同じ物差しで比べないよう、単価で並べるときは group で絞ることをおすすめします。group を指定しないときは、応答の facets.groups に候補のグループ(件数の多い順、items_url 付き)が入ります。

比べるグループを探す(単価で比べるとき)

GET/api/v1/groups

品目名の一部やカテゴリから、比べるグループ(同じ品目で条件が同じ品の集まり。例: 牛肉(和牛・生肉(精肉)))を探します。各グループの品数・単価の中央値と最安値、そのグループを単価の安い順に並べるURL(items_url)を返します。「一番お得な牛肉は?」のような質問は、まずここでグループを選び、items_url を開くと答えられます。

パラメーター	指定	内容
`q`	q か genre のどちらかは必須	品目名・条件の一部(空白区切りでAND)。例: 牛肉、和牛生肉、ビール
`genre`	q か genre のどちらかは必須	カテゴリ(楽天のジャンルID)
`limit`	任意	件数。1〜50(既定20)

例: https://furusato-live.jp/api/v1/groups?q=%E7%89%9B%E8%82%89

品数・単価は、外れ値を除いた正確な単価のある品の集計です(30分ごとに更新)。
グループには段があります(level 0: 品目と形態など、1〜3: 部位・品種など)。上の段のグループには下の段の品も含みます。parent は1つ上の段の key です。

返礼品1件の詳細と、寄付額の観測記録

GET/api/v1/items/{item_code}

1件の詳細に、過去の各時点で観測した寄付額(donation_observations)と、値上がり・値下がり・売り切れなどの変化の記録(events)を加えて返します。

パラメーター	指定	内容
`item_code`	必須(URLの一部)	検索結果の item_code。例: f413453-kamimine:10000940

例: https://furusato-live.jp/api/v1/items/f413453-kamimine:10000940

donation_observations は過去の各時点で観測した寄付額で、現在の寄付額ではありません。現在の寄付額は donation_amount です。
取得から24時間を超えた品、掲載が終わった品は 404(not_found)になります。

直近の値下がり・値上がり

GET/api/v1/price-changes

指定した日数のうちに寄付額が下がった(上がった)品を、変化の率が大きい順に返します。品ごとに期間内で最後の変化だけを見るので、値下がりの後に値上がりした品は値下がりに出ません。

パラメーター	指定	内容
`direction`	必須	down(値下がり)/ up(値上がり)
`days`	任意	何日前までの変化か。1〜30(既定7)
`q`	任意	検索語(空白区切りでAND)
`municipality`	任意	自治体名の一部・自治体コード(6桁)・店舗コード
`limit`	任意	件数。1〜20(既定10)
`offset`	任意	0〜100

例: https://furusato-live.jp/api/v1/price-changes?direction=down&q=%E7%B1%B3

change は観測した時点の寄付額の変化です。現在の寄付額は donation_amount です。

自治体を探す

GET/api/v1/municipalities

自治体名の一部から、自治体コードと店舗コードを探します。返礼品の検索の municipality に使えます。

パラメーター	指定	内容
`q`	必須	自治体名の一部。例: 佐賀
`limit`	任意	件数。1〜20(既定10)

例: https://furusato-live.jp/api/v1/municipalities?q=%E4%BD%90%E8%B3%80

応答の項目

返礼品の検索・詳細・値動きの応答では、各品が次の項目を持ちます。

項目	内容
`item_code`	返礼品のコード。詳細の取得に使う
`page_url`	ふるさと納税LIVE の詳細ページ。最新の寄付額・単価・観測の記録を確認できる。出典・詳細として示す
`name`	返礼品の名前(掲載元のまま)
`donation_amount`	寄付額(円)。fetched_at の時点の値
`donation_range`	選べる形式の品の寄付額の幅。purchasable(申し込める選択肢)と all_options(すべての選択肢)の min / max
`has_options`	選べる形式の品か(選択肢によって寄付額が変わる)
`currency`	通貨(JPY)
`municipality`	自治体。code(自治体コード)・name(名前)・shop_code(店舗コード)
`review`	レビュー。count(件数)・average(評価の平均)
`available`	申し込めるか。false は売り切れ
`image_url`	掲載元の商品画像
`url`	申込ページ(楽天ふるさと納税。広告を含む)。改変・短縮せずに示す
`unit_price`	単価(寄付額 ÷ 内容量)。amount(円)・per(「kg」「L」「袋」など。amount は1perあたり)・unit(sort の unit に使う値)・quantity(内容量)・precision(exact は正確、estimated は選べる形式などの推定)・option_range(選択肢ごとの単価の幅)。内容量を読み取れない品は null
`delivery`	発送の目安(商品説明から読んだもの)。code(w1: 1週間以内 / w2: 2週間以内 / m1: 1か月以内 / m3: 1〜3か月先(予約)/ later: 3か月以上先(予約)/ past: 記載の時期が過ぎている / check: 記載なし / subscription: 定期便)・label(表示用)・notes(届く時期に幅あり・お届け日を選べる)。最新は申込ページで確認
`comparison_group`	比べるグループ。key(group に使う)・label(例: 牛肉(和牛・生肉(精肉)))・price_outlier(単価が極端で比較から除く品)。比べる対象でない品は null
`fetched_at`	当サイトがこの情報を取得した日時(ISO 8601)
`donation_observations`	(詳細のみ)過去の各時点で観測した寄付額と日時。現在の寄付額ではない
`events`	(詳細のみ)変化の記録。type は new(初めて観測)/ price_down / price_up / range_changed(選べる寄付額の幅の変化)/ soldout / restock / delisted(掲載終了)/ relisted / name_changed / content_changed
`change`	(値動きのみ)direction・before・after(寄付額)・change_rate(%)・observed_at(観測日時)

一覧の応答には、paging(limit・offset・次の offset。続きがなければ null)と meta(広告の注意・出典・この案内のURL)が付きます。

応答の例(返礼品の検索)を見る

{
  "data": [
    {
      "item_code": "f000000-example:10000001",
      "page_url": "https://furusato-live.jp/items/f000000-example%3A10000001",
      "name": "(返礼品の名前)",
      "donation_amount": 10000,
      "donation_range": {
        "purchasable": { "min": null, "max": null },
        "all_options": { "min": null, "max": null }
      },
      "has_options": false,
      "currency": "JPY",
      "municipality": { "code": "000000", "name": "(自治体名)", "shop_code": "f000000-example" },
      "review": { "count": 120, "average": 4.5 },
      "available": true,
      "image_url": "https://…",
      "url": "https://…(申込ページ・広告を含む)",
      "unit_price": { "amount": 2500, "per": "kg", "unit": "kg", "quantity": 4, "precision": "exact", "option_range": null },
      "comparison_group": { "key": "110472:rice_type=精米(白米)", "label": "白米(精米(白米))", "price_outlier": false },
      "fetched_at": "2026-09-27T01:00:00.000Z"
    }
  ],
  "paging": { "limit": 10, "offset": 0, "next_offset": 10 },
  "meta": {
    "notice": "このデータには広告(アフィリエイトリンク)が含まれます。…",
    "credit": "Supported by Rakuten Developers",
    "source": "楽天ふるさと納税(楽天ウェブサービス)",
    "docs": "https://furusato-live.jp/for-ai"
  }
}

利用者へ示すときのお願い

url は申込ページ(広告を含む)です。改変・短縮せず、そのまま示してください。
出典や詳細としては page_url を、申込先としては url を示してください。
寄付額は fetched_at の時点の情報です。最新の条件は申込ページで確認するよう伝えてください。
応答には広告(アフィリエイトリンク)が含まれることを、利用者に伝えてください。
控除上限額などの税の判断は、利用者自身の源泉徴収票などで確認するよう伝えてください。

エラー

状態	error	いつ
400	`invalid_parameter`	パラメーターが足りない・範囲外(message に理由)
404	`not_found`	該当する品がない、または情報が古い(取得から24時間超)
429	`rate_limited`	1分あたりの上限を超えた。Retry-After(秒)のあとに再度
500	`internal_error`	当サイトの障害

そのほか

観測日報と値下がりは RSSフィードでも受け取れます。
公開APIの利用条件は利用規約をご確認ください(出典の表示、申込先URLを改変しないこと、まとめての再配布は許可制など)。
当ページおよびAPIの応答は、アフィリエイトプログラムによる広告を含みます。
Supported by Rakuten Developers