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

December 2024

Poetry Contest

Join our monthly contest for an opportunity to win cash prizes and attain global acclaim for your talent.
22
days
7
hours
1
minute

Special Program

Earn Rewards!

Unlock exciting rewards such as a free mug and free contest pass by commenting on fellow members' poems today!

Quiz

Are you a poetry master?

»
In the Edward Lear poem, which instrument does the Owl play while serenading the Pussy Cat?
A A guitar
B A violin
C A mandolin
D A banjo