Scholarships API

Scholarships API

Search and browse University of Houston scholarship opportunities from 10+ sources.

Base URL

https://api.coogcasa.com/scholarships

Or directly:

https://coog-scholarships-backend.coog-planner.workers.dev

Data Sources

The API aggregates scholarships from:

Source Key	Name
main	UH Main Campus
foundation	UH Foundation
bauer	Bauer College of Business
engineering	Cullen College of Engineering
nsm	College of Natural Sciences
honors	Honors College
education	College of Education
arch	College of Architecture
tech	College of Technology
external	External Scholarships

Endpoints

Get All Scholarships

Returns all available scholarships with optional filtering.

GET /api/scholarships

Query Parameters:

Name	Type	Required	Description
source	string	No	Filter by source (e.g., bauer)
gpa	number	No	Filter by minimum GPA requirement
deadline	string	No	Filter by deadline (upcoming, open)
search	string	No	Search in title and description
limit	number	No	Number of results (default: 50)
offset	number	No	Pagination offset (default: 0)

Example:

GET /api/scholarships?source=engineering&gpa=3.5&limit=10

Response:

{
  "scholarships": [
    {
      "id": "eng-001",
      "title": "Engineering Excellence Scholarship",
      "source": "engineering",
      "amount": "$5,000",
      "deadline": "2026-03-15",
      "gpaRequirement": 3.5,
      "eligibility": [
        "Engineering major",
        "Junior or Senior standing",
        "U.S. Citizen or Permanent Resident"
      ],
      "description": "For outstanding engineering students...",
      "link": "https://uh.edu/engineering/scholarships/...",
      "createdAt": "2026-01-15T00:00:00.000Z",
      "updatedAt": "2026-01-20T00:00:00.000Z"
    }
  ],
  "total": 45,
  "limit": 10,
  "offset": 0,
  "hasMore": true
}

Get Scholarship by ID

Returns detailed information about a specific scholarship.

GET /api/scholarship?id={scholarshipId}

Parameters:

Name	Type	Required	Description
id	string	Yes	Scholarship ID

Response:

{
  "id": "eng-001",
  "title": "Engineering Excellence Scholarship",
  "source": "engineering",
  "sourceName": "Cullen College of Engineering",
  "amount": "$5,000",
  "deadline": "2026-03-15",
  "gpaRequirement": 3.5,
  "eligibility": [
    "Engineering major",
    "Junior or Senior standing",
    "U.S. Citizen or Permanent Resident"
  ],
  "requirements": [
    "Personal statement (500 words)",
    "Two letters of recommendation",
    "Unofficial transcript"
  ],
  "description": "The Engineering Excellence Scholarship recognizes...",
  "link": "https://uh.edu/engineering/scholarships/...",
  "contactEmail": "scholarships@egr.uh.edu",
  "tags": ["engineering", "merit-based", "renewable"],
  "createdAt": "2026-01-15T00:00:00.000Z",
  "updatedAt": "2026-01-20T00:00:00.000Z"
}

Get Sources

Returns list of available scholarship sources.

GET /api/sources

Response:

{
  "sources": [
    {
      "key": "main",
      "name": "UH Main Campus",
      "count": 150,
      "lastScraped": "2026-01-24T06:00:00.000Z"
    },
    {
      "key": "bauer",
      "name": "Bauer College of Business",
      "count": 35,
      "lastScraped": "2026-01-24T06:00:00.000Z"
    }
  ]
}

Get Statistics

Returns scholarship database statistics.

GET /api/stats

Response:

{
  "totalScholarships": 450,
  "bySource": {
    "main": 150,
    "foundation": 80,
    "bauer": 35,
    "engineering": 45
  },
  "upcomingDeadlines": 28,
  "lastUpdated": "2026-01-24T06:00:00.000Z"
}

Health Check

GET /health

Response:

{
  "status": "ok",
  "timestamp": "2026-01-24T12:00:00.000Z",
  "version": "1.0.1"
}

Search Examples

Find scholarships for business students with 3.0+ GPA

GET /api/scholarships?source=bauer&gpa=3.0

Search for “STEM” scholarships

GET /api/scholarships?search=STEM

Get scholarships with upcoming deadlines

GET /api/scholarships?deadline=upcoming&limit=20

Scholarship Object

Field	Type	Description
id	string	Unique identifier
title	string	Scholarship name
source	string	Source key
sourceName	string	Full source name
amount	string	Award amount (may be range)
deadline	string	Application deadline (ISO date)
gpaRequirement	number	Minimum GPA required
eligibility	string[]	Eligibility requirements
requirements	string[]	Application requirements
description	string	Full description
link	string	Application URL
contactEmail	string	Contact email (if available)
tags	string[]	Category tags
createdAt	string	When first added
updatedAt	string	Last update time

Error Responses

400 Bad Request

{
  "error": "Invalid source parameter"
}

404 Not Found

{
  "error": "Scholarship not found"
}

Rate Limits

• Standard rate: 60 requests/minute per IP
• Handled by Cloudflare WAF

Data Updates

Scholarship data is updated daily at 6 AM UTC via automated scraping.

Caching

Endpoint	Cache Duration
/api/scholarships	24 hours
/api/scholarship	24 hours
/api/sources	24 hours
/api/stats	1 hour