TaxWise Calculator API

58종 한국 세무계산기 JSON API — CORS 허용·무료 사용·인증 불필요

✓ 무료 + CORS 허용 + 인증 불필요

외부 사이트·블로그·앱에서 자유롭게 호출하세요. API 토큰 발급 불필요.

엔드포인트

GET /api/calculators

58개 계산기 메타 + 카테고리 (JSON)

GET/POST /api/calculators/{slug}/calc

계산 실행 + 절세 추천

GET /api/indexnow?url={url}

IndexNow 핑 (Bing/Yandex/Naver)

예시: 종합소득세 계산

cURL

curl -G 'https://taxwise.guru/api/calculators/income-tax/calc' \
  --data-urlencode 'sale_income=200000000' \
  --data-urlencode 'sale_expense=80000000' \
  --data-urlencode 'dependents=2'

JavaScript (fetch)

const params = new URLSearchParams({
  sale_income: 200000000,
  sale_expense: 80000000,
  dependents: 2,
});
const res = await fetch(`https://taxwise.guru/api/calculators/income-tax/calc?${params}`);
const data = await res.json();
console.log(data.detail.summary); // 핵심 결과 카드

Python (requests)

import requests
r = requests.get('https://taxwise.guru/api/calculators/income-tax/calc', params={
    'sale_income': 200000000,
    'sale_expense': 80000000,
    'dependents': 2,
})
data = r.json()
print(data['detail']['summary'])

PHP

$params = http_build_query([
  'sale_income' => 200000000,
  'sale_expense' => 80000000,
]);
$json = file_get_contents("https://taxwise.guru/api/calculators/income-tax/calc?$params");
$data = json_decode($json, true);

응답 형식

{
  "ok": true,
  "slug": "income-tax",
  "name": "종합소득세 계산기",
  "input": { ... },
  "detail": {
    "steps": [
      { "label": "① 사업소득금액", "formula": "...", "value": 80000000, "unit": "원" },
      ...
    ],
    "summary": [
      { "label": "과세표준", "value": 76000000, "unit": "원" },
      { "label": "총 부담세액", "value": 19712000, "unit": "원", "primary": true }
    ],
    "notes": ["..."]
  },
  "tips": [
    { "title": "노란우산공제 한도 미사용", "desc": "...", "severity": "warning" }
  ],
  "meta": {
    "tax_year": 2026,
    "currency": "KRW",
    "engine": "TaxCalculatorDetail v1"
  }
}

제한 사항

· Rate limit: 분당 60회 (IP별)

· 응답 캐시: 5분 (동일 입력)

· CORS: Access-Control-Allow-Origin: *

· Content-Type: application/json; charset=utf-8

· 인증: 불필요 (현재). 향후 무료 API key 도입 가능

문의: api@taxwise.guru · iframe 임베드 빌더