For each request a different, random, doge poem is generated. The words are chosen randomly from Princeton University's WordNet database.
A url parameter of ?mode=alliteration will make DogePoet generate poems that contain words starting with the same character.
DogePoet also has an API for requesting your own random poetry. The API root is:
http://dogepoet.aaroniles.net/api/
Each path segment beyond the API root requests an additional random line by song element. The following elements are supported.
Return values are JSON objects with a single key poem. The poem value is a list of objects for each line in the poem. These objects have two keys, element and line for the sone element and chosen line respectively.
{ "poem": [ { "element": "verse", "line": "such mimic" }, { "element": "verse", "line": "much generational" }, { "element": "finale", "line": "excite" } ] }
The poems generated for the main page are two verses followed by a finale. This is equivalent to requesting http://dogepoet.aaroniles.net/api/verse/verse/finale