gradschools.com APIgradschools.com ↗
Access graduate program listings, degree-level filters, subject categories, and admissions articles from GradSchools.com via 6 structured endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/900478e0-03e0-416f-aba4-4679d036ed18/get_program_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the list of all major subject categories available on the site for graduate programs.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of objects with text (category name) and value (category ID)"
},
"sample": {
"data": {
"categories": [
{
"text": "Business",
"value": "21"
},
{
"text": "Criminal Justice & Legal",
"value": "29"
},
{
"text": "Education",
"value": "24"
},
{
"text": "Technology",
"value": "22"
}
]
},
"status": "success"
}
}About the gradschools.com API
The GradSchools.com API exposes 6 endpoints covering graduate program listings, subject and degree-level filtering, and editorial content from the site's Student Guide. The search_programs endpoint returns school name, program name, degree type, and URL for each matching result, filterable by masters, doctorate, or certificate level and by subject or category slug. get_informed_articles and get_article_detail give access to the full text of admissions and career guidance articles.
Program Discovery
search_programs is the primary listing endpoint. It accepts a degree_level parameter (masters, doctorate, or certificate), a category slug (e.g., business, technology), and a subject slug (e.g., accounting, computer-science). When both subject and category are supplied, subject takes precedence. Results come back as listings — an array of objects each containing school_name, program_name, degree, and url. Pagination is available via the page parameter; the response includes a pagination array of page links.
Category and Subject Lookups
Before calling search_programs, use get_program_categories to retrieve all valid major subject categories. Each item includes a text label and a value identifier. For the editorial side, get_informed_categories returns the category taxonomy used by the Student Guide articles, with each item carrying a text display name and a slug for filtering.
Editorial Content
get_informed_articles returns a paginated list of Student Guide articles — each with a title and url — covering topics like study tips, career advice, and graduate school preparation. Pass the url from those results into get_article_detail to retrieve the full article as both plain content (string) and html_content (HTML string), along with the article title.
Site-Wide Search
search_site accepts a required query string and an optional page parameter. It returns a results array where each item contains a title, url, and snippet. This endpoint spans both program listings and editorial articles, making it useful for open-ended keyword queries that don't map cleanly to a known subject slug.
- Build a graduate program finder filtered by degree level (masters, doctorate, certificate) and subject area.
- Aggregate school names and program names across a specific category like 'technology' or 'business' for market research.
- Populate a content feed of admissions and career advice articles using
get_informed_articlesandget_article_detail. - Implement a site-wide search feature using
search_siteto surface both programs and editorial results by keyword. - Map all available program categories via
get_program_categoriesto build a browseable subject taxonomy. - Extract full article text from the Student Guide to power a chatbot or resource library for prospective grad students.
| 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 GradSchools.com have an official developer API?+
What does `search_programs` return and how does the subject/category filter work?+
listings array includes school_name, program_name, degree, and url. You filter by passing a degree_level (masters, doctorate, or certificate) alongside either a category slug or a subject slug. When both are provided, subject takes precedence. Use get_program_categories first to retrieve valid category values.Does the API return detailed program data like tuition, application deadlines, or contact information?+
school_name, program_name, degree, and url — detailed fields like tuition, deadlines, enrollment size, or admissions contacts are not included. You can fork this API on Parse and revise it to add an endpoint that fetches the individual program detail page at the returned url.How does pagination work across the endpoints?+
search_programs, get_informed_articles, and search_site all accept an integer page parameter. search_programs also returns a pagination array in the response, where each item carries a page number and its corresponding URL. The other endpoints do not return explicit pagination metadata in the response body.Are there subject-level filters below the top-level categories?+
search_programs accepts a subject slug (e.g., accounting, computer-science) which is more specific than a category slug (e.g., business). However, the API does not include an endpoint that lists all valid subject slugs — only top-level categories are enumerable via get_program_categories. You can fork this API on Parse and revise it to add a subject-listing endpoint for a given category.