Discover/Thegradcafe API
live

Thegradcafe APIthegradcafe.com

Access data from thegradcafe.com.

Endpoint health
monitored
get_admission_result
search_admission_results
Checks pendingself-healing
Endpoints
2
Updated
1h ago
This call costs2 credits / call— charged only on success
Try it
1-based page number; each page holds up to 20 results.
Free-text search over school and program names, e.g. computer science. Optional when institution or program is given.
Degree type filter. Omitted = all degree types.
Application season code: F or S followed by a two-digit year, e.g. F25 = Fall 2025, S26 = Spring 2026. Omitted = all seasons.
Program name filter as written on the site (e.g. Computer Science).
Decision outcome filter. Omitted = all outcomes.
Latest submission (added on) date to include, ISO date YYYY-MM-DD.
Earliest submission (added on) date to include, ISO date YYYY-MM-DD.
Institution/school name filter as written on the site (e.g. Stanford University).
Latest decision date to include, ISO date YYYY-MM-DD.
Earliest decision date to include, ISO date YYYY-MM-DD.
api.parse.bot/scraper/90a2e4cf-c5fa-435d-8f5c-db85f7ab3cf8/<endpoint>
Ready to send
Fill in the parameters and hit sign in to send to see live response data here.
Call it over HTTPgrab a free API key at signup
curl -X GET 'https://api.parse.bot/scraper/90a2e4cf-c5fa-435d-8f5c-db85f7ab3cf8/search_admission_results?program=Computer+Science&added_end=2025-01-31&added_start=2025-01-01&decision_end=2025-01-20&decision_start=2025-01-10&query=computer+science' \
  -H 'X-API-Key: $PARSE_API_KEY'
All endpoints · 2 totalmissing one? ·

Searches TheGradCafe's crowdsourced admission results. One call returns one page of up to 20 result summaries (newest first) plus the site's approximate total match count. Filter by free-text query and/or exact-ish institution and program names, and optionally by degree type, decision outcome, application season, and decision/added date ranges. At least one of query, institution or program must be given. Paging is controlled by `page` (1-based, default 1); `has_more` reports whether a next page exists. Each summary carries the numeric `result_id` accepted by get_admission_result. Applicant stats (gpa, gre_*) are self-reported and null when the submitter did not provide them; decision_date is the month/day shown in the listing without a year (the detail endpoint returns the full date). A search that matches nothing returns an empty results array with total_results 0.

Input
ParamTypeDescription
pageinteger1-based page number; each page holds up to 20 results.
querystringFree-text search over school and program names, e.g. computer science. Optional when institution or program is given.
degreestringDegree type filter. Omitted = all degree types.
seasonstringApplication season code: F or S followed by a two-digit year, e.g. F25 = Fall 2025, S26 = Spring 2026. Omitted = all seasons.
programstringProgram name filter as written on the site (e.g. Computer Science).
decisionstringDecision outcome filter. Omitted = all outcomes.
added_endstringLatest submission (added on) date to include, ISO date YYYY-MM-DD.
added_startstringEarliest submission (added on) date to include, ISO date YYYY-MM-DD.
institutionstringInstitution/school name filter as written on the site (e.g. Stanford University).
decision_endstringLatest decision date to include, ISO date YYYY-MM-DD.
decision_startstringEarliest decision date to include, ISO date YYYY-MM-DD.
Response
{
  "type": "object",
  "fields": {
    "page": "the page number returned",
    "count": "number of results on this page",
    "results": "array of result summaries: result_id (string, use with get_admission_result), school, program, degree, added_on (submission date text), decision (Accepted/Rejected/Interview/Wait listed), decision_date (month/day text, no year), season (e.g. Fall 2025), applicant_origin (American/International), gpa, gre_general, gre_verbal, gre_analytical_writing (numbers or null)",
    "has_more": "true when a following page exists",
    "total_results": "site's approximate total number of matching results (integer, null if not shown)"
  },
  "sample": {
    "data": {
      "page": 1,
      "count": 20,
      "results": [
        {
          "gpa": null,
          "degree": "PhD",
          "school": "Stanford University",
          "season": "Fall 2026",
          "program": "Computer Science",
          "added_on": "Feb 06, 2026",
          "decision": "Accepted",
          "result_id": "997336",
          "gre_verbal": 170,
          "gre_general": 169,
          "decision_date": "Feb 06",
          "applicant_origin": "American",
          "gre_analytical_writing": 6
        }
      ],
      "has_more": false,
      "total_results": 251
    },
    "status": "success"
  }
}

About the Thegradcafe API

The Thegradcafe API on Parse exposes 2 endpoints for the publicly available data on thegradcafe.com. Calls return JSON over HTTPS and are billed per successful response.

Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.