Desh API: বাংলাদেশের প্রতিদিনের ডেটার জন্য একটি ফ্রি API
বাংলাদেশের প্রায় সব ডেভেলপারই একই জিনিস বারবার বানিয়েছেন: পুরনো কোনো spreadsheet থেকে বিভাগ → জেলা → উপজেলা dropdown, ইনভয়েসের জন্য "টাকা কথায়", Bijoy থেকে Unicode কনভার্টার, ফোন নম্বরের regex, ব্যাংক-শাখা বাছাই, আয়কর ক্যালকুলেটর। ক্লায়েন্ট প্রজেক্টের জন্য আমি নিজেই এগুলোর বেশিরভাগ একাধিকবার বানিয়েছি।
তাই সবগুলোকে একটি পরিষ্কার, ডকুমেন্টেড API-তে এনেছি, যেটা যে কেউ ফ্রিতে ব্যবহার করতে পারবেন: deshapi.riadul.com।
কোনো sign-up নেই, API key নেই, নাম ইংরেজি ও বাংলায়, আর প্রতিটি response-এ প্রতিটি তথ্যের সূত্র।
🚀 ভেতরে কী আছে
এখন পর্যন্ত ১৫টি মডিউল আর ৬৮টি endpoint:
| মডিউল | কী পাবেন |
|---|---|
| Geo | ৮টি বিভাগ, ৬৪টি জেলা, ৪৯৫টি উপজেলা, ৪,৫৪০টি ইউনিয়ন, ১,৩৪৯টি পোস্ট অফিস; দুই ভাষায় সার্চ (পুরনো বানানেও, যেমন "Comilla"); GPS পয়েন্টের সবচেয়ে কাছের এলাকা |
| বাংলা টুলকিট | সংখ্যা ও টাকা কথায়, ইংরেজি ⇄ বাংলা অঙ্ক, লাখ/কোটি ফরম্যাট (১২,৫০,০০০), বাংলা সন-তারিখ, ক্রমবাচক সংখ্যা, slug, Avro Phonetic |
| Convert | Bijoy (SutonnyMJ) ⇄ Unicode |
| ফোন ও ভ্যালিডেটর | মোবাইল নম্বর (মূল অপারেটরসহ), আর NID, গাড়ির নম্বরপ্লেট, e-TIN, VAT BIN, পোস্টকোড ও ব্যাংক রাউটিং নম্বরের ফরম্যাট যাচাই |
| ব্যাংক | বাংলাদেশ ব্যাংকের তালিকা থেকে ৬১টি ব্যাংক ও ১১,৫৩৩টি শাখা, আর "এই রাউটিং নম্বর কোন শাখার?" |
| শিক্ষা | বিশ্ববিদ্যালয় মঞ্জুরি কমিশনের তালিকাভুক্ত ১৮১টি বিশ্ববিদ্যালয় |
| ছুটি | ২০২৭ সালের সরকারি ছুটির তালিকা, "আজ কি ছুটি?" আর কর্মদিবস গণনা |
| ফাইন্যান্স | অর্থ আইন ২০২৬ অনুযায়ী আয়কর (সব করদাতা শ্রেণি, বেতনের অব্যাহতি, বিনিয়োগ রেয়াত), VAT, লোনের EMI, DPS, গ্র্যাচুইটি |
| সোনা ও যাকাত | BAJUS-এর আজকের সোনা ও রুপার দাম প্রতি গ্রাম ও প্রতি ভরিতে, আর সেই দাম থেকে নিসাব ধরে যাকাত |
| বাজারদর | ঢাকায় ৬০টি নিত্যপণ্যের TCB-র আজকের খুচরা দাম, সপ্তাহ/মাস/বছরের তুলনাসহ, আর সরকারি জ্বালানি তেলের দাম |
| জমি, হটলাইন, মক ডেটা, মজা | কাঠা/বিঘা/শতাংশ রূপান্তর, জাতীয় হটলাইন, টেস্টের জন্য কৃত্রিম ব্যক্তি, প্রচলিত প্রবাদ ও ধাঁধা |
⚡ ৩০ সেকেন্ডে চালিয়ে দেখুন
এগুলোর যেকোনোটা টার্মিনাল বা ব্রাউজারে পেস্ট করুন:
# একটি জেলা, ইংরেজি ও বাংলায়
curl https://deshapi.riadul.com/v1/districts/cumilla
# ইনভয়েসের জন্য টাকা কথায়
curl 'https://deshapi.riadul.com/v1/bangla/taka-in-words?amount=1250.50'
# → "এক হাজার দুইশত পঞ্চাশ টাকা পঞ্চাশ পয়সা"
# এই রাউটিং নম্বর কোন শাখার?
curl https://deshapi.riadul.com/v1/routing/010130065
# → Agrani Bank, Kachua Bazar branch, Kachua, Chandpur
# ১৮ লাখ টাকা বেতনে আয়কর (অর্থ আইন ২০২৬)
curl 'https://deshapi.riadul.com/v1/finance/income-tax?income=1800000&employment_income=1800000'
# ঢাকায় আজকের ভোজ্যতেলের দাম (TCB)
curl 'https://deshapi.riadul.com/v1/market/prices?category=edible-oil'ইন্টারঅ্যাকটিভ ডকসে প্রতিটি endpoint "Try it" বাটনসহ দেওয়া আছে, আর ল্যান্ডিং পেজে একটি playground আছে।
🔎 প্রতিটি তথ্যের সূত্র আছে
প্রতিটি response একই রকম দেখতে, আর meta.source বলে দেয় ডেটা কোথা থেকে এসেছে:
{ "success": true, "data": { … }, "meta": { "source": "…", "last_updated": "2026-11-12", "version": "v1" } }সবকিছুর জন্য অফিশিয়াল সূত্র ব্যবহার করার জোর চেষ্টা করেছি, আর যেখানে পারিনি সেখানে সেটা সৎভাবে বলেছি:
- করের নিয়ম মেলানো হয়েছে bdlaws-এ থাকা অর্থ আইন ২০২৬ (২০২৬ সালের ৯৬ নং আইন)-এর সাথে, সংবাদের সারাংশের সাথে নয়, কারণ সেগুলো একটা আরেকটার সাথে মেলেনি। আয়কর আইনের অফিশিয়াল ইংরেজি অনুবাদে একটি সংখ্যা (বেতনের অব্যাহতির সীমা) ভুল মনে হচ্ছিল, পরে দেখলাম অনুবাদটি শুধু ২০২৪ পর্যন্ত হালনাগাদ করা; যে ২০২৬ সালের আইন সেটা বদলেছে, সেটাকেই সূত্র হিসেবে দেওয়া হয়েছে।
- ব্যাংক ও শাখা এসেছে বাংলাদেশ ব্যাংকের নিজস্ব শাখা-তালিকা থেকে; বিশ্ববিদ্যালয় UGC থেকে; ছুটি সরকারি প্রজ্ঞাপন থেকে; সোনা BAJUS থেকে; বাজারদর TCB থেকে।
- নির্ভরযোগ্য সূত্রগুলো একমত না হলে তথ্যটি অনুমান না করে বাদ রাখা হয়েছে। যেখানে অফিশিয়াল সূত্র শুধু ইংরেজিতে (ব্যাংকের শাখা, বেশিরভাগ বিশ্ববিদ্যালয়), সেখানে বানিয়ে নেওয়া বানানের বদলে বাংলা নাম রাখা হয়নি।
🔐 ডিজাইনেই প্রাইভেসি
- ভ্যালিডেটরগুলো (NID, ফোন, নম্বরপ্লেট, TIN, BIN, রাউটিং নম্বর) শুধু ফরম্যাট যাচাই করে। কিছুই খোঁজা, সংরক্ষণ বা লগ করা হয় না; লগে থাকে শুধু route-এর প্যাটার্ন, মান কখনো নয়।
- ক্যালকুলেটরগুলো শুধু সংখ্যা নেয়, কোনো পরিচয় নম্বর নয়।
- মক ডেটা কৃত্রিম। বিশ্বাসযোগ্য দেখাতে নামগুলো একই নামকরণ-ধারার ভেতরে জোড়া লাগানো হয়, কিন্তু ধর্ম কখনো ফেরত দেওয়া হয় না।
🏗️ কীভাবে বানানো
- TypeScript + Hono, সাথে Zod schema যেটা request যাচাইও করে আবার OpenAPI ডকসও তৈরি করে, তাই ডকস কখনো কোড থেকে আলাদা হয়ে যেতে পারে না।
- ফ্রি টিয়ারে Cloudflare Workers: সব জায়গায় দ্রুত, কোনো সার্ভার নেই। রেফারেন্স ডেটা রিপোতেই সাধারণ JSON হিসেবে রাখা, CI-তে যাচাই হয়, তাই যে কেউ একটা pull request দিয়ে তথ্য ঠিক করতে পারেন।
- GitHub Spec Kit দিয়ে spec-first: কোড লেখার আগে প্রতিটি মডিউলের spec, research notes, plan আর tasks থাকে, আর টেস্ট লেখা হয় আগে। Workers runtime-এর ভেতরে ৭৮০টি টেস্ট চলে।
- ডেটাবেস ছাড়াই লাইভ ডেটা: সোনা আর বাজারদর request এলে পড়া হয় আর edge-এ cache করা হয়। TCB
দাম প্রকাশ করে Excel ফাইলে, তাই ভারী লাইব্রেরির বদলে Worker-এর ভেতরেই ছোট একটি
.xlsxরিডার আছে।
🧗 বাংলাদেশের ডেটা সোর্স থেকে যা শিখলাম
- সব জায়গায় captcha। বেশ কিছু অফিশিয়াল সাইট স্ক্রিপ্টকে জিজ্ঞেস করে "ছবিতে কোন কোড আছে?", তাই কিছু ফাইল হাতে নামাতে হয়েছে।
- এনকোডিং। আইনের পেজ UTF-16-এ, গেজেটের PDF পুরনো Bijoy ফন্টে, আর একই spreadsheet-এ একই বাংলা অক্ষর (য়) দুইভাবে লেখা।
- লুকানো কাঠামো। ব্যাংক রাউটিং নম্বরে একটি check digit আছে, কিন্তু এর কোনো ডকুমেন্টেশন খুঁজে পাইনি। প্রকাশিত ১০,০৩২টি নম্বর থেকে হিসাব করে weight পেলাম ৫, ৭, ১; প্রতিটি নম্বর এতে পাস করে, তাই API এখন টাইপো ধরতে পারে, আর spreadsheet-এ শুরুর শূন্য হারিয়ে যাওয়া নম্বরও ঠিক করে দেয়।
- কিছু সোর্স বিদেশি ট্রাফিক নেয় না। আমেরিকা বা ইউরোপের ক্লাউডের সার্ভারকে কয়েকটি সাইট ব্লক করে
দেয়, তাই লাইভ দামের সর্বশেষ ঠিক কপি (সর্বোচ্চ ৭ দিন পুরনো) রাখা হয় আর response-এ
freshness: "last_known"দিয়ে সেটা জানিয়ে দেওয়া হয়। ভুল দাম কখনো দেখানো হয় না।
🗺️ এরপর কী, আর আপনি কীভাবে সাহায্য করতে পারেন
রোডম্যাপে এরপর: মুদ্রার বিনিময় হার, ব্যাংক ছুটির ক্যালেন্ডার, নামাজের সময় ও রমজানের সময়সূচি, আর JavaScript, Python ও PHP-র জন্য SDK।
কোড না লিখেও সাহায্য করতে পারেন:
- কোনো ভুল তথ্য চোখে পড়েছে? সূত্রসহ একটি
issue খুলুন, অথবা
data/-এর JSON ফাইলটি এডিট করুন। - বাংলাভাষীরা: মক-ডেটার নামের তালিকার বানানগুলো একবার দেখে দিলে খুব উপকার হবে।
- কোনো প্রজেক্টে ব্যবহার করছেন? জানাবেন; তালিকায় যোগ করতে পারলে খুশি হব।
কোড MIT, ডেটা CC BY 4.0। চালিয়ে দেখুন deshapi.riadul.com-এ, আর কোড আছে GitHub-এ।