داده‌های باز و زیرساخت پژوهشی مجوز آزاد CC BY 4.0 ۰ خیریه نمایه شده

پایگاه داده باز خیریه‌های ایران

کلیه داده‌های گردآوری‌شده و راستی‌آزمایی‌شده بنیاد ناهید، شامل شناسنامه ثبتی، صورت‌های مالی تفکیک‌شده و سنجه‌های شفافیت به‌صورت رایگان و با فرمت استاندارد CSV در دسترس پژوهشگران، تحلیل‌گران و عموم قرار دارد.

داده‌های ناهید را چگونه می‌توان دانلود و استفاده کرد؟

همه‌ی داده‌هایی که ناهید منتشر می‌کند به‌صورت فایل‌های استاندارد CSV و وب‌سرویس عمومی REST JSON بدون نیاز به ثبت‌نام یا دریافت کلید دسترسی در اختیار عموم قرار دارد. فایل kheyriyeha.csv و وب‌سرویس api/v1/kheyriye فهرست خیریه‌ها را با نام ثبتی، شماره ثبت، شماره مجوز، حوزه‌های فعالیت و امتیاز شفافیت ارائه می‌دهند. فایل مالی mali.csv تک‌تک ردیف‌های صورت‌های مالی را با مبالغ ریالی و عنوان اولیه سند در بر دارد. تمام داده‌ها با مجوز آزاد CC BY 4.0 منتشر می‌شوند و استفاده پژوهشی، خبری یا تجاری از آن‌ها با ذکر منبع آزاد است.

فایل‌های استاندارد برای دانلود

فرمت: CSV کدگذاری‌شده به صورت UTF-8 با BOM (سازگار کامل با اکسل و پایتون)

شناسنامه جامع خیریه‌ها: نام فارسی، نام حقوقی، شماره ثبت، شناسه ملی، شماره مجوز، حوزه‌ها، استان، امتیاز شفافیت ارزیابی‌شده و تعداد معیارهای منتظر ارزیابی.

دانلود فهرست خیریه‌ها (CSV)

ردیف‌های مالی نرمال‌شده صورت‌های حسابرسی: سال مالی خورشیدی، دسته‌بندی ناهید، مبلغ به ریال و تومان، واحد اولیه سند، عنوان دقیق حسابداری خیریه، سطح اطمینان و پیوند به سند دیجیتال.

دانلود ردیف‌های مالی نرمال‌شده (CSV)

رابط برنامه‌نویسی باز (REST API v1)

فرمت خروجی: JSON کدگذاری‌شده به صورت UTF-8 | دسترسی کاملاً رایگان بدون نیاز به کلید یا توکن

برای توسعه‌دهندگان، محققان علوم اجتماعی، ربات‌های هوش مصنوعی و سرویس‌های عام‌المنفعه، تمام پایگاه داده ناهید از طریق وب‌سرویس REST با خروجی استاندارد JSON در دسترس است.

GET /api/v1/kheyriye

جست‌وجو و دریافت فهرست خیریه‌ها همراه با امتیاز شفافیت و فیلترهای استانی و موضوعی.

پارامترهای اختیاری:

ostan: نامک انگلیسی استان (مثلاً tehran, fars)
hoze: نامک انگلیسی حوزه فعالیت (مثلاً darman, amoozesh)
q: عبارت جست‌وجو در نام فارسی یا نام ثبتی
limit: تعداد ردیف‌ها (پیش‌فرض ۵۰، حداکثر ۱۰۰)
offset: شروع از ردیف چندم برای صفحه‌بندی

curl -s "https://naheed.ir/api/v1/kheyriye?ostan=tehran&limit=5"

GET /api/v1/kheyriye/{slug}

پرونده تفصیلی یک خیریه مشخص شامل شناسنامه ثبتی، تفکیک امتیازهای ۱۳ گانه شفافیت، آخرین اقلام ترازنامه مالی و کانال‌های رسمی واریز مستقیم.

پارامتر مسیر:

slug: نامک یکتای خیریه (مثلاً mahak, kahrizak, koodakan-fars)

curl -s "https://naheed.ir/api/v1/kheyriye/mahak"

GET /api/v1/amar

آمار کلان و تجمعی بنیاد ناهید: تعداد خیریه‌های نمایه شده، گزارش‌های مالی منتشرشده، ردیف‌های حسابرسی، استان‌ها و مقالات پژوهشی.

curl -s "https://naheed.ir/api/v1/amar"

نمونه کدهای دسترسی به API

نمونه دریافت داده در پایتون (Requests / Pandas) Python

import requests
import pandas as pd

# ۱. دریافت آمار کلی پلتفرم
stats = requests.get("https://naheed.ir/api/v1/amar").json()
print(f"تعداد خیریه‌ها: {stats['totalCharities']}, ردیف‌های مالی: {stats['totalFinancialLines']}")

# ۲. جست‌وجوی خیریه‌ها در حوزه درمان با امتیاز شفافیت
res = requests.get("https://naheed.ir/api/v1/kheyriye", params={"hoze": "darman", "limit": 20})
charities = res.json()["data"]

for c in charities:
    score = c.get("transparencyScore")
    pct = score["percentage"] if score else 0
    print(f"{c['name']}: {pct}% شفافیت (استان: {c['provinceSlug']})")

نمونه دریافت داده در جاوااسکریپت (Node.js / Modern Fetch) JavaScript

// دریافت پرونده محک و نمایش کانال‌های واریز معتبر
const response = await fetch("https://naheed.ir/api/v1/kheyriye/mahak");
const { organization, score, donationChannels } = await response.json();

console.log(`${organization.name} — شماره ثبت: ${organization.registrationNumber}`);
console.log(`امتیاز شفافیت: ${score.totalAwarded} از ${score.totalAssessable}`);
console.table(donationChannels);

مجوز استفاده آزاد

این داده‌ها با مجوز بین‌المللی کریتیو کامنز (CC BY 4.0) منتشر شده‌اند. شما می‌توانید این مجموعه داده را آزادانه کپی، توزیع، تغییر داده و حتی در پروژه‌های تجاری یا پژوهشی به کار ببرید؛ تنها شرط، ذکر منبع به عنوان «بنیاد ناهید (naheed.ir)» است.

راهنمای ستون‌ها و نکات تحلیلی

مبالغ به ریال ذخیره شده‌اند (ستون amount_rial) و ستون amount_toman صرفاً برای راحتی است. هر دو عدد صحیح‌اند، نه اعشاری.
ستون original_label عنوانی است که خودِ خیریه در سندش نوشته، بدون تغییر. اگر با دسته‌بندی ما موافق نیستید، این ستون همان چیزی است که باید به آن استناد کنید.
ستون confidence نشان می‌دهد عدد مستقیماً گزارش شده، محاسبه شده، یا برآوردی است.
سال‌های مالی شمسیاند و از فروردین تا اسفند ادامه دارند؛ با سال میلادی منطبق نیستند.
ارقام سال‌های مختلف بدون تعدیل تورم قابل مقایسه نیستند. تورم ایران بالای چهل درصد در سال است.
امتیاز شفافیت از مجموع امتیازهای ارزیابی‌شده است، نه از صد. ستون score_unassessed نشان می‌دهد چه مقدار هنوز بررسی نشده. این دو را با هم گزارش کنید؛ گزارش امتیاز بدون آن، مؤسسه‌ای را که بررسی نشده شبیه مؤسسه‌ای نشان می‌دهد که رد شده است.