US CIP Codes Search

US CIP Codes Search
Search standardized Classification of Instructional Programs (CIP) code records for program discovery and field-of-study normalization.

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

Request Parameters:

appkey (string, required): Application key used for request authentication.

keyword (string, optional): CIP code or CIP title keyword.

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[].cipCode (string, required): CIP code.

data[].cipTitle (string, required): CIP title.

data[].cipLevel (string, optional): CIP hierarchy level when available.

data[].parentCipCode (string, optional): Parent CIP code 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 CIP code records by code or title keyword.

Normalize program names and field-of-study categories with standardized CIP metadata.

Support program finder, education taxonomy, and data enrichment workflows.

Combine with the US College Programs Data API to filter programs by CIP code.

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

Responses

🟢200成功

*/*

Body*/*

Example

{
    "data": [
        {
            "cipCode": "string",
            "cipFamily": "string",
            "cipTitle": "string",
            "cipYear": 0,
            "source": "string",
            "sourceUpdatedAt": "string"
        }
    ],
    "dataStatus": {
        "dataTotalCount": 0,
        "requestParameter": "string",
        "responseDateTime": "string",
        "status": "APPKEY_EXPIRED",
        "statusCode": 0,
        "statusDescription": "string"
    }
}

🟠401

🟠403

🟠404

Request

Request Code Samples

Responses