https://github.com/anburocky3/cbse-schools-data
Fetch CBSE Schools in seconds and use it for your data projects
https://github.com/anburocky3/cbse-schools-data
cbse data data-analysis data-science grabber nextjs
Last synced: about 10 hours ago
JSON representation
Fetch CBSE Schools in seconds and use it for your data projects
- Host: GitHub
- URL: https://github.com/anburocky3/cbse-schools-data
- Owner: anburocky3
- License: mit
- Created: 2025-11-23T15:52:27.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-11-23T17:38:58.000Z (7 months ago)
- Last Synced: 2025-11-23T19:14:22.100Z (7 months ago)
- Topics: cbse, data, data-analysis, data-science, grabber, nextjs
- Language: TypeScript
- Homepage: https://cbse-schools.netlify.app
- Size: 2.14 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CBSE School List — (Data via API)
[](https://github.com/anburocky3/cbse-schools-data)
[](https://github.com/anburocky3/cbse-schools-data)
[](https://github.com/anburocky3/cbse-schools-data)
[](https://discord.gg/6ktMR65YMy)
[](https://www.youtube.com/c/cyberdudenetworks)
This api contains 31000+ cbse school data, like names, district, address, etc., including inauguration_date with current principal details across India. The data is sourced from the CBSE Saras website.
> You can download the [entire data-set here](https://raw.githubusercontent.com/anburocky3/cbse-schools-data/refs/heads/main/data/schools.json). If you are looking for Indian Colleges/Instituitions [Check here](https://github.com/anburocky3/indian-colleges-data/fork)
### Screenshots
> Note: This project is not affiliated with or endorsed by any government entity. Data comes from publicly available pages and may change or break at any time.
## 🚀 Available Endpoints
- 👉 [GET - /api/schools - List all CBSE Schools](https://cbse-schools.netlify.app/api/schools)
- 👉 [GET - /api/schools/{affiliatedId} - Get Detailed School Info](https://cbse-schools.netlify.app/api/schools/1930706)
- 👉 [GET - /api/states - List available states ](https://cbse-schools.netlify.app/api/states)
- 👉 [GET - /api/states/{state} - Get districts of that state](https://cbse-schools.netlify.app/api/states/19)
- 👉 [GET - GET /api/states/{state}/{district} - List all schools on that district](https://cbse-schools.netlify.app/api/states/19/03)
> Calling `/api/schools` will return the offline snapshot from `data/schools.json` (12.8MB). Prefer filtered calls (by state/district/status) for faster responses.
- The downloader/merge scripts write per-status files and a merged snapshot at `data/schools.json`. Each per-status file has a `meta` object with `count` and `last_grabbed` timestamps. The merged file contains `meta` with `statuses` and `total_unique`.
### ✅ [Download Postman Collections](https://raw.githubusercontent.com/anburocky3/cbse-schools-data/refs/heads/main/postman/CBSESchools.postman_collection.json)
## Quick start
1. [Fork this repository](https://github.com/anburocky3/cbse-schools-data/fork) and install the deps.
```bash
npm install
npm run dev
```
Run the data grab and merge scripts (optional — requires a valid RequestVerificationToken/cookie in `scripts/fetchRemoteData.ts`):
```cmd
npm run grab:data
npm run merge:data
```
2. Open the app in your browser:
```
http://localhost:3000
```
## Author
- [Anbuselvan Annamalai](https://fb.me/anburocky3) ([MIT License](/LICENSE))
## Acknowledgement
- All datas are owned by online saras website. Refer it for more clarity!