GET /pages/1.0/{id}.json

eol.org:encyclopedia-of-life-api

Summary: Get taxon page details
Operation ID: getPage
Auth: none

Retrieve comprehensive details about a specific EOL taxon page. This endpoint returns rich biodiversity data including scientific names, common names in multiple languages, taxonomy hierarchy, images, videos, sounds, text articles, and references. It's the primary endpoint for getting full species information after you've identified the correct EOL page ID through search. The response can be customized with parameters to include/exclude specific content types like images, synonyms, or common names.

Original spec description

Retrieve detailed information about a specific EOL page including scientific name, common names, media, and taxonomic information.

Usage Tips

- Use `common_names=true` to get vernacular names in multiple languages - Set `taxonomy=true` to include the full taxonomic hierarchy from different providers - Control media counts with `images_per_page`, `videos_per_page`, `sounds_per_page`, `texts_per_page` (0-75 each) - Use `vetted` parameter to filter content by trust level: 0=all, 1=trusted, 2=unreviewed, 3=untrusted, 4=trusted+unreviewed - The `id` parameter is the EOL page ID (not the scientific name) - get this from the search endpoint first - Set `synonyms=true` and `references=true` for complete taxonomic information

Parameters (19)

common_names (boolean, query, optional, default: False)

Return all common names for the taxon

details (boolean, query, optional, default: False)

Include all metadata for data objects

id (integer, path, required)

EOL page identifier

images_page (integer, query, optional, default: 1)

Page number for images

images_per_page (integer, query, optional)

Number of images to return (0-75)

Constraints: {'minimum': 0, 'maximum': 75}

language (string, query, optional, default: en)

Language code for results

Constraints: {'enum': ['ms', 'de', 'en', 'es', 'fr', 'gl', 'it', 'nl', 'nb', 'oc', 'pt-BR', 'sv', 'tl', 'mk', 'sr', 'uk', 'ar', 'zh-Hans', 'zh-Hant', 'ko', 'jp']}

licenses (string, query, optional, default: all)

Pipe delimited list of licenses (cc-by, cc-by-nc, cc-by-sa, cc-by-nc-sa, pd, na, all)

maps_page (integer, query, optional, default: 1)

Page number for maps

maps_per_page (integer, query, optional)

Number of maps to return (0-75)

Constraints: {'minimum': 0, 'maximum': 75}

references (boolean, query, optional, default: False)

Return all references for the taxon

sounds_page (integer, query, optional, default: 1)

Page number for sounds

sounds_per_page (integer, query, optional)

Number of sounds to return (0-75)

Constraints: {'minimum': 0, 'maximum': 75}

subjects (string, query, optional)

Pipe delimited list of subjects for text, or 'all'

synonyms (boolean, query, optional, default: False)

Return all synonyms for the taxon

taxonomy (boolean, query, optional, default: True)

Return taxonomy details from different hierarchy providers

texts_page (integer, query, optional, default: 1)

Page number for texts

texts_per_page (integer, query, optional)

Number of text objects to return (0-75)

Constraints: {'minimum': 0, 'maximum': 75}

videos_page (integer, query, optional, default: 1)

Page number for videos

videos_per_page (integer, query, optional)

Number of videos to return (0-75)

Constraints: {'minimum': 0, 'maximum': 75}

Examples (4)

TitleTypeURLAction
Get taxon page details openapi-spec https://eol.org/api/pages/1.0/328674.json
Get page details for Apis mellifera doc_extracted https://api.eol.org/pages/1.0/1045608.json
Get taxon page details openapi-spec https://eol.org/api/pages/1.0/328672.json
Get taxon page details probe-gate https://eol.org/api/pages/1.0/328672.json?details=False&images_page=1&videos_page=1&sounds_page=1&maps_page=1&texts_page=1&licenses=all&common_names=False&synonyms=False&references=False&taxonomy=True&language=en

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:49:05.725114 200 1409ms
2026-03-23 10:12:31.271460 200 9538ms
2026-03-23 09:22:44.447344 200 832ms
2026-03-23 09:19:15.634979 500 450ms
2026-03-21T23:17:54.710337 200 3063ms

Response Changes

WhenOldNew
2026-03-23 09:19:15.634979 71d362b72181 da0321d3386a
2026-03-23 09:22:44.447344 da0321d3386a a993cfe9ba1f
2026-03-23 10:12:31.271460 a993cfe9ba1f 2e29c0525543
2026-03-23 10:49:05.725114 2e29c0525543 71d362b72181