How to hit the PoetryDB API

PoetryDB at https://poetrydb.org serves public-domain poems. Fields go in the path, and several can be combined with commas and semicolons.

Authentication

None — no key, no signup. Every example runs as-is.

Full reference: https://github.com/thundercomb/poetrydb#readme

Get a poem by author and title

curl "https://poetrydb.org/author,title/Shakespeare;Sonnet%2018"
Run in PostTaco
Example response (trimmed) 
[
  {
    "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"
  }
]

List authors

curl https://poetrydb.org/author
Run in PostTaco
Example response (trimmed) 
{
  "authors": [
    "Adam Lindsay Gordon",
    "Alan Seeger"
  ]
}

Random poems

curl https://poetrydb.org/random/1
Run in PostTaco
Example response (trimmed) 
[
  {
    "title": "Fragment: Wine of the Fairies",
    "author": "Percy Bysshe Shelley",
    "lines": [
      "I am drunk with the honey wine",
      "Of the moon-unfolded eglantine,"
    ],
    "linecount": "11"
  }
]