[DEMO] US College Programs Data API

US College Programs Data API
Search standardized US college program and field-of-study data by institution, CIP code, credential level, state, tuition, earnings, debt, and source freshness fields.

Method: GET
Path: /v1/education/us/programs/search
Demo: https://api.gugudata.io/v1/education/us/programs/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.

keyword (string, optional): Keyword for program, CIP title, or institution name

cipCode (string, optional): CIP code prefix or full CIP code

state (string, optional): US state abbreviation

credentialLevel (string, optional): Credential level keyword

minEarnings (number, optional): Minimum median earnings

maxDebt (number, optional): Maximum median debt

sort (string, optional): Sort expression in the format documented by the endpoint.

pageIndex (integer, optional): One-based page index for pagination.

pageSize (integer, optional): Number of records returned per page.

Response Fields:

dataStatus.dataTotalCount (integer, required): Total number of records that match the request.

data[].unitId (integer, required): IPEDS UNITID

data[].institutionName (string, required): Institution name

data[].cipCode (string, required): CIP code

data[].programName (string, required): Program or field-of-study name

data[].credentialLevel (string, optional): Credential level

data[].medianEarnings (number, optional): Median earnings when available

data[].medianDebt (number, optional): Median debt when available

data[].sourceYear (integer, required): Source data year

data[].sourceUpdatedAt (string, optional): Source update timestamp

HTTP Status Codes:

200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.

400: Invalid request parameters or request format. Check required fields, data types, and request body format.

401: Missing or unknown application key. Provide a valid appkey with the request.

403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.

429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.

500: Internal service error. Retry later or contact support if the error persists.

503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

100 Request successful: No additional remark.

101 Invalid request parameters: No additional remark.

110 Internal server error: No additional remark.

Key Features:

Search US college programs by keyword, institution, CIP code, state, and credential level.

Use standardized CIP codes to connect program names, fields of study, and credential levels.

Filter programs by tuition, median earnings, median debt, credential level, and state fields when available.

Compare similar fields of study across institutions, states, and credential levels with consistent response fields.

Return institution identifiers, program names, CIP titles, award levels, source year, and source freshness fields.

Power major finder pages, study search products, education data enrichment, and program comparison workflows.

Support AI agents with normalized field-of-study records for retrieval, shortlisting, and answer grounding.

Combine with the US College Institutions Data API to move from a program search to matching schools and locations.

Details:
https://gugudata.io/details/us-college-programs

Responses

🟢200成功

*/*

Body*/*

Example

{
    "data": [
        {
            "cipCode": "string",
            "cipTitle": "string",
            "city": "string",
            "credentialLevel": "string",
            "debtToEarnings": 0,
            "graduates": 0,
            "institutionName": "string",
            "medianDebt": 0,
            "medianEarnings": 0,
            "programName": "string",
            "source": "string",
            "sourceUpdatedAt": "string",
            "sourceYear": 0,
            "state": "string",
            "tuitionInState": 0,
            "unitId": 0
        }
    ],
    "dataStatus": {
        "dataTotalCount": 0,
        "requestParameter": "string",
        "responseDateTime": "string",
        "status": "APPKEY_EXPIRED",
        "statusCode": 0,
        "statusDescription": "string"
    }
}

🟠401

🟠403

🟠404

Request

Request Code Samples

Responses