Methods
| Method | Description |
|---|---|
| ping | returns either a positive response (indicating APIs are functional), or returns a negative response or nothing at all (indicating APIs are not functional at that time). |
| search | given a value for a specific element (e.g. scientific name=Homo sapiens), returns a paginated list of the EOL pages containing the search term |
| pages | takes an EOL page identifier and returns the scientific name for that page, and optionally returns information about common names, media (text, images and videos), and references to the hierarchies which recognize the taxon described on the |
| collections | returns all metadata about a particular collection and the items it contains indexed by EOL |
| data_objects | returns all metadata about a particular data object (text, image or video) indexed by EOL |
| hierarchy_entries | gives access to a single hierarchy indexed by EOL and its internal relationships |
| provider_hierarchies | lists the identifiers for all hierarchies supplied by content partners |
| hierarchies | given a hierarchy identifier, this method returns metadata about the hierarchy and lists the root taxa |
| search_by_provider |
get the EOL page IDs given a provider's hierarchy_id and the provider's own unique identifier
(e.g. search for the EOL page ID for the ITIS TSN 180542: http://eol.org/api/search_by_provider/1.0/180542?hierarchy_id=847 ) |
Response Formats
All APIs return by default an XML response. The API methods may be called without a format extension to get the XML response, and adding an XML extension will give an identical response:
http://www.eol.org/api/search/Robin
http://www.eol.org/api/search/Robin.xml
Every method can also return a JSON response by adding a .json extension
http://www.eol.org/api/search/Robin.json
... and JSONP by adding a callback parameter
http://www.eol.org/api/search/Robin.json?callback=some_neat_function
You can identify yourself to EOL by adding your API key to your requests (login and generate your key in your preference page):
http://www.eol.org/api/search/Robin?key=1111111111111111111111111111111111
Each method's documentation page has an example of both the XML and JSON formatted responses.
