What's Inside

  1,203 Colleges IITs · NITs · IIITs · IIMs · BITS AIIMS · NLUs · 480+ Engineering With fees, placement LPA, NIRF rank

  247 Schools CBSE · ICSE · IB 31 states covered Top institutions nationwide

  4,242 Cities Every city in India All 36 states & UTs Grouped by state

  Install

npm install india-edu-cities-data

  Usage

CommonJS

const { searchColleges, searchSchools, getCitiesByState } = require('india-edu-cities-data')

ESM / React / Vite

import { searchColleges, searchSchools, getCitiesByState } from 'india-edu-cities-data'

  Colleges API

searchColleges(query, options?)

searchColleges('IIT')
// → [{ name: 'IIT Delhi', city: 'New Delhi', state: 'Delhi', type: 'IIT', ... }, ...]

searchColleges('', { type: 'NIT' })
searchColleges('', { state: 'Maharashtra', limit: 30 })
searchColleges('bangalore', { type: 'Private', limit: 10 })

| Option | Type | Default | Description | |---|---|---|---| | type | string | — | Filter by college type | | state | string | — | Filter by state name | | limit | number | 20 | Max results |

getCollege(name)

getCollege('IIT Bombay')
// → { name: 'IIT Bombay', city: 'Mumbai', state: 'Maharashtra', type: 'IIT', ... }

getCollegesByState(state, options?)

getCollegesByState('Tamil Nadu')
getCollegesByState('Karnataka', { type: 'Engineering' })

getCollegesByType(type)

getCollegesByType('IIT')         // all 23 IITs
getCollegesByType('NIT')         // all 31 NITs
getCollegesByType('IIIT')        // all 20 IIITs
getCollegesByType('IIM')         // all 21 IIMs
getCollegesByType('AIIMS')       // all AIIMS campuses
getCollegesByType('NLU')         // all National Law Universities
getCollegesByType('Engineering') // 480+ engineering colleges

getCollegeTypes() · getCollegeStates() · getAllColleges()

getCollegeTypes()   // → ['AIIMS', 'BITS', 'Engineering', 'IIM', 'IIT', 'IIIT', ...]
getCollegeStates()  // → ['Andhra Pradesh', 'Assam', 'Bihar', ...]
getAllColleges()     // → full array of 1,203 colleges

College Object Shape

{
  name:               string        // "IIT Bombay"
  city:               string | null // "Mumbai"
  state:              string | null // "Maharashtra"
  type:               string | null // "IIT"
  fees_ug_inr:        number | null // 228000
  placement_avg_lpa:  number | null // 21.82
  rating:             number | null // 8.9
  nirf_rank:          number | null // 3
}

  Schools API

searchSchools(query, options?)

searchSchools('Delhi Public')
// → [{ name: 'Delhi Public School R.K. Puram', city: 'New Delhi', state: 'Delhi', board: 'CBSE' }, ...]

searchSchools('', { board: 'ICSE' })
searchSchools('', { state: 'Uttar Pradesh', board: 'ICSE', limit: 10 })

| Option | Type | Default | Description | |---|---|---|---| | state | string | — | Filter by state name | | board | string | — | 'CBSE' | 'ICSE' | 'IB' | | limit | number | 20 | Max results |

getAllSchools()

getAllSchools() // → full array of 247 schools

School Object Shape

{
  s_no:   number        // 1
  name:   string        // "Delhi Public School R.K. Puram"
  city:   string | null // "New Delhi"
  state:  string | null // "Delhi"
  board:  string        // "CBSE" | "ICSE" | "IB"
}

  Cities API

getCitiesByState(state)

getCitiesByState('Maharashtra')
// → ['Ahmednagar', 'Akola', 'Amravati', 'Aurangabad', 'Mumbai', 'Nagpur', 'Pune', ...]

getStates()

getStates()
// → ['Andaman and Nicobar Islands', 'Andhra Pradesh', 'Arunachal Pradesh', ...]

searchCities(query, options?)

searchCities('nagar')
// → [{ state: 'Maharashtra', city: 'Ahmednagar' }, ...]

searchCities('nagar', { state: 'Rajasthan', limit: 5 })

getCitiesMap()

const map = getCitiesMap()
map['Rajasthan'] // → ['Ajmer', 'Alwar', 'Barmer', 'Bikaner', 'Jaipur', ...]

  Real-world Example

import { searchColleges, searchSchools, getCitiesByState, getStates } from 'india-edu-cities-data'

// Autocomplete: user types "vit"
const colleges = searchColleges('vit', { limit: 5 })
// → VIT Vellore, VIT Chennai, VIT Bhopal, VIT AP Amaravati

// ICSE schools in UP
const schools = searchSchools('', { state: 'Uttar Pradesh', board: 'ICSE' })

// Load cities when user picks a state
const cities = getCitiesByState('Uttar Pradesh')

// All states for a dropdown
const states = getStates()

  Data Files

| File | Rows | Contents | |---|---|---| | india_colleges.csv | 1,203 | name, city, state, type, fees (INR), avg placement LPA, rating, NIRF rank | | india_schools.csv | 247 | name, city, state, board (CBSE / ICSE / IB) | | india_cities.csv | 4,242 | state, city |

Built for Student Shop — a campus marketplace for Indian students.