naac.gov.in APInaac.gov.in ↗
Access NAAC accredited institution data, accreditation history, IIQA/SSR/Peer Team Reports, and latest results via a structured API for naac.gov.in.
curl -X GET 'https://api.parse.bot/scraper/21d6d0a2-6667-4988-9b50-105abfe77b7c/search_accredited_institutions' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for NAAC accredited institutions using various filters. Returns a paginated list of institutions with basic accreditation data.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results to return (max 100) |
| start | integer | Pagination start offset index |
| state | integer | State ID (get list from get_states endpoint) |
| inst_name | string | Institution name or partial name (e.g. 'Palamuru') |
| inst_type | integer | Institution type: 0=All, 1=College, 2=University |
{
"type": "object",
"fields": {
"institutions": "array of objects",
"total_records": "integer",
"filtered_records": "integer"
},
"sample": {
"institutions": [
{
"grade": "B",
"state": "Telangana",
"status": "5",
"address": "PALAMURU UNIVERSITY BANDAMEEDIPALLI MAHABUBNAGAR PIN 509001 MAHABUBNAGAR 509001",
"aishe_id": "U-0028",
"hei_name": "PALAMURU UNIVERSITY",
"submission_date": "2018-11-30",
"hei_assessment_id": 1016,
"accreditation_valid_till": "2023-11-29 00:00:00"
}
],
"total_records": 2,
"filtered_records": 2
}
}About the naac.gov.in API
The NAAC API exposes 4 endpoints covering India's National Assessment and Accreditation Council data, including institution search by state and name, detailed accreditation report links (IIQA, SSR, Peer Team Report, Grade Sheet), and the latest published results. The search_accredited_institutions endpoint accepts filters for state, institution type, and partial name, returning paginated records with accreditation metadata. An India-based proxy is required to reach the source.
Institution Search and Filtering
The search_accredited_institutions endpoint accepts up to five parameters: limit (max 100), start for pagination offset, state (integer ID), inst_name for partial name matching, and inst_type to filter between colleges (1), universities (2), or all institutions (0). Responses include total_records, filtered_records, and an array of institution objects with basic accreditation data. State IDs come from the get_states endpoint, which returns a flat mapping of state names to their integer IDs.
Institution Detail and Report Links
Once you have a hei_assessment_id from search results, pass it to get_institution_details to retrieve the full accreditation record for that institution. The response includes iiqa_status, ssr_status, iiqa_submitted_date, ssr_submitted_date, name_with_id, and a reports array of objects containing a label (e.g. "Peer Team Report", "Grade Sheet") and a direct url for each document. This endpoint is the primary way to access downloadable PDF reports for any given institution.
Latest Results and Reference Data
The get_latest_results endpoint returns a latest_pdf_results array of objects with title and url fields pointing to the most recently published accreditation result PDFs on the NAAC main site. This is useful for monitoring new accreditation cycles without polling individual institution records. The get_states endpoint serves as a reference lookup and should be called once to build a local state-ID mapping before running filtered searches.
Regional Access Note
The naac.gov.in source is geo-restricted. All requests to this API must route through an India-based proxy. Requests from other regions will fail at the source level, not at the API layer.
- Build a directory of NAAC-accredited colleges filtered by state using
search_accredited_institutionswith thestateandinst_typeparameters. - Retrieve and archive Peer Team Reports and Grade Sheet PDFs for accredited institutions via
get_institution_details. - Track IIQA and SSR submission dates for universities to monitor accreditation cycle timelines.
- Aggregate
iiqa_statusandssr_statusfields across institutions to analyze accreditation completion rates by state. - Monitor newly published accreditation result PDFs using
get_latest_resultsfor academic research or news alerting. - Cross-reference institution names against other education datasets using partial name search via the
inst_nameparameter.
| 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.
Does NAAC provide an official public developer API?+
What does `get_institution_details` return beyond basic accreditation status?+
iiqa_status, ssr_status, iiqa_submitted_date, ssr_submitted_date, name_with_id, and a reports array. Each entry in reports has a label (such as "Peer Team Report" or "Grade Sheet") and a url to the corresponding PDF document.Does the API return individual grade scores or performance metrics for each institution?+
get_institution_details. Numeric scores and criteria-level performance data are embedded in those PDFs rather than returned as discrete fields. You can fork this API on Parse and revise it to extract and surface specific score fields if your use case requires them.Can I retrieve historical accreditation cycles for an institution, such as multiple past assessment rounds?+
get_institution_details endpoint returns report links and status for the assessment associated with the provided hei_assessment_id. Browsing across multiple historical cycles is not currently exposed as a list. You can fork this API on Parse and revise it to add an endpoint that iterates across assessment IDs for a given institution.