palemoky/chinese-poetry-api

Chinese Poetry API is a high-performance REST and GraphQL API service for classical Chinese poetry built in Go.

The service addresses the need for programmatic access to a large collection of classical Chinese poems spanning multiple dynasties and genres. It stores nearly 400,000 poems from Tang poetry, Song lyrics, Yuan opera, and other classical forms in a single database. The tool provides full-text search alongside specialized search by title, content, or author. A key technical feature is simultaneous storage of simplified and traditional Chinese variants, switchable via a language parameter, with optimized conversion performance. The service includes built-in IP-based rate limiting to prevent abuse and supports both REST and GraphQL query interfaces.

Developers building applications that need to query classical Chinese poetry should consider this tool if they require high concurrency handling and flexible search capabilities. The project suits use cases ranging from educational platforms to cultural applications. The service is containerized with Docker support for multiple architectures, making deployment straightforward. An online hosted version is available for testing before self-hosting.

The project shows consistent maintenance with regular updates to the codebase and active management of the underlying poetry dataset, which has been corrected for historical inaccuracies in dynasty assignments and author attributions. Development activity indicates ongoing refinement of both the API functionality and the data quality underlying the service.