# Poetry Foundation API

> 2 public methods for Poetry Foundation (poetryfoundation.org), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by Poetry Foundation.

- Page: https://fous.com/methods/poetryfoundation.org

## Methods

### [Search poems](https://fous.com/methods/poetryfoundation.org/search-poems.md)

`poetryfoundation.org/search_poems`, read. Finds poems matching a topic or occasion, or poems by a named poet, in Poetry Foundation search order. Older magazine poems without public text have no first two lines; untagged poems have no themes or occasions.

Returns: title, poet, first two lines, themes or occasions, poem link

### [Get poem by title](https://fous.com/methods/poetryfoundation.org/get-poem.md)

`poetryfoundation.org/get_poem`, read. Finds a poem on Poetry Foundation by title (optionally by poet) and returns its full public text, poet, printed source, publication year and subject tags.

Returns: title, poet, full text, source, publication year, themes, tags, poet page link, poem link