EOL API: Search By Provider

Request

http://eol.org/api/search_by_provider/1.0/180542?hierarchy_id=903

Parameters

Name Values Default Notes
hierarchy_id any integer none the ID of the provider's hierarchy you are searching within. Check provider_hierarchies for valid IDs

Description

This method takes an integer or string which is the unique identifier for a taxon from some provider's database, and a hierarchy_id which represents the provider and returns the EOL page ID for that taxon. For example using the provider_hierarchies API, I can find out that the EOL hierarchy_id for the Integrated Taxonomic Information System (ITIS) is 903. I can then search EOL for the ITIS Taxonomic Serial Number (TSN) of 180542,Ursus maritimus, by calling http://eol.org/api/search_by_provider/1.0/180542?hierarchy_id=903

XML Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <results> <eol_page_id>11508631</eol_page_id> </results>

JSON Response

[ { "eol_page_id":328580 } ]