Mastersportal APImastersportal.com ↗
Search and filter thousands of scholarships from Mastersportal.com by destination country and academic discipline. Returns titles, deadlines, grant details, and URLs.
What is the Mastersportal API?
The Mastersportal Scholarships API exposes a single search_scholarships endpoint that returns structured data on thousands of scholarships, including title, provider, deadline, grant details, and direct URL. Each response includes a total count, pagination metadata, and a filterable array of scholarship objects. You can narrow results by destination country using ISO 3166-1 alpha-2 codes or by academic discipline using numeric IDs.
curl -X GET 'https://api.parse.bot/scraper/cac76476-ffa7-4528-886c-5346d93f84db/search_scholarships?page=1&page_size=20&discipline_id=7&destination_country=CA' \ -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 mastersportal-com-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: Mastersportal Scholarships SDK — search, filter, and browse scholarships."""
from parse_apis.mastersportal_com_api import Mastersportal, ScholarshipSearchError
client = Mastersportal()
# Search all scholarships, limited to 5 results
for scholarship in client.scholarships.search(limit=5):
print(scholarship.title, "|", scholarship.deadline, "|", scholarship.provider_name)
# Filter by destination country (Canada) and discipline (Engineering & Technology)
engineering_in_canada = client.scholarships.search(
destination_country="CA",
discipline_id="7",
limit=3,
)
for s in engineering_in_canada:
print(s.title, "-", s.grant_description, "-", s.destination_countries)
# Drill into first result
first = client.scholarships.search(destination_country="GB", limit=1).first()
if first:
print(first.title, first.url, first.grant_amount, first.grant_currency)
# Handle errors for invalid input
try:
bad = client.scholarships.search(destination_country="INVALID", limit=1).first()
except ScholarshipSearchError as exc:
print(f"Search error: {exc}")
print("exercised: scholarships.search with filters, pagination, and error handling")
Search scholarships available on Mastersportal. Results are auto-iterated across pages. Supports filtering by destination country (ISO 2-letter code) and discipline ID. Returns scholarship title, description, provider, deadline, grant details, and a direct URL.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| page_size | integer | Number of results per page (1-100). |
| discipline_id | string | Numeric discipline ID to filter scholarships by field of study. Known IDs: 7 (Engineering & Technology), 13 (Business & Management), 10 (Computer Science & IT), 23 (Natural Sciences & Mathematics), 11 (Social Sciences), 24 (Humanities), 14 (Arts, Design & Architecture), 9 (Medicine & Health), 15 (Education & Training), 17 (Law), 12 (Environmental Studies & Earth Sciences), 16 (Agriculture & Forestry), 8 (Hospitality, Leisure & Sports), 22 (Journalism & Media), 19 (Applied Sciences & Professions). |
| destination_country | string | ISO 3166-1 alpha-2 country code to filter scholarships by study destination (e.g. CA for Canada, US for United States, GB for United Kingdom, DE for Germany). |
{
"type": "object",
"fields": {
"page": "integer",
"total": "integer",
"page_size": "integer",
"scholarships": "array of scholarship objects"
},
"sample": {
"data": {
"page": 1,
"total": 360,
"page_size": 5,
"scholarships": [
{
"id": "1018",
"url": "https://www.mastersportal.com/scholarships/1018/dr-franco-j-vaccarino-presidents-scholarship",
"title": "Dr. Franco J. Vaccarino President's Scholarship",
"deadline": "23 Jan 2027",
"description": "The Dr. Franco J. Vaccarino President's Scholarship is the University of Guelph's most prestigious undergraduate entrance award for international students.",
"provider_id": "12332",
"grant_amount": 42500,
"provider_name": "University of Guelph",
"grant_currency": "CAD",
"application_basis": "Merit-based",
"grant_description": "Up to 42,500 CAD ($)",
"provider_location": "Guelph, Canada",
"benefits_description": "42500 CAD",
"destination_countries": "Canada",
"provider_is_university": true
}
]
},
"status": "success"
}
}About the Mastersportal API
What the API Returns
The search_scholarships endpoint returns an array of scholarship objects alongside pagination fields: page, page_size, and total. Each scholarship object includes the scholarship title, a description of the award, the provider organization, the application deadline, grant details (award amount or type), and a direct URL to the listing on Mastersportal.com. Results are automatically iterated across pages, so you can walk through the full dataset by incrementing the page parameter.
Filtering and Pagination
Two optional filters are available. The destination_country parameter accepts an ISO 3166-1 alpha-2 country code — for example, CA for Canada or US for the United States — to restrict results to scholarships tied to a specific study location. The discipline_id parameter accepts a numeric string to filter by field of study; known values include 7 for Engineering & Technology and 13 for Business. The page_size parameter controls how many results appear per page, accepting values from 1 to 100.
Pagination Behavior
Pagination is 1-based. Set page=1 to start from the first result set and increment to retrieve subsequent pages. The total field in every response tells you how many scholarships match the current filter combination, so you can calculate how many pages to request. If no filters are applied, the endpoint returns scholarships from the full Mastersportal index.
The Mastersportal API is a managed, monitored endpoint for mastersportal.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mastersportal.com 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 mastersportal.com 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 scholarship discovery tool filtered by study destination country using the
destination_countryparameter - Aggregate scholarship deadlines from the
deadlinefield to send automated reminders to applicants - Filter Engineering & Technology scholarships using
discipline_id=7for a STEM-focused funding database - Display provider names and grant details on a university financial aid portal
- Paginate through the full scholarship index using
totalandpage_sizeto build a local mirror for search indexing - Match scholarship descriptions to student profiles based on academic discipline and target country
- Track newly listed scholarships by comparing
totalcounts across periodic API calls
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Mastersportal have an official developer API?+
What does the search_scholarships endpoint return for each scholarship?+
Can I filter scholarships by both country and discipline at the same time?+
destination_country and discipline_id parameters can be combined in a single request. The response will include only scholarships that match both the specified country code and discipline ID.Does the API return program-level master's degree listings in addition to scholarships?+
Are all discipline IDs documented?+
7 for Engineering & Technology and 13 for Business. Other numeric IDs may be valid but are not listed in the current spec. You can fork this API on Parse and revise it to expose a disciplines lookup endpoint that maps all available IDs to their labels.