[DEMO] US College Institutions Data API

US College Institutions Data API
Search standardized US college and university institution data, including location, ownership, degree level, admissions, tuition, completion, enrollment, website, and source freshness fields.

Method: GET
Path: /v1/education/us/institutions/search
Demo: https://api.gugudata.io/v1/education/us/institutions/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.

name (string, optional): Name filter used by the endpoint dataset.

state (string, optional): US state abbreviation, such as CA or MA

city (string, optional): City filter used by the endpoint dataset.

ownership (string, optional): Ownership filter, such as public or private

degreeLevel (string, optional): Degree level keyword

minAdmissionRate (number, optional): Minimum admission rate

maxTuition (number, optional): Maximum in-state tuition

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[].state (string, required): US state

data[].website (string, optional): Institution website

data[].admissionRate (number, optional): Admission rate when available

data[].tuitionInState (number, optional): In-state tuition 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 colleges and universities by name, state, city, ownership, and degree level.

Filter institutions by tuition, admission rate, completion rate, enrollment size, and location fields when available.

Compare public, private nonprofit, private for-profit, two-year, and four-year institution attributes.

Return standardized school identifiers, website, city, state, latitude, longitude, and source freshness fields.

Power school finder pages, college comparison tools, education CRM enrichment, and market research workflows.

Support AI agents and search products with normalized institution records ready for ranking and retrieval.

Use pagination and sortable fields to build directories, dashboards, and backend data products at scale.

Combine with the US College Programs Data API to drill down from each school to available fields of study.

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

Responses

🟢200成功

*/*

Body*/*

Example

{
    "data": [
        {
            "admissionRate": 0,
            "city": "string",
            "completionRate": 0,
            "degreeLevel": "string",
            "institutionName": "string",
            "institutionType": "string",
            "netPricePrivate": 0,
            "netPricePublic": 0,
            "opeId": "string",
            "ownership": "string",
            "scorecardId": "string",
            "source": "string",
            "sourceUpdatedAt": "string",
            "sourceYear": 0,
            "state": "string",
            "studentSize": 0,
            "tuitionInState": 0,
            "tuitionOutOfState": 0,
            "unitId": 0,
            "website": "string",
            "zip": "string"
        }
    ],
    "dataStatus": {
        "dataTotalCount": 0,
        "requestParameter": "string",
        "responseDateTime": "string",
        "status": "APPKEY_EXPIRED",
        "statusCode": 0,
        "statusDescription": "string"
    }
}

🟠401

🟠403

🟠404

Request

Request Code Samples

Responses