GET /random/2 — returns 2 randomly selected poems from the database.
PoetryLiteraturePublic DomainEnglish LanguageSearchOpen Data
Get Random Poems is an example object payload from PoetryDB, with 4 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
{
"summary": "Get random poems",
"description": "GET /random/2 — returns 2 randomly selected poems from the database.",
"request": {
"method": "GET",
"url": "https://poetrydb.org/random/2"
},
"response": {
"status": 200,
"body": [
{
"title": "Sonnet 18: Shall I compare thee to a summer's day?",
"author": "William Shakespeare",
"lines": [
"Shall I compare thee to a summer's day?",
"Thou art more lovely and more temperate:"
],
"linecount": "14"
},
{
"title": "Because I could not stop for Death",
"author": "Emily Dickinson",
"lines": [
"Because I could not stop for Death –",
"He kindly stopped for me –"
],
"linecount": "24"
}
]
}
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.