What it returns
Every US college and every program from the US Department of Education's College Scorecard, in clean JSON.
Colleges:** name, city, state, website, ownership, degree level, locale, coordinates, accreditor, HBCU and online-only flags, undergraduate enrollment, **admission rate, average SAT, ACT midpoint**, in-state and out-of-state tuition, cost of attendance, **average net price**, Pell and federal loan rates, completion and retention rates, **median debt** and **median earnings 6 and 10 years after entry**. Programs (majors):** each field of study x credential at each school with graduate count, **median debt and monthly payment**, **median earnings 1, 4 and 5 years after graduation**, the share earning more than a high-school graduate, and national earnings benchmarks.
Common uses
College comparison and ROI tools. "Best-paying computer science degrees" rankings. Lead lists of institutions by state, size and type.
Request
POST https://api.pushbuild.com/college-scorecard/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
dataset | string: institutions, programs | Whole schools, or individual programs (field of study x credential). Default: "institutions". |
query | string | All words must appear in the school name (or city). |
unitIds | list of strings | e.g. 166027 (Harvard). |
states | list of strings | Two-letter codes. |
ownership | list of strings | public, nonprofit, for-profit. |
degreeTypes | list of strings | Colleges only: Certificate, Associate, Bachelor's, Graduate. |
minUndergraduates | integer | Colleges only. |
operatingOnly | boolean | Colleges only. Default: true. |
programQuery | string | Programs only, e.g. nursing, computer science. |
cipCodes | list of strings | Programs only, prefix match, e.g. 11 (computer science), 5138 (nursing). |
credentialLevels | list of strings | Programs only: 1 certificate, 2 associate, 3 bachelor's, 4 post-bacc cert, 5 master's, 6 doctoral, 7 professional, 8 graduate cert. |
withEarningsOnly | boolean | Programs only. Default: false. |
sortBy | string: none, earnings, debt, size, admission, netPrice, graduates | Ordering of results. Default: "none". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/college-scorecard/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "university", "maxItems": 20}'
Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.24 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Academic Papers Search API
Search scholarly papers across Crossref (150M+ works), arXiv and PubMed in one run.
Article & Web Page to Markdown API
Turn any URLs into clean, Markdown, text or JSON.
Book Search API
Search millions of books by keyword, title, author, subject or ISBN, plus author lookup.
Currency Exchange Rates API
Official European Central Bank reference exchange rates for 30+ currencies, daily since 1999.
CVE Vulnerability Lookup: NVD, CISA KEV, EPSS, OSV API
Look up CVEs by ID or keyword, or check open-source packages for known vulnerabilities.
DexScreener Scraper API
Real-time DEX pair data from DexScreener for any token, pair or search: price, liquidity, FDV, market cap, volume, buys and sells, price change, socials.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com