郵便料金API

日本国内あての郵便の基本料金(税込)を返すAPIです。定形・定形外(規格内・規格外)の重さごとの料金と、はがき・往復はがき・ミニレター・スマートレター・レターパックライト/プラス・ゆうパケットの料金、それぞれのサイズ・重さの条件が分かります。

できること
10種類の料金表を一度に取る / 1種類の料金と条件を取る / 重さから定形外郵便の料金を出す(例)/ サイズから送れる種類を絞る
費用・登録
無料・登録不要・APIキー不要(提供条件は利用状況で変わることがあります)
向いている用途
ネットショップ・フリマの出品画面の送料の目安、発送の作業の手順書やツール、送料の比較
気をつけること
基本の料金だけです(速達・書留などのオプション、ゆうパック・クリックポストは含みません)。料金は日本郵便の改定に合わせて手で作り直します。止まらないことは保証していません。

データ: 日本郵便の料金表と照らし合わせて作成(照合した日は /postage/v1/meta.json の data_version で確認できます。今は 2026-11-16)

はじめかた(3ステップ)

  1. ブラウザで開いてみる: https://api.shirugear.com/postage/v1/rates.json を開くと、10種類の料金と条件が返ります。1種類だけなら /postage/v1/teikeigai_in.json(定形外・規格内)のように種類の名前を入れます。
  2. 重さから料金を選ぶ: 重さで料金が決まる種類(pricing が "by_weight")は、tiers を軽い順に見て、重さが max_g 以下の最初の区分の price です。重さから料金を出すにコードの例があります。
  3. 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。

いろいろな言語から呼ぶ

どの例も、定形外郵便(規格内)で重さ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.json10種類すべての料金と条件。約6KB(通信は圧縮されて約1.4KB)。中身
/postage/v1/{種類}.json1種類の料金と条件。種類は下の表のとおりです。例: /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まで)

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まで)

エラー

うまくいかないときは、HTTPの状態コードと、次の形の JSON を返します。code は固定の値なので、プログラムで見分けるときはこれを使ってください(message は説明文で、言い回しが変わることがあります)。

{"error":{"status":404,"code":"not_found","message":"この料金の種類はありません。…"}}
状態codeいつ
400invalid_requestURLの形が違う(種類に英小文字と _ 以外が入っている など。例: /postage/v1/Teikei.json)
403region_not_allowed日本国内以外から呼んだ(データは日本国内からのアクセスに限っています。説明ページは海外からも見られます)
404not_found無い種類(/postage/v1/foo.json など)
405method_not_allowedGET / HEAD 以外で呼んだ

データの出典・更新・キャッシュ

変更の方針と更新履歴

更新履歴

2026年11月16日
公開。

機械で読める仕様(型定義・OpenAPI)

このデータを使っているツール

シルギアの次のツールは、このAPIと同じデータで動いています。APIの答えを画面で確かめたいときや、使い方のイメージをつかみたいときにどうぞ。

このAPIと同じデータから作ったツール

よくある質問

本当に無料ですか?登録は必要ですか?

現在は無料で、登録やAPIキーも要りません。個人・法人、営利・非営利を問わず使えます。ただし利用状況に応じて提供条件を変えることがあり、そのときはできるかぎりこのページでお知らせします。

速達や書留の料金も入っていますか?

入っていません。このAPIが返すのは基本の料金だけです。速達・書留・特定記録などのオプションの料金は、日本郵便の料金表でご確認ください。

料金が改定されたら、いつ反映されますか?

日本郵便の料金の改定に合わせて、手で作り直します。料金表と照らし合わせた日を data_version で返すので、いつの料金か確かめられます。改定の日が分かっているときは、その日に切り替えます。

ゆうパック・クリックポストの料金は?

入っていません。ゆうパックは大きさと地域で料金が変わり、クリックポストは別の申し込みのサービスです。日本郵便の案内でご確認ください。

定形か定形外かは、どう決めればよいですか?

定形は、長さ14〜23.5cm・幅9〜12cm・厚さ1cm・重さ50gまでです。teikei の limits に入らなければ、規格内(teikeigai_in)、それにも入らなければ規格外(teikeigai_out)の条件と比べます。封筒の大きさから区分を見るなら、シルギアの封筒・郵便物サイズ早見も使えます。

アクセス数に上限はありますか?

決まった上限はありませんが、目安として1つの利用元から1秒あたり10回程度までにしてください。料金はめったに変わらないので、取ったデータは使い回してください。

ご利用にあたって

ご利用の前に利用規約をご確認ください。データの正確さや、止まらないことは保証していません。正式な料金は、日本郵便の料金表や郵便局の窓口でご確認ください。ご質問・不具合のご連絡は、シルギアのお問い合わせ窓口から、件名に「API」と入れてお送りください。