🔌 Free Calculator API

Kuongorora

API inoshanda nematekisi akafanana neaya ayo webhusaiti inoshandisa. Tsanangura mavara enzvimbo yechikwereti separameter yechikwereti kana JSON uye uwane zviwanikwa zvakanyorwa seJSON — kusanganisira chero nguva yekubhadharisa kana data remufananidzo iro chikwereti chinogadzira.

• 198+ calculators, mumwe nomumwe ne endpoint yake
• Hapana API key — anonymus access, rate-limited by IP
• CORS — Access-Control-Allow-Origin: * (usable client-side)
• Kuwedzera: 60 zvikumbiro/awa per IP (HTTP 429 kana yakakwira)
• Maitiro akasununguka — chete a kubudirira (2xx) mashoko anoshandisa imwe kufona kubva yako yemwedzi quota. Every 400, 401, 404, 429 uye 500 zvinokubhadharisa chero chinhu.

Chikamu che URL

https://calculator.free/api/v1/

Index — kuratidza chero calculator

GET https://calculator.free/api/v1/

Inodzosera mashoko anoverenga nechigadzirwa chemachina ezvinyorwa zvese zvema calculators nenzvimbo dzese dzese (key, label, type, default, unit) uye zviratidzo zvemhedzisiro — zvakakwana kuti uite mushandisi nesimba. Each field also carries a required flag — true for the few fields that have no default (dates, mostly). Send those: a couple of calculators can infer one, the rest answer 400 without it.

Calculator

GET  https://calculator.free/api/v1/<slug>/?field=value&field=value
POST https://calculator.free/api/v1/<slug>/     (JSON or form body)

Kudzokera kumusoro

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... the values actually computed with ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null,
  "defaults_applied": ["tax", "insurance"]
}

Country-aware calculators (mortgage, mari, income-tax, sales-tax...) kubvuma ?country=us|uk|ca|au|in|ie|nz|za. Unknown slug anodzokera 404; unsupported nyika kana bad input anodzokera 400 nemashoko anokosha uye nzvimbo spec.

Parameter, defaults uye errors

Kutumira chete maindasitiri iwe unofarira. Chii chero iwe kubvisa ari kupfurwa neiyo indasitiri's published default - iyo imwecheteyo kukosha calculator peji prefills, saka API uye website nguva dzose kudzokera zvakafanana nhamba yezvimwe zviwanikwa. defaults_applied.

Kana paine chero chinhu API haigone kubvisa zvakarurama, izvi zvinonzi zvikanganiso, kwete zero: zvakaipa zvakanyorwa parameter, kukosha kwemhando isina kururama, sarudzo yekuwedzera-pasi, kana kushaya kwenzvimbo isina default (data nzvimbo — zuva rekuzvarwa risingagone kufungidzirwa). Every 400 anoita zita reparameter inoshungurudza uye inodzokorora zvese zvenzvimbo spec kuti mushandisi akwanise kugadziridza.

$ curl "https://calculator.free/api/v1/mortgage/?price=350000&rate=6.5&term=30"
{
  "ok": false,
  "error": "unknown_parameter",
  "message": "Unknown parameter 'term' for calculator 'mortgage'. Did you mean 'years'? ...",
  "unknown_parameters": ["term"],
  "did_you_mean": { "term": "years" },
  "valid_parameters": ["down", "extra", "extra_onetime", "extra_yearly", "hoa",
                       "insurance", "other", "pmi", "price", "rate", "tax", "years"],
  "fields": [ ... ]
}

The /api/v1/ index inoburitsa chiratidzo chese chemunda, mhando, unit, default uye kana ichida kupihwa - zvakakwana kuti uite mushandisi asingafungi.

Kuzivana & mapurogiramu

Iwe unogona kukumbira API pasina bhatani chero kupi zvako - zvikumbiro zvisina zita zvinorambidzwa neIP. Kuti uwane huwandu hwakanyanya, hwakavimbika hwemwedzi (uye kushandiswa kwekutengesa), gadzira bhatani pawebhusaiti yako yeaccount uye tumira imwe yenzira mbiri:

GET  https://calculator.free/api/v1/mortgage/?price=350000&key=YOUR_KEY
curl -H "Authorization: Bearer YOUR_KEY" "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"
curl -H "X-Api-Key: YOUR_KEY"           "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"

• Free — anozivikanwa (IP rate-limited) kana chiratidzo chemahara nechidiki chikwereti chemwedzi. Non-commercial.
• Developer — $9/mwedzi — 10,000 calls/month, commercial use.
• Business — $49/mwedzi — 100,000 calls/month, priority throughput.

Chii chinobata pa quota yako

One 2xx = one call. Every error is free: a 400 for a misspelled parameter, a bad value or a missing required field, a 404 for an unknown slug, a 401 for a bad key, a 429, and anything that goes wrong on our side. Explore the contract and fix your request as many times as you need — you are billed for answers, not for corrections.

Nekuti matambudziko ari free ivo vari rate-yakavharwa pamusoro: kana imwe kiyi zvinokonzera kupfuura 200 kana webhusaiti yako yakasiiwa mazano munguva yeawa, inowana HTTP 429 "too_many_invalid_requests" kusvika nguva ichiri kukwira. Kubudirira kwezvikumbiro hazvina kusanganisira kumusoro, saka kubatanidzwa kwebasa hazvizozviona - zvinongowana chete mutengi akasungwa munzira yekuedza.

Kana chiratidzo chemwedzi chichishandiswa, API inodzosera HTTP 429 nematambudziko "quota_exceeded"; chiratidzo chisina kuzivikanwa kana chisina kushanda chinodzosera HTTP 401. Ona mapurogiramu ese uye nyora pasi pa Kubhadhara peji.

Mifananidzo

curl

curl "https://calculator.free/api/v1/mortgage/?price=350000&down=70000&rate=6.9&years=30"

JavaScript fetch()

const r = await fetch(
  "https://calculator.free/api/v1/bmi/?" + new URLSearchParams({
    units: "metric", height: "180", weight: "80"
  }));
const { results } = await r.json();
console.log(results.bmi, results.category);

Python

import requests

r = requests.get("https://calculator.free/api/v1/mortgage/",
                 params={"price": 350000, "down": 70000,
                         "rate": 6.9, "years": 30},
                 headers={"Authorization": "Bearer YOUR_KEY"})
print(r.json()["results"])

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

All endpoints

One endpoint per calculator. Field keys uye result keys for each are in the /api/v1/ index.