How anburocky3/indian-colleges-data works
This repository publishes AICTE-sourced Indian institution data through a Next.js API and a small endpoint-discovery page. The main workflow is a caller requesting an institution list, state snapshot, search result, or institution’s programmes; handlers read local JSON snapshots, with the main list optionally fetching AICTE live. The documented ingestion and enrichment scripts refresh snapshots and add programme details. Source excerpts establish the API’s file reads and live fetch; some other subsystem links are documented in the README rather than verified in unsampled code.
Main entry points: route.ts Institution list · states State snapshots · download-all-states.ts State downloader · merge-from-states.ts Programme enrichment
Components 14
Web interface
- Endpoint guide
app/page.tsx
Institution API
- Institution list
app/api/institutions/route.ts - Institution search
app/api/institutions/search/route.ts - State directory
app/api/institutions/states/route.ts - State institutions
app/api/institutions/states/[state]/route.ts - Institution programmes
app/api/institutions/states/[state]/[aicteid]/route.ts
Data snapshots
- All-institutions snapshot
data/institutions.json - State snapshots
data/states - Programmes snapshot
data/institutions-with-programmes.json - Snapshot metadata
data/institutions.meta.json
Data refresh
- State downloader
scripts/download-all-states.ts - Programme enrichment
scripts/merge-from-states.ts
Other components
- API consumer
- AICTE service
Connections 23
- API consumer → Endpoint guide: opens
README.md - API consumer → Institution list: requests
README.md - API consumer → Institution search: searches
README.md - API consumer → State directory: lists states
README.md - API consumer → State institutions: requests state
README.md - API consumer → Institution programmes: requests courses
README.md - Endpoint guide → Institution list: links to
app/page.tsx - Institution list → All-institutions snapshot: reads offline
app/api/institutions/route.ts - Institution list → Snapshot metadata: reads metadata
app/api/institutions/route.ts - Institution list → AICTE service: fetches online
app/api/institutions/route.ts - State directory → Institution list: imports state list
app/api/institutions/states/route.ts - State institutions → Institution list: imports CORS helper
app/api/institutions/states/[state]/route.ts - State institutions → State snapshots: reads snapshot
app/api/institutions/states/[state]/route.ts - Institution programmes → State snapshots: reads snapshot
app/api/institutions/states/[state]/[aicteid]/route.ts - Institution search → State snapshots: reads state data
app/api/institutions/search/route.ts - Institution search → All-institutions snapshot: reads fallback
app/api/institutions/search/route.ts - State downloader → AICTE service: downloads data
scripts/download-all-states.ts - State downloader → State snapshots: writes snapshots
scripts/download-all-states.ts - State downloader → All-institutions snapshot: writes merged data
scripts/download-all-states.ts - State downloader → Snapshot metadata: writes metadata
scripts/download-all-states.ts - Programme enrichment → State snapshots: reads and updates
scripts/merge-from-states.ts - Programme enrichment → AICTE service: fetches programmes
scripts/merge-from-states.ts - Programme enrichment → Programmes snapshot: writes combined data
scripts/merge-from-states.ts