Data API docs · H-2, PERM and OPT programs
ICE SEVP Top-200 OPT / STEM-OPT employers, ranked (Data Pro)
GET https://usefootnote.com/api/data/v1/opt/top-employers
ICE SEVP's ranked Top-200 employers of F-1 OPT and STEM-OPT students. Each row: rank, employer, opt_students, stem_opt_students, and opt_or_stem_opt_students — the source's OWN published combined count and the list's sort key, which is NOT opt + stem (a student in both programs is counted once per program). Footnote never computes a total. These are STUDENTS on work authorization, not employees hired. DATA PRO dataset: a free key receives 403 upgrade_required.
Tier
Data Pro and above. Free and Developer keys receive a 403 upgrade_required that names this dataset and the way up — never a silent 404.
| Tier | Calls | Burst | WARN window |
|---|---|---|---|
| Free | 50/day | 10/min | 30 days |
| Developer | 1,000/day | 30/min | 12 months |
| Data Pro | 10,000/day | 120/min | 24 months |
| Enterprise | 100,000/day | 600/min | full archive |
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| fy | integer | no | 4-digit SEVP report year. Default: latest on file. |
| limit | integer 1–200 | no | Rows to return, 1–200 (default 25). |
Example
curl -s "https://usefootnote.com/api/data/v1/opt/top-employers" \ -H "Authorization: Bearer fn_live_YOUR_KEY"
200 — { report_year, count, employers[] }. opt_or_stem_opt_students is the source's combined figure, never opt + stem. Every response is { data, meta }; rate-limit headers (x-ratelimit-limit, x-ratelimit-remaining) ride on every call.
Clients
npx footnote-data wraps this endpoint at the prompt (see the package README); the remote MCP server at https://usefootnote.com/api/mcp exposes it as a tool for agents. Licensing: CC BY 4.0 for display with attribution; commercial use on Data Pro and above.
Also in H-2, PERM and OPT programs
Need more depth than the free window? Developer is $29/mo, Data Pro $79/mo or $790/yr — plans on /data. Get a free key from your account.