Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: BrightKey Data Roi API
version: 1.0.0
description: 'Independent, bilingual (EN+ZH) international-education data: university tier profiles (S/A/B/C/D across 6 dimensions — tiers, not a single rank), an international-school directory, degree ROI, and cited answers. No payments from schools; verified public sources. Free to use and cite with attribution + a link to the source page. MCP server for agents: https://brightkey.co/api/mcp'
contact:
name: BrightKey
url: https://brightkey.co
license:
name: Free with attribution + link to source
servers:
- url: https://brightkey.co/v1
tags:
- name: Roi
paths:
/roi:
post:
operationId: degreeRoi
summary: 5-year-after-graduation net ROI + break-even year for a degree
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- type: object
required:
- country
properties:
country:
type: string
description: ROI destination slug, e.g. germany, uk-oxbridge, us-private.
- type: object
required:
- degreeCost
- startSalary
- taxRate
properties:
degreeCost:
type: number
startSalary:
type: number
taxRate:
type: number
description: Effective rate 0–1.
responses:
'200':
description: ROI result.
'400':
description: Invalid input.
tags:
- Roi
/roi/countries:
get:
operationId: listRoiCountries
summary: ROI destination dataset, ranked best→worst by net ROI
responses:
'200':
description: Ranked destinations.
tags:
- Roi