Indian Colleges List (Datasets)

API Documentation

This api contains 39268 colleges data, like names, states, district, address, etc., including private, government, autonomous, and affiliated institutions across India. The data is sourced from the All India Council for Technical Education (AICTE) website.

GET /api/institutions (11.9MB)

View Endpoint

This is the main endpoint to access the Indian Colleges dataset. It is huge in size and may take some time to respond. If you want state wise data which is smaller, try the per-state endpoints described below.

Examples

Browser (client-side):

fetch("/api/institutions")
  .then((r) => r.json())
  .then((data) => console.log(data));

Curl (cmd.exe):

curl https://indian-colleges-list.vercel.app/api/institutions

Example: /api/institutions

GET /api/institutions/search

View Endpoint

Search institutions. This route requires BOTH a state query parameter and a search string q of at least 3 characters. Results are paginated.

Examples

Browser (client-side):

fetch("/api/institutions/search?state=Tamil Nadu&q=loyola&page=1&limit=20")
  .then((r) => r.json())
  .then((data) => console.log(data));

Curl (cmd.exe):

curl https://indian-colleges-list.vercel.app/api/institutions/search?state=Tamil Nadu&q=loyola

GET /api/institutions/states

View Endpoint

returns a list of available states and their slugs. Example response: { states: [{ name, slug }] }. The API provides state-level snapshots and metadata to make working with the dataset easier.

Examples

Browser (client-side):

fetch("/api/institutions/states")
  .then((r) => r.json())
  .then((data) => console.log(data));

Curl (cmd.exe):

curl https://indian-colleges-list.vercel.app/api/institutions/states

Example: /api/institutions/states

GET /api/institutions/states/{state}

View Endpoint

returns a list of available institutes inside that state. The API provides state-level snapshots and metadata to make working with the dataset easier.

Examples

Browser (client-side):

fetch("/api/institutions/states/{state}")
  .then((r) => r.json())
  .then((data) => console.log(data));

Curl (cmd.exe):

curl https://indian-colleges-list.vercel.app/api/institutions/states/{state}

Example: /api/institutions/states/Tamil%20Nadu

GET /api/institutions/states/{state}/{aicteid}

View Endpoint

returns detailed information about a specific institute including programme details

Examples

Browser (client-side):

fetch("/api/institutions/states/{state}/{aicteid}")
  .then((r) => r.json())
  .then((data) => console.log(data));

Curl (cmd.exe):

curl https://indian-colleges-list.vercel.app/api/institutions/states/{state}/{aicteid}

Example: /api/institutions/states/Tamil%20Nadu/1-44641241273

Postman collections

Import the Postman collection files from the postman/ folder. Use the provided environment (base_url) and run the requests.