Global QS World University Rankings
Search QS World University Rankings with filters and pagination
Bestseller
Chinese Poetry Tang Poetry Song Poetry Classical Literature
Chinese Classical Poetry Database
Search nearly 400,000 works of classical Chinese poetry
What can this API do?
Nearly 400,000 poetry records
Explore a large structured collection of Chinese classical poetry for products, research, and content discovery.
Tang and Song collections
Search Tang poems, Song poems, and Song lyrics through one consistent interface.
Title, author, and content search
Find works by matching keywords across the poem title, author name, or full text.
Poetry type filters
Limit results to the literary collection that best fits the learning or research experience.
Structured paginated results
Browse large result sets predictably with titles, authors, content, types, and result totals.
Education and cultural applications
Power reading tools, language-learning products, classroom resources, and digital humanities projects.
Annual plan
$49$99
Try it for free!
Sign In Sign in to get a trial key and test all APIs.
Secure checkout powered by Stripe
API Document
HTTP Protocol:HTTPS
HTTP Method:GET
HTTP Endpoint:https://api.gugudata.io/v1/text/chinese-poem
Response Type:application/json; charset=utf-8
DEMO Endpoint:https://api.gugudata.io/v1/text/chinese-poem/demo
Live Demo:Try Interactive Demo
Full API Docs:developers.gugudata.io
API Request Parameters
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | YOUR_APPKEY | Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type. |
| keywords | string | false | Keyword used for fuzzy matching against the searchable text fields supported by this endpoint. | |
| pagesize | integer | false | 10 | Number of records returned per page. |
| pagenumber | integer | false | 1 | One-based page number for pagination. |
| type | string | false | Poetry type filter. Accepted values are `唐诗`, `宋诗`, and `宋词`. | |
| searchtype | string | false | all | Search scope accepted by the upstream contract. The demo uses `all`. |
API Response Parameters
| Name | Type | Remark |
|---|---|---|
| dataStatus | object | Legacy response metadata. `dataStatus.statusCode` is not the HTTP status code for this endpoint family. |
| dataStatus.requestParameter | string | Normalized request parameters echoed by the service. Sensitive credentials are omitted when available. |
| dataStatus.statusCode | integer | Legacy upstream application status code. Successful demo responses currently return `100`. |
| dataStatus.statusDescription | string | Legacy upstream status message. Successful demo responses currently return a Chinese message. |
| dataStatus.responseDateTime | string | Response timestamp returned by the current service contract. |
| dataStatus.dataTotalCount | integer | Total number of records that match the request. |
| data | array<string> | Primary response payload returned by the endpoint. |
| data[].title | string | Title of the poem or lyric |
| data[].author | string | Author name |
| data[].content | array<string> | Array of strings containing the poem/lyric content, each element is one line |
| data[].type | string | Poetry type returned by the upstream dataset, such as `唐诗`, `宋诗`, or `宋词`. |
API Response Status Codes
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 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. |
Remote MCP
AI client access
Use this API through GuGuData Remote MCP
Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.
Endpoint
https://mcp.gugudata.io/mcpGeneric MCP configuration
{
"mcpServers": {
"gugudata": {
"url": "https://mcp.gugudata.io/mcp",
"transportType": "streamable-http"
}
}
}Code Snippets
Global University Data
Explore global university profiles, rankings, and student data
US College Institutions Data API
Search standardized US college and university data
US College Programs Data API
Search US college programs, credentials, costs, and outcomes