STANDS4 Web Services:

Poetry API

The Poetry API from STANDS4 enables you to get instant data from our vast poetry collection.

Request URL:

https://www.stands4.com/services/v2/poetry.php

Request parameters:

Parameter Value Required Default Description
uid string Y  

Your API user id

tokenid string Y  

Your valid developer token id

term string Y  

The word you would like to get poetry results for

format string N xml

The format in which you want the result returned (xml or json)

Sample request URL:

https://www.stands4.com/services/v2/poetry.php?uid=1001&tokenid=tk324324&term=grass&format=xml

Response elements:

Element Description
results

Contains all of the query responses

result

Contains each individual response

title

The poem title this result is referring to

poet

The writer of this work

poem

The poem lines

Sample response:

<?xml version="1.0" encoding="UTF-8"?>
<results>
    <result>
        <title>At Dieppe</title>
        <poet>Arthur Symons</poet>
        <poem>The grey-green stretch of sandy grass</poem>
    </result>
</results>
{
	"results": {
		"result": {
			"title": "At Dieppe",
			"poet": "Arthur Symons",
			"poem": "The grey-green stretch of sandy grass"
		}
	}
}

Want to use this service?

The Poetry API service is free to use for up to 100 queries per day.

For a premium commercial license, please contact us.

Apply here

March 2024

Poetry Contest

Join our monthly contest for an opportunity to win cash prizes and attain global acclaim for your talent.
12
days
19
hours
58
minutes

Browse Poetry.com

Quiz

Are you a poetry master?

»
Who wrote the 1916 poem "Out, Out—"?
A Robert Frost
B Elinor Frost
C Robert Browning
D Emily Dickinson