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.

  • verse for two word verse.
  • finale for a one word finale.

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