Free Calculator API
Duk wani kalkuleta a kan wannan shafin yana da API na JSON kyauta. Babu rajista, babu maɓallin API, CORS-da aka kunna - kira shi daga mai ba da sabis ɗinka ko kai tsaye daga mai bincike.
Overview
API na tafiyar da daidaitattun ma'adanai da shafin yanar gizo ke amfani da su. Ka aika da kimar fannin wani kalkuleta kamar paramita na tambaya ko JSON kuma ka samu sakamakon da aka lissafa a baya kamar JSON - ciki har da duk wani lokaci na lissafin ko bayanan tsare-tsaren da kalkuleta ke samarwa.
- 198+ calculators, each with its own endpoint
- Babu maɓallin API — anonymous access, rate-limited by IP
- CORS —
Access-Control-Allow-Origin: *(mai amfani da sashin mai amfani da shi) - Rate limit: 60 requests/hour per IP (HTTP 429 when exceeded)
- Errors are free — only a successful (2xx) response uses one call from your monthly quota. Every 400, 401, 404, 429 and 500 costs you nothing.
URL na farko
https://calculator.free/api/v1/
Inuwar — lissafa kowace calculator
GET https://calculator.free/api/v1/
Mai mayar da jerin masu karantawa da injin na dukkan calculators tare da fannoni na kowace daya (maɓalli, label, nau'i, default, unit) da maɓallan sakamakon - da yawa don gina wani mai amfani da hanzari. 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.
Compute — run one calculator
GET https://calculator.free/api/v1/<slug>/?field=value&field=value
POST https://calculator.free/api/v1/<slug>/ (JSON or form body)
Response shape:
{
"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"]
}
Ka yi yarda da calculators na kasa-aware (haɗari, bashi, kudin shiga, kudin sayarwa...) ?country=us|uk|ca|au|in|ie|nz|za. Unknown slug returns 404; unsupported country or bad input returns 400 with a helpful message and the field spec.
Parameters, defaults and errors
Send only the fields you care about. Anything you leave out is filled with that field's published default — the same value the calculator page pre-fills, so the API and the website always return the same numbers for the same inputs. Each response lists what it filled in under defaults_applied.
Anything the API cannot resolve honestly is an error, never a zero: a misspelled parameter, a value of the wrong type, an unknown dropdown option, or a missing field that has no default (the date fields — a birth date cannot be guessed). Every 400 names the offending parameter and echoes the full field spec so a client can correct itself.
$ 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": [ ... ]
}
| error | HTTP | Dakata |
|---|---|---|
unknown_parameter | 400 | a parameter that is not a field of this calculator (with a did-you-meant suggestion) |
invalid_value | 400 | wani fannin adadi wanda bai zama adadi ba, kimar dropdown a waje da zaɓukansa, wata ranar da ba a iya rarrabawa, ko kuma _moɗa da ba a sani ba |
missing_parameter | 400 | %s: Kalkulator ɗin bai samar da wata sakamakon ba saboda an bar wani fili da ba shi da diff ba cikin ɓoye |
unsupported_country | 400 | ?country= ba shi da wani wannan calculator yana da bayanai a gare shi |
bad_json | 400 | the POST body is not valid JSON |
unknown_calculator | 404 | no calculator with that slug |
invalid_key | 401 | an aika maɓallin API amma ba a san shi ba ko kuma bai aiki ba |
rate_limited / quota_exceeded | 429 | an yi amfani da iyakar IP na sa'a na ba-na-sani, ko kuma adadin wata na maɓalli |
too_many_invalid_requests | 429 | %s: An ki yarda da wasu bukatun da yawa cikin sa'a guda ga wannan maɓalli - kiraye-kiraye da aka ki yarda da su suna da kyauta, don haka ana iya hana su ta hanyar adadin. Ana sake saita su a kowace sa'a; kiran da aka yi nasara ba su taba yin adadin zuwa gare shi ba. |
Dakata /api/v1/ %s: Indir na wallafa maɓallin kowace fili, nau'i, yunit, diff da ko an bukata shi — da yawa don gina mai amfani da ba zai taba tsammani ba.
Authentication & plans
Za ka iya kira API da ba tare da maɓalli ba a duka — tambayoyin da ba a sani ba suna da iyaka da IP. Don wani girma, da za'a iya tsammani na watanni (da amfanin kasuwanci), ƙirƙiri maɓalli a kan shafi na asusunka kuma ka aika shi cikin ɗaya daga cikin hanyoyi uku:
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 — %s: ba a san sunansa ba (IP mai iyaka da gudummawa) ko maɓalli mai kyauta da adadin watanni kaɗan. Ba na kasuwanci.
- Developer — $9/mo — 10,000 kira/wata, amfanin kasuwanci.
- Business — $49/mo — 100,000 kira/wata, fifiko ta hanyar.
What counts against your quota
Hanya daya kawai ta amsa da nasara take yi. 2xx daya = kira daya. Duk wani kuskure yana da kyauta: 400 ga wani paramita da aka canza rubutunsa, wata kimar da ba ta da kyau ko wani yanki da ake bukata da ya ɓace, 404 ga wani slug da ba a sani ba, 401 ga wata maɓalli da ba ta da kyau, 429, da duk wani abu da ya yi illa a gefenmu. Bincika yarjejeniyar kuma gyara bukatunka sau da yawa kamar yadda kake bukata — ana biyanka kudin amsoshin, ba na gyaran ba.
Saboda kurakurai suna da kyauta suna da tsada-ƙasa a matsayinsu: idan maɓalli ɗaya ya haifar da fiye da 200 %s: An ki yarda da amsa cikin sa'a, yana samun HTTP 429 "too_many_invalid_requests" har sai sa'a ta wuce. Zaɓuɓɓukan da suka ci nasara ba su lissafa ba zuwa wannan, don haka wata haɗin gwiwa mai aiki ba za ta gani ba — tana kawai kama mai amfani da ya rufe cikin wani yunƙurin sake yi na loop.
Idan an yi amfani da kwatancen wata na maɓalli, API na mayar da HTTP 429 tare da kuskure "quota_exceeded"; maɓalli da ba a sani ba ko mara aiki na mayar da HTTP 401. Ka duba shirin da ka yi rajista a kan Pricing shafi.
Examples
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
Maɓallin fanni da maɓallin sakamakon ga kowanne suna cikin /api/v1/ Indir.
Finance (41)
Tax & Salary (2)
Health & Fitness (28)
Math (26)
Statistics (15)
Unit Converters (17)
Science & Engineering (27)
Date & Time (15)
Everyday (27)
Results are estimates for general guidance only, not financial, medical or tax advice.