MySchool APImyschool.ng ↗
Access Nigerian school listings, course data, admission requirements, and education news via the MySchool.ng API. Covers universities, polytechnics, and colleges.
What is the MySchool API?
The MySchool.ng API exposes 6 endpoints covering Nigerian schools, courses, admission requirements, and education news. Use get_course_requirements to retrieve UTME subject combinations and O'Level requirements for a specific programme, list_schools_by_type to enumerate all universities, polytechnics, or colleges of education by slug, and search to query across news, events, materials, and more in a single call.
curl -X GET 'https://api.parse.bot/scraper/024e7b9b-f175-4efa-9c90-874b24500823/search?query=admission' \ -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 myschool-ng-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.
"""Walkthrough: Myschool.ng SDK — explore Nigerian schools, courses, and news."""
from parse_apis.Myschool_ng_API import Myschool, SchoolType, NewsCategory, NotFound
client = Myschool()
# Search across all content types — limit caps total items fetched.
for result in client.search_results.search(query="engineering", limit=5):
print(result.title, result.type, result.url)
# List universities and drill into the first one's details.
school_summary = client.school_summaries.list(type=SchoolType.UNIVERSITY, limit=1).first()
if school_summary:
school = school_summary.details()
print(school.name, school.details.location, school.details.aka)
# Walk courses offered by this school, fetch admission requirements.
for course in school.courses.list(limit=3):
print(course.name, course.requirements_path)
reqs = course.requirements()
print(reqs.requirements.utme_subject_combination)
print(reqs.requirements.olevel_requirements)
# Browse latest JAMB news using the enum.
for article in client.news_articles.list(category=NewsCategory.JAMB, limit=3):
print(article.title, article.slug, article.url)
# Typed error handling: catch NotFound for a bad slug.
try:
detail = client.schools.get(slug="nonexistent-school-12345")
print(detail.name)
except NotFound as exc:
print(f"School not found: {exc.slug}")
print("exercised: search_results.search / school_summaries.list / school.details / school.courses.list / course.requirements / news_articles.list / schools.get")
Full-text search across all content types on myschool.ng — news, questions, events, groups, materials, and marketplace listings. Returns deduplicated results with title, URL, and content type. Results are not paginated; a single request returns all matches.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'Unilag', 'admission', 'engineering') |
{
"type": "object",
"fields": {
"query": "string, the search query submitted",
"results": "array of search result objects with title, url, and type",
"total_results": "integer, count of results returned"
},
"sample": {
"data": {
"query": "admission",
"results": [
{
"url": "https://myschool.ng/news/category/admission",
"type": "news",
"title": "Admission News"
},
{
"url": "https://myschool.ng/news/category/jamb",
"type": "news",
"title": "JAMB News"
}
],
"total_results": 52
},
"status": "success"
}
}About the MySchool API
School and Course Data
The list_schools_by_type endpoint accepts a type parameter — 'university', 'polytechnic', or 'education' — and returns an array of school objects each with a name and slug. That slug feeds directly into get_school_info, which returns the full institution name, abbreviation (AKA), Institution Type, Location, and official Website when available. The same slug is used by get_school_courses to retrieve every programme a school offers, each carrying a requirements_path field that chains into the next endpoint.
Admission Requirements
get_course_requirements takes the requirements_path from get_school_courses results and returns structured admission data keyed by requirement type: 'UTME Subject Combination', "O'Level Requirements", and 'Direct Entry Requirements'. Keys appear only when the source has data for them, so callers should check for key presence before reading. This makes it straightforward to build JAMB brochure lookups or admission eligibility checks programmatically.
News and Search
get_latest_news returns an array of articles — each with title, slug, url, and a summary (nullable) — and can be filtered by category slug such as 'jamb', 'post-utme', 'admission', or 'o-level'. The search endpoint accepts a free-text query and returns deduplicated results across content types including 'news', 'questions', 'events', 'groups', 'materials', and 'marketplace', with each result carrying a title, url, and type field plus a total_results count.
The MySchool API is a managed, monitored endpoint for myschool.ng — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when myschool.ng 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 myschool.ng 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 JAMB subject combination checker using
get_course_requirementskeyed on UTME data. - Aggregate a searchable directory of all Nigerian universities and polytechnics from
list_schools_by_type. - Surface institution details — location, website, type — in a school comparison tool via
get_school_info. - Monitor Nigerian admissions news by polling
get_latest_newswith the'admission'or'post-utme'category filter. - Power a course search feature by listing all programmes per school with
get_school_coursesand their associated slugs. - Build a cross-content search bar over Nigerian education materials, events, and questions using the
searchendpoint. - Automate O'Level requirement lookups to check subject eligibility across multiple schools and 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 MySchool.ng offer an official developer API?+
What does `get_course_requirements` actually return, and are all keys always present?+
get_course_requirements returns a requirements object that may include 'UTME Subject Combination', "O'Level Requirements", and 'Direct Entry Requirements'. Keys are only present when the source has data for that requirement type, so you should guard against missing keys in your code rather than assuming all three are always populated.Does the `search` endpoint support pagination or returning more than one page of results?+
search endpoint returns a single deduplicated result set with a total_results count but does not currently expose pagination parameters. It covers content types including news, questions, events, groups, materials, and marketplace listings in one response. You can fork this API on Parse and revise it to add offset or page-based pagination if your use case requires deeper result sets.Does the API cover private universities or only federal and state institutions?+
list_schools_by_type endpoint returns all schools indexed under each type on MySchool.ng, which includes a mix of federal, state, and private institutions. Coverage depends on what the source lists. You can fork the API on Parse and revise it to add filtering by ownership type if that distinction matters for your application.