josaa.nic.in 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.
curl -X GET 'https://api.parse.bot/scraper/bbe8589c-10ba-4826-b58e-3d7153b00cdd/get_opening_closing_ranks?round_no=1&inst_type=IIT&seat_type=ALL' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| Param | Type | Description |
|---|---|---|
| branch | string | Branch/program code or 'ALL'. |
| round_norequired | string | Round number: '1', '2', '3', '4', '5', or '6'. |
| inst_typerequired | string | Institute type: 'IIT', 'NIT', 'IIIT', or 'GFTI'. |
| institute | string | Institute code (numeric, from get_institute_list) or 'ALL'. |
| seat_type | string | Seat type (e.g. 'OPEN', 'EWS', 'SC', 'ST', 'OBC-NCL') or 'ALL'. |
{
"type": "object",
"fields": {
"data": "array of rank entry objects",
"status": "string, always 'success'"
},
"sample": {
"data": [
{
"Quota": "AI",
"Gender": "Gender-Neutral",
"Institute": "Indian Institute of Technology Bhubaneswar",
"Seat Type": "OPEN",
"Closing Rank": "13957",
"Opening Rank": "10063",
"Academic Program Name": "Civil Engineering (4 Years, Bachelor of Technology)"
}
],
"status": "success"
}
}About the josaa.nic.in 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.
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.
- 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 | 250 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.