STANDS4 Web Services:

Poetry API

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

Request URL:

http://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

Sample request URL:

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

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>

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