Nic APIjosaa.nic.in ↗
Access JoSAA seat matrix, opening/closing ranks, and institute details for IITs, NITs, IIITs, and GFTIs via a structured API. Historical data from 2016.
What is the Nic API?
The JoSAA API provides 4 endpoints covering Joint Seat Allocation Authority admission data across IITs, NITs, IIITs, and GFTIs. Use get_opening_closing_ranks to retrieve rank cutoffs for the current counselling session filtered by round, category, and institute, or pull historical rank data back to 2016 with get_previous_years_ranks. Responses include seat type breakdowns, program-level detail, and full institute metadata.
curl -X GET 'https://api.parse.bot/scraper/bbe8589c-10ba-4826-b58e-3d7153b00cdd/get_opening_closing_ranks?branch=ALL&round_no=1&inst_type=IIT&institute=ALL&seat_type=ALL' \ -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 josaa-nic-in-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.
"""JoSAA Admission Data: institutes, seat matrix, and historical rank trends."""
from parse_apis.josaa_admission_data_api import (
JoSAA, InstituteType, Round, Year, SeatType, DataNotAvailable
)
client = JoSAA()
# List all participating institutes — quick overview of the JoSAA ecosystem.
for inst in client.institutes.list(limit=3):
print(inst.code_and_name, inst.address)
# Seat matrix for IITs: category-wise seat counts per program.
entry = client.seatmatrixentries.list(inst_type=InstituteType.IIT, limit=1).first()
if entry:
print(entry.institute_name, entry.program_name, entry.open, entry.sc, entry.total)
# Historical ranks (2024, Round 1) for IITs — the primary research use case.
for rank in client.rankentries.list_historical(
year=Year.Y2024, round_no=Round.ROUND_1, inst_type=InstituteType.IIT,
seat_type=SeatType.OPEN, limit=5
):
print(rank.institute, rank.program_name, rank.opening_rank, rank.closing_rank)
# Typed error handling: catch when data isn't available for a combination.
try:
for rank in client.rankentries.list_current(
round_no=Round.ROUND_1, inst_type=InstituteType.IIT, limit=3
):
print(rank.program_name, rank.gender, rank.closing_rank)
except DataNotAvailable as exc:
print(f"No current session data: {exc}")
print("exercised: institutes.list / seatmatrixentries.list / rankentries.list_historical / rankentries.list_current")
Fetch opening and closing rank data for the current admission session based on round, institute type, and category. Returns an array of rank entries. Data availability depends on the current counselling session progress; some institute types may not have data populated yet. Empty results are normal when the session has not started.
| Param | Type | Description |
|---|---|---|
| branch | string | Branch/program code or 'ALL'. |
| round_norequired | string | Round number. |
| inst_typerequired | string | Institute type. |
| institute | string | Institute code (numeric, from get_institute_list) or 'ALL'. |
| seat_type | string | Seat type or 'ALL'. |
{
"type": "object",
"fields": {
"data": "array of rank entry objects with institute, program, quota, seat type, gender, opening and closing ranks"
}
}About the Nic API
Endpoints and What They Return
The API exposes four endpoints. get_opening_closing_ranks returns rank entries for the active counselling session. Required parameters are round_no (1–6) and inst_type (IIT, NIT, IIIT, or GFTI). Optional filters include institute (numeric code from get_institute_list), branch (program code), and seat_type (e.g. OPEN, EWS, OBC-NCL, SC, ST). Each entry in the returned data array carries the opening and closing ranks for that combination. Data availability reflects the real-time progress of the counselling session — rounds not yet completed will not have populated entries.
get_previous_years_ranks accepts the same filter parameters plus a required year field (2016–2024). This makes it possible to compare cutoffs across institute types and categories over multiple years. Note that not all year/inst_type/seat_type combinations are guaranteed to have data; the endpoint returns an empty data array rather than an error for missing combinations.
Institute and Seat Matrix Data
get_institute_list requires no parameters and returns the full catalogue of participating institutes, including codes, names, addresses, and contact information. These numeric institute codes are the values expected by the institute parameter in the other endpoints.
get_seat_matrix returns seat availability broken down by institute, program, and category for the current session. It accepts inst_type (required), institute, and branch as filters. Querying with inst_type set to ALL is not supported — the server will time out. Always specify a concrete institute type when calling this endpoint.
The Nic API is a managed, monitored endpoint for josaa.nic.in — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when josaa.nic.in 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 josaa.nic.in 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 rank predictor tool that maps a student's JEE rank to candidate institutes and programs using opening/closing rank data.
- Track year-over-year cutoff trends for a specific IIT branch and seat type using get_previous_years_ranks from 2016 to 2024.
- Display seat availability per category and program for a chosen NIT using the get_seat_matrix endpoint.
- Populate an institute directory with names, addresses, and contact details from get_institute_list.
- Compare OBC-NCL and EWS closing ranks across NITs for a given round to advise counselling choices.
- Generate round-wise rank movement charts for a specific IIIT using successive round_no values in get_opening_closing_ranks.
- Build a data dashboard that aggregates GFTI seat matrices alongside historical rank data for less-competed programs.
| 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.