Chinese Classical Poetry Database

Search and retrieve Chinese classical poetry including Tang poems, Song poems, and Song lyrics with comprehensive keyword matching and filtering capabilities

Data & API Features

Comprehensive database of nearly 400,000 Chinese classical poetry entries;

Fuzzy keyword matching across title, author, and content;

Filter by poetry type: Tang poems, Song poems, and Song lyrics;

Flexible pagination support for large result sets;

Continuously updated and maintained dataset;

Full API support for HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3);

Fully compatible with Apple ATS;

Nationwide multi-node CDN deployment;

Ultra-fast response, API interface load balancing built with multiple servers;

Perfect for educational apps, cultural applications, and literature research.

Annual Subscription

$49$99

Try Demo Request

Try it for free!

Secure payment by Stripe

API Document

HTTP Protocol:HTTPS

HTTP Method:GET

HTTP Endpoint:https://api.gugudata.io/v1/text/chinese-poem?appkey={{appkey}}

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	Obtained after payment
keywords	string	false	N/A	Search keywords for fuzzy matching against title, author, and content
pagesize	integer	false	10	Number of results per page (default: 10)
pagenumber	integer	false	1	Page number for pagination (default: 1)
type	string	false	N/A	Filter by poetry type: 唐诗 (Tang Poetry), 宋诗 (Song Poetry), or 宋词 (Song Lyrics)
searchtype	string	false	all	Search type (default: all)

API Response Parameters

Name	Type	Remark
dataStatus	object	Response status information
dataStatus.requestParameter	string	Echo of request parameters
dataStatus.statusCode	integer	Custom status code (100 = success)
dataStatus.statusDescription	string	Status description message
dataStatus.responseDateTime	string	Server response timestamp
dataStatus.dataTotalCount	integer	Total number of matching records
data	array	Array of poetry objects
data[].title	string	Title of the poem or lyric
data[].author	string	Author name
data[].content	array	Array of strings containing the poem/lyric content, each element is one line
data[].type	string	Poetry type: 唐诗 (Tang Poetry), 宋诗 (Song Poetry), or 宋词 (Song Lyrics)

API Response Status Codes

Status Code	Explanation of Status Code	Remarks
200	API responding normally	For business status codes, see below under API Custom Status Codes.
400	Parameter error
402	APPKEY error	Please check if the APPKEY provided is the one obtained from the developer center.
403	Account overdue	Please pay attention to the E-mail reminders regarding order expiration.
429	Request rate limited	Requests cannot exceed 5 times per second. The CDN layer intelligently determines based on the frequency of IP requests. General high-frequency requests do not trigger this status code.
500	API response error