Skip to main content

Developer Documentation

Comprehensive university ranking and higher education reference for students, parents, and educators. Covers universities worldwide with ranking data from multiple sources, tier groupings, country and regional profiles, interactive tools, glossary, and in-depth guides. 15 languages supported.

Quick Start

curl -s "https://univfyi.com/api/v1/universities/"

API Endpoints

Method Endpoint Description
GET /api/v1/continents/ Continents
GET /api/v1/countries/ Countries
GET /api/v1/regions/ Regions
GET /api/v1/universities/ All universities
GET /api/v1/universities/{slug}/ University detail
GET /api/v1/tiers/ Tier groups
GET /api/v1/glossary-categories/ Glossary categories
GET /api/v1/glossary/ Glossary terms
GET /api/v1/guide-series/ Guide series
GET /api/v1/guides/ Guide articles
GET /api/v1/tools/ Interactive tools
GET /api/v1/faqs/ FAQs
GET /api/v1/stats/ Site statistics

URL Patterns

Use these patterns to construct URLs programmatically:

/university/{slug}/ University detail with rankings (e.g. /university/harvard-university/)
/countries/ Browse countries (e.g. /countries/)
/country/{code}/ Country education detail (e.g. /country/us/)
/continent/{slug}/ Continent detail (e.g. /continent/europe/)
/tiers/ Tier groups (e.g. /tiers/)
/tier/{slug}/ Tier group detail (e.g. /tier/ivy-league/)
/rankings/ Rankings by source and year (e.g. /rankings/)
/rankings/{source}/{year}/ Ranking detail (e.g. /rankings/qs/2025/)
/compare/{slug1}-vs-{slug2}/ University comparison (e.g. /compare/harvard-university-vs-mit/)
/glossary/ Higher education glossary (e.g. /glossary/)
/glossary/{slug}/ Glossary term detail (e.g. /glossary/gpa/)
/guides/ In-depth guides (e.g. /guides/)
/tools/ Interactive tools (e.g. /tools/)
/nearby/ Universities near me hub (e.g. /nearby/)
/nearby/{slug}/ Universities near a specific university (e.g. /nearby/harvard-university/)
/search/ Search universities, terms (e.g. /search/?q=harvard)

Response Format

All endpoints return JSON with pagination:

Example JSON response
{
  "count": 636,
  "next": "https://example.com/api/v1/items/?page=2",
  "previous": null,
  "results": [
    {"slug": "example", "name": "Example Item", "...": "..."}
  ]
}

OpenAPI Specification

Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.

SDK Packages

PyPI
pip install univfyi

University rankings and programs API client

Format Support

  • Markdown endpoints: Append .md to any page URL for LLM-friendly markdown output.
  • Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.