PoetryDB API

Overview

PoetryDB offers a free, unauthenticated REST API providing access to a database of poetry. Hosted on freetestapi.com, its primary utility lies in serving as a public resource for developers who need to integrate poetry content into applications, perform quick lookups, or conduct testing without the overhead of authentication or complex setup. The API exposes endpoints that allow retrieval of poems based on various criteria, including author, title, or specific lines within a poem. This makes it particularly useful for educational tools, content-driven applications, or experimental projects where a readily available source of literary text is beneficial.

Developers can query PoetryDB to fetch lists of all available authors, all titles by a specific author, or the full text of a poem given its author and title. The API's design prioritizes ease of use, with standard HTTP GET requests returning JSON formatted data. This simplicity makes it an accessible option for those new to API consumption or for projects where rapid prototyping and minimal integration effort are priorities. While it serves as a straightforward data source, developers should note its unauthenticated nature, which implies suitability for public data consumption rather than sensitive or rate-limited commercial applications.

The API's focus on foundational poetry data distinguishes it from broader literary APIs that might offer rich metadata, user reviews, or advanced search capabilities. Instead, PoetryDB provides direct access to the text and basic attribution, making it a focused tool for specific content integration tasks. Its fully free model further positions it as a valuable asset for non-commercial projects, academic endeavors, and developer learning environments. For example, a developer building a simple 'poem of the day' widget or a teaching application that displays classic verses could find PoetryDB to be a direct and efficient solution.

The API's hosting on a 'freetestapi' domain signals its intent as a resource primarily for experimentation and development. While it offers a consistent interface for data retrieval, users should consider its scope and features in line with its stated purpose as a free, publicly available testing and content integration tool. For more extensive literary data requirements, or features like user-generated content and detailed bibliographic information, developers might explore alternatives such as the Open Library API for book and author data or Google Books API for commercial book metadata.

Key features

• Poem Retrieval by Author: Access all poems written by a specified author. This allows for querying a complete collection of works from a particular poet.
• Poem Retrieval by Title: Fetch a specific poem by its title. This is useful for direct lookups when the exact title is known.
• Poem Retrieval by Line: Search for poems containing a specific line of text. This enables content-based searching within the poetry database.
• List All Authors: Retrieve a complete list of all authors available in the database. This can be used for building author directories or selection menus.
• List All Titles by Author: Get a list of all poem titles associated with a given author. This helps in navigating an author's bibliography.
• Unauthenticated Access: All endpoints are publicly accessible without the need for API keys or tokens, simplifying integration.
• JSON Response Format: Data is returned in a standard JSON format, compatible with most modern programming languages and web frameworks.
• Free to Use: The API is fully free, making it suitable for personal projects, educational purposes, and developer testing environments.

Pricing

As of 2026-05-28, PoetryDB is offered as a fully free service, requiring no payment or subscription. Its primary purpose is to provide a public, unauthenticated resource for poetry data without any associated costs.

For more details, refer to the PoetryDB homepage and API reference.

Common integrations

• Web Applications: Displaying poems or author lists on websites using JavaScript frameworks (e.g., React, Vue, Angular) or backend languages (e.g., Node.js, Python, Ruby).
• Mobile Applications: Integrating poetry content into iOS or Android apps for educational purposes, daily poem features, or literary exploration.
• Educational Tools: Building learning platforms that provide access to poetic works for students and educators.
• Content Generation: Populating databases or content management systems with poetry for blogs, articles, or literary archives.
• Developer Testing: Using a readily available public API for testing network requests, data parsing, and front-end rendering logic during development cycles, as highlighted by resources on how to consume JSON APIs with Fetch API.
• Chatbots and AI Assistants: Providing poetic responses or information about authors and titles within conversational interfaces.

Alternatives

• Open Library API: Provides extensive data on books, authors, and editions, including bibliographic information and cover images.
• Google Books API: Offers a comprehensive database of books, allowing search, retrieval of book information, and access to preview content for commercial and non-commercial use.
• Goodreads API (discontinued): Historically offered access to book and author data, user reviews, and social features for book enthusiasts. While discontinued for new applications, it set a precedent for literary community APIs.

Getting started

To begin using PoetryDB, you can make a simple HTTP GET request to one of its endpoints. For instance, to retrieve all available authors, you would query the /author endpoint. To get all poems by a specific author, you would use /author/:author_name. The following cURL example demonstrates how to fetch all poems by William Shakespeare.

curl -X GET "https://freetestapi.com/api/v1/PoetryDB/author/William Shakespeare"

This request will return a JSON array containing objects, where each object represents a poem by William Shakespeare, including its title and lines. You can then parse this JSON response in your preferred programming language or environment. For example, to fetch a specific poem by its title, such as "Sonnet 18" by William Shakespeare:

curl -X GET "https://freetestapi.com/api/v1/PoetryDB/author/William Shakespeare/title/Sonnet 18"

The API reference documentation on the PoetryDB homepage provides a full list of available endpoints and query parameters. No API key or authentication headers are required for any requests, simplifying the integration process significantly. Developers can integrate these endpoints directly into client-side JavaScript applications using the Fetch API or into backend services using HTTP client libraries.