US News APIusnews.com ↗
Search 13,000+ scholarships from US News & World Report. Get award amounts, deadlines, eligibility criteria, and provider details via one API endpoint.
What is the US News API?
The US News Scholarship Finder API exposes a catalog of over 13,000 scholarships through a single search_scholarships endpoint, returning up to 11 results per page with fields covering award name, provider, description, average award amount, deadline date, and structured eligibility criteria including residency, enrollment status, ethnicity, and eligible majors.
curl -X GET 'https://api.parse.bot/scraper/0a73de7e-3ca4-4503-abb8-d25b83995be5/search_scholarships?page=1&sort=deadline-asc&keyword=engineering' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace usnews-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: US News Scholarship Finder — search, sort, and inspect results."""
from parse_apis.usnews_com_api import USNews, SortOption, InputFormatInvalid
client = USNews()
# Browse scholarships sorted by deadline, capped at 5 total results.
for scholarship in client.scholarships.search(sort=SortOption.DEADLINE_ASC, limit=5):
print(scholarship.name, "|", scholarship.average_award_amount, "|", scholarship.deadline)
# Keyword search: find one engineering scholarship and inspect its details.
hit = client.scholarships.search(keyword="engineering", sort=SortOption.BEST_MATCH, limit=1).first()
if hit is not None:
print(hit.name, "-", hit.provider)
print("Residency:", hit.residency)
print("Enrollment:", hit.enrollment)
if hit.majors is not None:
print("Majors:", hit.majors)
for criterion in hit.eligibility_criteria:
print(" •", criterion)
# Demonstrate typed error handling for an invalid sort value.
try:
client.scholarships.search(sort="not-a-valid-sort", limit=1).first()
except InputFormatInvalid as e:
print("Caught expected error:", e.message)
print("exercised: scholarships.search (browse + keyword + error handling)")
Search scholarships by keyword with sorting and pagination. Returns up to 10-11 scholarships per page from a catalog of 13,000+. Each result includes award name, provider, description, amount, deadline, eligibility criteria (residency, enrollment, ethnicities, majors), and application requirements. When keyword is omitted, returns all scholarships. Results are paginated server-side; use the page parameter to iterate.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-indexed). |
| sort | string | Sort order for results. |
| keyword | string | Free-text search keyword to filter scholarships (e.g. 'engineering', 'nursing'). Omitting returns all scholarships. |
{
"type": "object",
"fields": {
"sort": "string current sort order applied",
"total_count": "integer total number of matching scholarships",
"total_pages": "integer total number of pages",
"current_page": "integer current page number",
"scholarships": "array of scholarship objects with name, provider, description, program_url, average_award_amount, deadline, deadline_date, amount_interval, residency, enrollment, ethnicities, majors, eligibility_criteria, requirements, and is_featured"
},
"sample": {
"data": {
"sort": "deadline-asc",
"total_count": 754,
"total_pages": 76,
"current_page": 1,
"scholarships": [
{
"name": "NEACHMM Family Scholarship",
"majors": "Environmental / Environmental Health Engineering, Biology/Biological Sciences, General, Chemistry, General",
"deadline": "Aug. 25, 2026",
"provider": "New England Chapter of the Academy of Certified Hazardous Materials Managers",
"residency": "RI, VT, MA, CT, NH, ME",
"enrollment": "N/A",
"description": "The NEACHMM Family Scholarship is available to students who are residents of New England and are members of the New England Chapter of the Academy of Certified Hazardous Materials Managers (NEACHMM).",
"ethnicities": "N/A",
"is_featured": false,
"program_url": "https://www.neachmm.org/Scholarship",
"requirements": [
"Application Form"
],
"deadline_date": "2026-08-25",
"amount_interval": "One-Time",
"average_award_amount": "$1,000",
"eligibility_criteria": [
"Member of Alliance of Hazardous Materials Professionals, or their child, dependent, descendant, family, parent, or spouse",
"Resident of Connecticut, Maine, Massachusetts, New Hampshire, Rhode Island, or Vermont",
"High school senior or undergraduate student"
]
}
]
},
"status": "success"
}
}About the US News API
What the API Returns
The search_scholarships endpoint queries the full US News & World Report scholarship catalog. Each scholarship object in the response includes name, provider, description, program_url, average_award_amount, deadline, and deadline_date. Eligibility data is structured: you get explicit fields for residency requirements, enrollment level, eligible ethnicities, and qualifying majors — making it straightforward to filter results client-side by student profile.
Searching and Pagination
The keyword parameter accepts free-text input (e.g., engineering, nursing, first-generation) and filters against the full catalog. Omitting keyword returns the complete unfiltered list, paginated. Use page (1-indexed) alongside total_pages and total_count in the response to walk through result sets. The sort parameter controls result ordering; the current applied sort is echoed back as sort in every response so you can confirm the active state.
Response Metadata
Every response includes current_page, total_pages, and total_count, giving you everything needed to build pagination UIs or estimate dataset size for a given keyword query. With 13,000+ scholarships in the catalog, a broad keyword like science will return substantially more pages than a narrow term like veterinary.
Coverage Scope
Data covers scholarships listed in the US News Scholarship Finder, which skews toward U.S.-based undergraduate and graduate opportunities. Fields like average_award_amount and deadline_date reflect what is published in the listing; not every scholarship has all fields populated.
The US News API is a managed, monitored endpoint for usnews.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when usnews.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official usnews.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a scholarship search tool filtered by major using the
keywordparam and themajorseligibility field - Aggregate upcoming deadlines by querying broad keywords and sorting on
deadline_date - Display average award amounts alongside eligibility criteria to help students prioritize applications
- Power a college-planning app with scholarship recommendations matched to a student's residency and enrollment status
- Compile a dataset of STEM scholarships by iterating paginated results for keywords like 'engineering' and 'computer science'
- Surface scholarships by ethnicity eligibility field for targeted outreach or resource guides
- Monitor a scholarship provider's listings by filtering results and checking
program_urlfields for changes
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does US News & World Report have an official developer API for scholarship data?+
What eligibility fields does `search_scholarships` return for each scholarship?+
Are there limitations on pagination or result count per page?+
total_count and total_pages so you can calculate how many requests are needed to walk the full result set for a given keyword. There is no bulk-fetch parameter that returns more than one page at a time.Does the API support filtering by award amount range or deadline date directly?+
keyword text parameter and sort order. Award amount and deadline date are returned as response fields, so range filtering would need to be applied client-side after fetching results. You can fork this API on Parse and revise it to add server-side filters for amount range or deadline window.