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.