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.