郵便料金API
日本国内あての郵便の基本料金(税込)を返すAPIです。定形・定形外(規格内・規格外)の重さごとの料金と、はがき・往復はがき・ミニレター・スマートレター・レターパックライト/プラス・ゆうパケットの料金、それぞれのサイズ・重さの条件が分かります。
- できること
- 10種類の料金表を一度に取る / 1種類の料金と条件を取る / 重さから定形外郵便の料金を出す(例)/ サイズから送れる種類を絞る
- 費用・登録
- 無料・登録不要・APIキー不要(提供条件は利用状況で変わることがあります)
- 向いている用途
- ネットショップ・フリマの出品画面の送料の目安、発送の作業の手順書やツール、送料の比較
- 気をつけること
- 基本の料金だけです(速達・書留などのオプション、ゆうパック・クリックポストは含みません)。料金は日本郵便の改定に合わせて手で作り直します。止まらないことは保証していません。
データ: 日本郵便の料金表と照らし合わせて作成(照合した日は /postage/v1/meta.json の data_version で確認できます。今は 2026-11-16)
はじめかた(3ステップ)
- ブラウザで開いてみる: https://api.shirugear.com/postage/v1/rates.json を開くと、10種類の料金と条件が返ります。1種類だけなら
/postage/v1/teikeigai_in.json(定形外・規格内)のように種類の名前を入れます。 - 重さから料金を選ぶ: 重さで料金が決まる種類(
pricingが"by_weight")は、tiersを軽い順に見て、重さがmax_g以下の最初の区分のpriceです。重さから料金を出すにコードの例があります。 - 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。
いろいろな言語から呼ぶ
どの例も、定形外郵便(規格内)で重さ120gの料金を出します。
const res = await fetch("https://api.shirugear.com/postage/v1/teikeigai_in.json");
const s = await res.json();
const weight = 120; // g
const tier = s.tiers.find((t) => weight <= t.max_g);
console.log(tier ? `${s.name} ${weight}g は ${tier.price}円` : `${s.weight_max_g}g を超えるので送れません`);
// → 定形外郵便物(規格内) 120g は 270円curl -s https://api.shirugear.com/postage/v1/teikeigai_in.json
# 120g の料金だけを出す(jq を使う場合)
curl -s https://api.shirugear.com/postage/v1/teikeigai_in.json \
| jq '[.tiers[] | select(120 <= .max_g)][0].price'<?php
$s = json_decode(file_get_contents('https://api.shirugear.com/postage/v1/teikeigai_in.json'), true);
$weight = 120;
foreach ($s['tiers'] as $t) {
if ($weight <= $t['max_g']) {
echo "{$s['name']} {$weight}g は {$t['price']}円\n";
break;
}
}import json
import urllib.request
url = "https://api.shirugear.com/postage/v1/teikeigai_in.json"
with urllib.request.urlopen(url, timeout=10) as res:
s = json.load(res)
weight = 120
tier = next((t for t in s["tiers"] if weight <= t["max_g"]), None)
print(f"{s['name']} {weight}g は {tier['price']}円" if tier else "重さの上限を超えています")その場で試す
重さから料金を出す
| 重さ | 料金(税込) |
|---|
はがき・レターパックなどの決まった料金の種類は、重さが上限以内なら同じ料金です。はがきは料金表のページに重さの上限が無いので、重さは見ずに料金だけを出します。
URLの一覧
どれも、URLを開く(GET)だけで JSON(UTF-8)が返ります。先頭は https://api.shirugear.com です。自分のサイトのJavaScriptから直接呼べます(CORS対応)。
| URL | 返すもの |
|---|---|
/postage/v1/rates.json | 10種類すべての料金と条件。約6KB(通信は圧縮されて約1.4KB)。中身 |
/postage/v1/{種類}.json | 1種類の料金と条件。種類は下の表のとおりです。例: /postage/v1/teikei.json(定形)。中身 |
/postage/v1/meta.json | データの版(照合した日)・出典・種類の一覧 |
| 種類(key) | 名前 | 料金(税込) |
|---|---|---|
teikei | 定形郵便物 | 50gまで 110円 |
teikeigai_in | 定形外郵便物(規格内) | 50gまで 140円 〜 1kgまで 750円(6区分) |
teikeigai_out | 定形外郵便物(規格外) | 50gまで 260円 〜 4kgまで 1,750円(8区分) |
hagaki | 通常はがき | 85円 |
ofuku | 往復はがき | 170円 |
minileter | ミニレター(郵便書簡) | 85円(25gまで) |
smartletter | スマートレター | 210円(1kgまで) |
lp_light | レターパックライト | 430円(4kgまで) |
lp_plus | レターパックプラス | 600円(4kgまで) |
yu_packet | ゆうパケット | 360円(厚さ3cm以内・1kgまで) |
- 上の表の料金は 2026-11-16 に日本郵便の料金表と照らし合わせた値です。プログラムでは表の数字を写さず、APIの値を使ってください。
- 無い種類(
/postage/v1/foo.jsonなど)は 404、英小文字と_以外が入っているものは 400 です。 - 呼び出しは
GET(またはHEAD)だけです。独自のヘッダを付けずに呼んでください。
1種類の料金と条件
応答の例
GET https://api.shirugear.com/postage/v1/teikeigai_in.json
{
"key": "teikeigai_in",
"name": "定形外郵便物(規格内)",
"group": "letter",
"pricing": "by_weight",
"price": null,
"tiers": [
{ "max_g": 50, "price": 140 },
{ "max_g": 100, "price": 180 },
{ "max_g": 150, "price": 270 },
{ "max_g": 250, "price": 320 },
{ "max_g": 500, "price": 510 },
{ "max_g": 1000, "price": 750 }
],
"weight_max_g": 1000,
"limits": { "long_min_mm": null, "long_max_mm": 340, "short_min_mm": null, "short_max_mm": 250,
"thickness_max_mm": 30, "sum_max_mm": null, "weight_max_g": 1000 },
"note": "定形を超えるもののうち、長辺34cm・短辺25cm・厚さ3cm以内、重さ1kgまで。",
"source": { "label": "日本郵便「手紙・はがきの料金」", "url": "https://www.post.japanpost.jp/send/domestic/charge/list/one_two.html" },
"currency": "JPY",
"tax": "included",
"data_version": "2026-11-16"
}
各項目
| 項目 | 型 | 内容 |
|---|---|---|
key | 文字列 | 種類(URLに入れる名前) |
name | 文字列 | 日本郵便の呼び名 |
group | 文字列 | 分類。"letter"(定形・定形外)・"postcard"(はがき)・"envelope"(専用の封筒・書簡)・"parcel"(ゆうパケット) |
pricing | 文字列 | "by_weight"=重さの区分で料金が決まる(tiers を見る)、"flat"=決まった料金(price を見る) |
price | 数値 または null | 決まった料金(円・税込)。by_weight のときは null |
tiers | 配列 または null | 重さの区分を軽い順に。max_g(その重さまで・g)と price(円・税込)。flat のときは null |
weight_max_g | 数値 または null | 送れる重さの上限(g)。料金表に上限の記載が無いもの(はがき)は null |
limits | オブジェクト または null | サイズ・重さの条件(mm・g)。long_min_mm・long_max_mm(長辺)、short_min_mm・short_max_mm(短辺)、thickness_max_mm(厚さ)、sum_max_mm(長辺+短辺+厚さの合計)、weight_max_g(重さ)。決まりが無い項目は null。はがきは null |
note | 文字列 | 条件の説明(日本郵便のページの記載をもとにした短い文) |
source | オブジェクト | 照らし合わせた日本郵便のページ(label・url) |
currency・tax | 文字列 | いつも "JPY"・"included"(税込) |
data_version | 文字列 | データの版。日本郵便のページと照らし合わせた日("YYYY-MM-DD") |
全部と版(rates.json・meta.json)
/postage/v1/rates.json
{
"services": [
{ "key": "teikei", "name": "定形郵便物", "pricing": "by_weight", "tiers": [{ "max_g": 50, "price": 110 }], … },
{ "key": "teikeigai_in", … },
…
{ "key": "yu_packet", "name": "ゆうパケット", "pricing": "flat", "price": 360, … }
],
"currency": "JPY",
"tax": "included",
"data_version": "2026-11-16"
}
services の1件ずつは、1種類の応答から currency・tax・data_version を除いたものです。
/postage/v1/meta.json
| 項目 | 内容 |
|---|---|
data_version・checked_at | 日本郵便のページと照らし合わせた日("YYYY-MM-DD") |
scope | 入っている範囲の説明 |
services | 種類(key)の一覧 |
counts | 件数(services=種類の数) |
sources | 照らし合わせた日本郵便のページ(label・url) |
重さから料金を出す
重さで料金が決まる種類は、tiers を軽い順に見て、重さが max_g 以下(ちょうどの重さを含む)の最初の区分の料金です。たとえば定形外(規格内)で100gちょうどなら180円、101gなら270円です。
/** 種類 s(APIの1件)と重さ(g)から料金(円)を返す。送れないときは null */
function priceFor(s, weightG) {
if (s.weight_max_g !== null && weightG > s.weight_max_g) return null; // 重さの上限を超える
if (s.pricing === "flat") return s.price;
const tier = s.tiers.find((t) => weightG <= t.max_g);
return tier ? tier.price : null;
}
const { services } = await (await fetch("https://api.shirugear.com/postage/v1/rates.json")).json();
const byKey = Object.fromEntries(services.map((s) => [s.key, s]));
console.log(priceFor(byKey.teikeigai_in, 100)); // → 180
console.log(priceFor(byKey.teikeigai_in, 101)); // → 270
console.log(priceFor(byKey.teikeigai_out, 3000)); // → 1750
console.log(priceFor(byKey.teikeigai_in, 1200)); // → null(規格内は1kgまで)
- 定形・定形外(規格内・規格外)のどれになるかは、重さだけでなくサイズでも決まります。
limitsの長辺・短辺・厚さ・合計と比べて、小さいほうから順に(定形→規格内→規格外)入るものを選んでください。 - 重さは小数のまま比べて構いません(50.5g は50gの区分を超えます)。
- このAPIの料金は目安です。実際の料金は窓口・日本郵便の案内でご確認ください。
エラー
うまくいかないときは、HTTPの状態コードと、次の形の JSON を返します。code は固定の値なので、プログラムで見分けるときはこれを使ってください(message は説明文で、言い回しが変わることがあります)。
{"error":{"status":404,"code":"not_found","message":"この料金の種類はありません。…"}}
| 状態 | code | いつ |
|---|---|---|
| 400 | invalid_request | URLの形が違う(種類に英小文字と _ 以外が入っている など。例: /postage/v1/Teikei.json) |
| 403 | region_not_allowed | 日本国内以外から呼んだ(データは日本国内からのアクセスに限っています。説明ページは海外からも見られます) |
| 404 | not_found | 無い種類(/postage/v1/foo.json など) |
| 405 | method_not_allowed | GET / HEAD 以外で呼んだ |
データの出典・更新・キャッシュ
- 出典: 日本郵便「手紙・はがきの料金」(定形・定形外・はがき・ミニレター・スマートレター・レターパック)と「ゆうパケット」の記載と照らし合わせて作っています。種類ごとの照らし合わせたページは
sourceにあります。 - シルギアのツールと同じ表: 郵便料金の早見と同じ料金表から作っています(どちらかだけが変わることはありません)。
- 対象: 日本国内あての基本の料金(税込)だけです。速達・書留などのオプション、ゆうパック・ゆうメール・クリックポスト、国際郵便は含みません。
- データの版(
data_version): 日本郵便のページと照らし合わせた日です(今は 2026-11-16)。 - 更新: 日本郵便の料金の改定に合わせて手で作り直します(毎日の自動更新ではありません)。
- キャッシュ: 応答は1日(エラーは1時間)キャッシュしてかまいません。
ETag/Last-Modifiedに対応しているので、変わっていなければ 304 が返ります。 - 呼び出し回数の目安: 決まった上限はありませんが、1つの利用元から1秒あたり10回程度までにしてください。
rates.jsonを1回取って使い回すのがおすすめです。
変更の方針と更新履歴
- v1 の中では、項目や種類を足すことはあっても、今ある項目の名前や意味は変えません。知らない項目・種類が増えていても無視するように作ってください。料金の値は改定で変わります。
- 互換性のない変更は、URLの版を分けて(
/postage/v2/など)行います。v1 を終わらせるときは、できるかぎり6か月以上前にこのページでお知らせします。 - 提供条件(無料・登録不要・アクセス回数の上限など)は、利用状況に応じて変えることがあります(利用規約第4条)。
更新履歴
- 2026年11月16日
- 公開。
機械で読める仕様(型定義・OpenAPI)
- TypeScript の型定義:
/postage/types.d.ts - OpenAPI 3.1:
/postage/openapi.json
このデータを使っているツール
シルギアの次のツールは、このAPIと同じデータで動いています。APIの答えを画面で確かめたいときや、使い方のイメージをつかみたいときにどうぞ。
このAPIと同じデータから作ったツール
よくある質問
本当に無料ですか?登録は必要ですか?
現在は無料で、登録やAPIキーも要りません。個人・法人、営利・非営利を問わず使えます。ただし利用状況に応じて提供条件を変えることがあり、そのときはできるかぎりこのページでお知らせします。
速達や書留の料金も入っていますか?
入っていません。このAPIが返すのは基本の料金だけです。速達・書留・特定記録などのオプションの料金は、日本郵便の料金表でご確認ください。
料金が改定されたら、いつ反映されますか?
日本郵便の料金の改定に合わせて、手で作り直します。料金表と照らし合わせた日を data_version で返すので、いつの料金か確かめられます。改定の日が分かっているときは、その日に切り替えます。
ゆうパック・クリックポストの料金は?
入っていません。ゆうパックは大きさと地域で料金が変わり、クリックポストは別の申し込みのサービスです。日本郵便の案内でご確認ください。
定形か定形外かは、どう決めればよいですか?
定形は、長さ14〜23.5cm・幅9〜12cm・厚さ1cm・重さ50gまでです。teikei の limits に入らなければ、規格内(teikeigai_in)、それにも入らなければ規格外(teikeigai_out)の条件と比べます。封筒の大きさから区分を見るなら、シルギアの封筒・郵便物サイズ早見も使えます。
アクセス数に上限はありますか?
決まった上限はありませんが、目安として1つの利用元から1秒あたり10回程度までにしてください。料金はめったに変わらないので、取ったデータは使い回してください。
ご利用にあたって
ご利用の前に利用規約をご確認ください。データの正確さや、止まらないことは保証していません。正式な料金は、日本郵便の料金表や郵便局の窓口でご確認ください。ご質問・不具合のご連絡は、シルギアのお問い合わせ窓口から、件名に「API」と入れてお送りください。