Shiksha APIshiksha.com ↗
Access Shiksha.com data on Indian colleges, courses, fees, placements, rankings, and upcoming exams via 5 structured API endpoints.
What is the Shiksha API?
The Shiksha.com API provides structured access to India's largest education portal across 5 endpoints, covering college search, detailed institute profiles, course-level fee and eligibility data, and upcoming exam schedules. The get_college_details endpoint alone returns over a dozen fields per college — name, address, contact info, ratings, highlights, top recruiters, and accreditation status — while list_colleges supports pagination and filtering by stream and course type.
curl -X GET 'https://api.parse.bot/scraper/9aadd01b-6856-442a-9002-9c6bf49e614e/search_colleges?query=IIT' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace shiksha-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.shiksha_com_college_exam_api import Shiksha, Stream, CollegeNotFound
shiksha = Shiksha()
# Search for IIT colleges
for college in shiksha.collegesummaries.search(query="IIT", limit=5):
print(college.name, college.location, college.rating, college.placement_above_8lpa)
# Navigate to full details
detail = college.details()
print(detail.website, detail.total_courses, detail.national_importance)
if detail.top_recruiters:
for recruiter in detail.top_recruiters[:3]:
print(recruiter.company_name, recruiter.logo_url)
# List engineering colleges and their courses
for college in shiksha.colleges.list(stream=Stream.ENGINEERING, course="b-tech", limit=3):
print(college.name, college.short_name, college.ranking, college.fees)
for exam in college.exams_accepted:
print(exam.name, exam.url)
# Get courses for this college
for course in college.courses(limit=5):
print(course.name, course.fees, course.total_seats)
# List upcoming medical exams
for exam in shiksha.exams.list(stream=Stream.MEDICAL, limit=5):
print(exam.name, exam.full_name, exam.year, exam.group_name)
for date in exam.dates:
print(date.event_name, date.date_string, date.is_tentative)
Search for colleges by keyword. Returns matching colleges with details like name, location, ratings, courses, and placement data. For broad category queries (e.g., 'MBA colleges in Bangalore'), returns intent='category' with a redirect_url to the appropriate category listing page and an empty colleges array. For specific name queries (e.g., 'IIT', 'BITS Pilani'), returns intent='basicinfo' with populated colleges array.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'IIT', 'BITS Pilani', 'MBA colleges in Bangalore') |
{
"type": "object",
"fields": {
"query": "string - The search query submitted",
"intent": "string - Search intent type ('basicinfo' for specific colleges, 'category' for broad queries)",
"heading": "string or null - Result heading text",
"colleges": "array of CollegeSummary objects",
"redirect_url": "string or null - Category page URL for broad queries",
"total_results": "integer - Number of colleges returned"
},
"sample": {
"data": {
"query": "IIT",
"intent": "basicinfo",
"heading": "Check college details",
"colleges": [
{
"url": "https://www.shiksha.com/university/iit-bombay-indian-institute-of-technology-mumbai-54212?isource=SRP",
"name": "IIT Bombay - Indian Institute of Technology",
"rating": "4.6",
"location": "Mumbai",
"ownership": "public",
"course_count": 112,
"median_salary": "₹15.00 - ₹19.63 LPA",
"max_median_salary": 1963000,
"min_median_salary": 1500000,
"placement_above_8lpa": true
}
],
"redirect_url": null,
"total_results": 30
},
"status": "success"
}
}About the Shiksha API
College Search and Browsing
The search_colleges endpoint accepts a free-text query and returns matched colleges with fields including name, location, ownership, rating, course_count, median_salary, min_median_salary, and max_median_salary. The intent field distinguishes between specific college lookups (basicinfo) and broad category queries such as "MBA colleges in Bangalore" (category). For category queries, a redirect_url points to the relevant listing page rather than a flat result set. The list_colleges endpoint lets you paginate (~21 results per page) through colleges filtered by stream (engineering, mba, medical, design, law, science, arts) and course slug (b-tech, mba, mbbs, etc.), returning richer fields like institute_id, listing_type, logo_url, and a full pagination object with prev_url, next_url, and total_results.
College Profiles and Course Data
get_college_details takes a college_url path from search or list results and returns the complete institute profile: official website, email, telephone, address, rating, highlights (key facts array), short_name, and a description. This endpoint is the right choice when you need a single canonical view of an institute.
get_college_courses uses the same college_url input and returns a courses array where each object includes course_id, name, fees, fees_value, duration, total_seats, eligibility, exams_accepted, and predictor_url. The response also exposes stream_categories and base_course_categories arrays, letting you map courses to their academic groupings without extra lookups.
Exam Schedules
The list_exams endpoint accepts an optional stream parameter and returns structured exam records with exam_id, name, full_name, group_name, year, url, and a dates array containing per-event objects with event_name, date_string, and start_date. This covers registration deadlines, exam dates, and result schedules for engineering, MBA, medical, and other streams across India.
The Shiksha API is a managed, monitored endpoint for shiksha.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when shiksha.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official shiksha.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a college comparison tool using fees, median salary, and rating fields from
list_collegesandget_college_details. - Aggregate placement statistics (median_salary, min/max salary) across engineering colleges filtered by stream.
- Populate an exam calendar application with registration deadlines and exam dates from
list_examsfiltered by stream. - Surface eligibility requirements and accepted entrance exams for specific programs using
get_college_courses. - Generate course catalogs with seat counts, duration, and fee breakdowns for a given institute.
- Identify top-ranked colleges in a specific stream for recommendation engines using rankings and ratings from
list_colleges. - Monitor changes in course offerings and fees across medical or law colleges by periodically querying
get_college_courses.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Shiksha.com have an official developer API?+
What does the `search_colleges` endpoint return for broad queries like "top MBA colleges in Delhi"?+
search_colleges returns intent set to category and a redirect_url pointing to the matching listing page rather than a flat array of college objects. For specific institution name queries, intent is basicinfo and the colleges array is populated with name, location, ownership, rating, course count, and salary range fields.Does the API expose user-submitted reviews or detailed review text for colleges?+
get_college_details endpoint includes an aggregate rating value and a highlights array of key facts. Individual review text, reviewer names, and per-criterion scores are not currently returned as discrete fields. You can fork this API on Parse and revise it to add an endpoint targeting Shiksha's reviews section.How does pagination work in `list_colleges`, and what is the page size?+
list_colleges response returns approximately 21 results. The pagination object in the response includes current_page, total_results, results_on_page, prev_url, next_url, and has_next. Pass the page parameter to step through result sets; has_next tells you when you have reached the last page.Can I retrieve scholarship details or hostel fee breakdowns for a college?+
fees_value, placement salary ranges, eligibility, and accepted exams. Scholarship information and hostel or living-cost breakdowns are not exposed as discrete fields in the current endpoints. You can fork this API on Parse and revise it to add those fields if Shiksha surfaces them on the college profile pages.