ForHosting KIT · 金融・お金

米国世帯所得パーセンタイル

世帯年収80000は50パーセンタイルで、ちょうど中央値です。米国の世帯の半分がこれより少なく稼いでいます。世帯の年収を入力すると、全国での順位が分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

収入: 80,000

結果

パーセンタイル: 50
丸めたパーセンタイル: 50
階数: 50th
下位の割合: 50

米国世帯所得のパーセンタイル計算機は、額面の給与だけでは決して答えられない問いに応じます。この年間世帯所得は、米国の世帯のどこに位置するのか。求人、転居の議論、住宅ローンの会話、家計記事はいずれもドル額を引用しますが、その額は、より少なく稼ぐ世帯がどれだけあるかが分かって初めて比較できます。本ツールは非負の年間所得（米ドル）を受け取り、固定の内蔵世帯所得分布表で照合し、隣り合う節点のあいだを線形補間し、0から100までのパーセンタイル順位を返します。

内蔵の世帯所得表がパーセンタイルになる仕組み

米国の世帯所得分布は累積曲線です。各ドル額において、その額より少なく稼ぐ世帯の割合があります。その割合を 0 から 100 で表したものがパーセンタイル順位です。

生きた調査は毎年曲線を改訂しますが、要求のたびに新しい表を取得する計算機は非決定的になり、かつネットワークが必要です。0 ドルが第 0 パーセンタイル、中央値がおよそ八万ドルで第 50、二十五万ドル付近が第 90、百万ドルの世帯が第 99.5 付近です。年間所得が与えられると、ソルバーはそれを挟む隣り合う二つの節点を見つけ、線形に補間します。

恒等式は、P が P_lo に、分数 (income − I_lo) / (I_hi − I_lo) を掛けた (P_hi − P_lo) を加えたものです。節点ちょうどに載る所得は補間せず、その節点のパーセンタイルを返します。最後の表載節点を超える所得は、測っていない裾を作らず、最後の表載パーセンタイルで頭打ちにします。

所得 0 は第 0 パーセンタイルに対応します。

米国所得パーセンタイル計算機が役立つ場面

「米国所得パーセンタイル」や「世帯所得パーセンタイル」を探す人は、すでにドル額を持っており、税額でも時給換算でも、自分で上げる任意標本の第 k パーセンタイルでもなく、順位を求めています。求人比較は転居を受ける前に使います。十二万五千ドルは、全国世帯の順位では税ブラケットと同じ数字とは別の絵になります。

実装は凍結表を持つ parse の A 区分の解析コードであるため、成功呼び出しはモデルトークンも外向き通信もなく安く済みます。検証失敗は残高を消費しません。

活用例

求人と転居の順位づけ

オファーや都市、共働き計画を比べる前に、世帯の年額を全国パーセンタイルへ変換します。

家計解説の裏付け

出版社と記者は、ぼんやりした富裕・貧困のラベルではなく、引用した給与の横に再現可能な世帯順位を付けられます。

よくある質問

米国の世帯所得パーセンタイルはどう計算されますか？

ソルバーは年間所得を固定の内蔵世帯 CDF 表で照合し、隣り合う二つの節点のあいだを線形補間します。ちょうど節点に載ればそのパーセンタイルを返し、最後の節点を超える所得は最後の表載パーセンタイルで頭打ちにします。

個人の給与と世帯所得のどちらを入れるべきですか？

内蔵表が表す量である、米ドル建ての年間世帯所得を入れてください。個人賃金も送れますが、順位は労働者別の所得表ではなく、世帯分布に対して読まれます。

所得が負または欠落しているとどうなりますか？

パーセンタイル順位は非負の有限数にだけ定義され、欠落、空、NaN、Infinity、負の値は課金されません。

今年の Census の生データですか？

全国世帯の様式化曲線であり、ACS や CPS の生取得ではありません。

表の上限を超える年収はどうなりますか？

表の最後のパーセンタイルにとどまります。測定されていない上の範囲を作り出さないためです。年収0は0パーセンタイルになります。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/fin/us-income-percentile

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/fin/us-income-percentile \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"income":80000}'

const res = await fetch("https://api.kit.forhosting.com/fin/us-income-percentile", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "income": 80000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/us-income-percentile",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "income": 80000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/us-income-percentile", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"income":80000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"income":80000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/us-income-percentile", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "income": 80000
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.us_income_percentile",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

max_abs 1000000000000000

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

欠落、負値、非有限の所得は invalid_input となり、課金されません。成功した呼び出しは $0.002 で課金されます。

入力契約、エラー、応答の形

income は米ドル建ての米国世帯の年間所得です。公表上限を超える大きさも失敗します。例: 八万ドルは中央値の節点に載り、percentile 50、rank 50th、band middle を返します。二十二万五千ドルは二十万と二十五万の節点の中間にあり、percentile 87 を返します。地域の生活費が必要なら順位に独自の注記を添えてください。この端点は全国世帯表に対してのみ順位付けします。必須フィールドを一つ持つ JSON 本体を POST してください。非負の有限数でなければならず、給与行の rename が不要になるよう annual_income、household_income、amount、salary の別名を受け付けます。JSON 数値が望ましく、有限小数として解釈できる数値文字列も受け付けます。欠落、空文字、NaN、Infinity、非数値、負の金額はフィールド名付きの invalid_input となり課金されません。この表では負の世帯所得にパーセンタイルが定義されないためです。成功時は income をエコーし、0–100 尺度の補間順位 percentile、最も近い整数 percentile_rounded、その整数の英語序数 rank（例: 50th や 91st）、percentile に等しい share_below、100 から percentile を引いた share_above、そして bottom_20、lower_middle、middle、upper_middle、top_20、top_10、top_5、top_1 といった粗い帯 band を返します。応答は挟む節点 lower_income、lower_percentile、upper_income、upper_percentile、method linear_interpolation、および答えの横に出せる formula 文字列も示します。成功した一件の料金は一律 $0.002 です。

米国所得パーセンタイル計算機が役立つ場面

消費者数学の授業は分布の課題を出し、負の所得を黙って 0 に切り捨てず invalid_input と印す神託を必要とします。報酬ダッシュボードと家計ノートは、Census のダウンロード配管を立てずに、成功一件あたり $0.002 で同じ契約を呼びます。要求を小さく保ち、補間パーセンタイルをテストに固定すれば、今年の調査ミクロデータだと偽らずに、記事・内定通知・軽い家計 webhook 向けの再現可能な米国世帯順位が得られます。

連携の活用例

授業の分布課題

負の所得を invalid_input として拒み、安定したパーセンタイルを返す決定的な神託で、消費者数学の設問を採点します。

技術的な質問

米国所得パーセンタイル計算機の料金はいくらですか。

ブラウザのツールは無料です。API 要求は成功した呼び出しごとに $0.002 で課金され、無効な入力は課金されません。

KITの完全なドキュメントを見る →

米国世帯所得パーセンタイル

無料で実行

計算例

内蔵の世帯所得表がパーセンタイルになる仕組み

米国所得パーセンタイル計算機が役立つ場面

活用例

求人と転居の順位づけ

家計解説の裏付け

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

制限

エラー

技術的な注記

入力契約、エラー、応答の形

米国所得パーセンタイル計算機が役立つ場面

連携の活用例

授業の分布課題

技術的な質問

ありがとう