All methods are GET requests.
Methods return data in JSON format.
Click on a method URL to see a sample response.
Returns a list of available versions with a URL for each version’s method.
Returns information about a particular version.
Returns information about a book for a particular version. Use an integer to specify the book.
Returns the given line for that book and version. Use integers to specify the book and line.
Practice sortes Virgilianae. Returns a random section of Virgil’s Aeneid.
Accepts the following arguments:
||Receive sortes Virgilianae from a different version of the Aeneid, such as the original latin. See the /versions method for a list of available versions.|
||Specify how many lines to receive. Max: 10|
||Receive sortes Virgilianae from a particular book of the Aeneid. Max: 12|
Without arguments, this method returns one line from a randomly chosen book of John Dryden’s translation of the Aeneid.
Perform a text search upon a particular verison of the Aeneid.
Takes the following arguments (shaded arguments are required):
||Specify which version to search. You may only search one version per query. See the /versions method for a list of available versions.|
||Returns lines where the search word appears. All searches are case insensitive.|
Queries may use the following syntax:
||Returns lines that contain the word. All searches are case insensitive.|
||Returns lines where all words appear, in any order and in any position. Separate words with a plus sign.|
||Returns lines where an exact phrase appears. Surround the phrase in single or double quotation marks. Separate words in the phrase with a plus sign or a space.|
||Returns lines with words that start with a string of letters. Use an asterix at the end of the string.|
Query types may be combined in a single search. Join each type with a plus sign. For example:
API requests are limited to one call per user per second.
The error code 429 (Too Many Requests) is returned for more frequent requests.
If a request fails, a 404 response is returned with a JSON message.
A 429 response (Too Many Requests), also with a JSON message, is returned when clients break the rate limits.
Please send questions and comments to firstname.lastname@example.org. Thank you.