[DEMO] Chinese Poem

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

Method: GET
Path: /v1/text/chinese-poem?appkey={{appkey}}
Demo: https://api.gugudata.io/v1/text/chinese-poem/demo

Request Parameters:

appkey (string, required): Obtained after payment

keywords (string, optional): Search keywords for fuzzy matching against title, author, and content

pagesize (integer, optional): Number of results per page (default: 10)

pagenumber (integer, optional): Page number for pagination (default: 1)

type (string, optional): Filter by poetry type: 唐诗 (Tang Poetry), 宋诗 (Song Poetry), or 宋词 (Song Lyrics)

searchtype (string, optional): Search type (default: all)

Response Fields Count: 11
Response Field Examples:

dataStatus: Response status information

dataStatus.requestParameter: Echo of request parameters

dataStatus.statusCode: Custom status code (100 = success)

dataStatus.statusDescription: Status description message

dataStatus.responseDateTime: Server response timestamp

dataStatus.dataTotalCount: Total number of matching records

data: Array of poetry objects

data[].title: Title of the poem or lyric

... total 11 fields

Key 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

Details:
https://gugudata.io/details/chinesepoem

Responses

⚪0

application/json

Body

Example

{
  "dataStatus": {
    "requestParameter": "string",
    "statusCode": 0,
    "statusDescription": "string",
    "responseDateTime": "string",
    "dataTotalCount": 0
  },
  "data": [
    {
      "title": "string",
      "author": "string",
      "content": [
        {}
      ],
      "type": "string"
    }
  ],
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "OK",
    "ResponseDateTime": "2026-01-01 00:00:00",
    "DataTotalCount": 1
  }
}

Request

Request Code Samples

Responses