Search for presence of taxonomic names in EOL invasive species databases.

See Details for important information.

eol_invasive_(name = NULL, dataset = "all", searchby = grep,
  page = NULL, per_page = NULL, key = NULL, verbose = TRUE,
  count = FALSE, ...)
A taxonomic name, or a vector of names.
One of all, gisd100, gisd, isc, daisie, i3n, or mineps. See the Details for what each dataset ID.
One of 'grep' (exact match) or 'agrep' (fuzzy match)
A maximum of 30 results are returned per page. This parameter allows you to fetch more pages of results if there are more than 30 matches (Default 1)
Results to get per page
Your EOL API key; loads from .Rprofile.
(logical) If TRUE the actual taxon queried is printed on the console.
(logical) If TRUE, give back a count of number of taxa listed as invasive, if FALSE (default), the normal output is given.
Further args passed on to GET

IMPORTANT: When you get a returned NaN for a taxon, that means it's not on the invasive list in question. If the taxon is found, a taxon identifier is returned.

Beware that some datasets are quite large, and may take 30 sec to a minute to pull down all data before we can search for your species. Note there is no parameter in this API method for searching by taxon name.

This function is vectorized, so you can pass a single name or a vector of names.

It's possible to return JSON or XML with the EOL API. However, this function only returns JSON for now.

Options for the dataset parameter are

  • all - All datasets
  • gisd100 - 100 of the World's Worst Invasive Alien Species (Global Invasive Species Database)http://eol.org/collections/54500
  • gisd - Global Invasive Species Database 2013http://eol.org/collections/54983
  • isc - Centre for Agriculture and Biosciences International Invasive Species Compendium (ISC)http://eol.org/collections/55180
  • daisie - Delivering Alien Invasive Species Inventories for Europe (DAISIE) Species Listhttp://eol.org/collections/55179
  • i3n - IABIN Invasives Information Network (I3N) Specieshttp://eol.org/collections/55176
  • mineps - Marine Invaders of the NE Pacific Specieshttp://eol.org/collections/55331

Datasets are not updated that often. Here's last updated dates for some of the datasets as of 2014-08-25

  • gisd100 updated 6 mos ago
  • gisd updated 1 yr ago
  • isc updated 1 yr ago
  • daisie updated 1 yr ago
  • i3n updated 1 yr ago
  • mineps updated 1 yr ago


  • A list of data.frame's/strings with results, with each element named by the input elements to the name parameter.


See info for each data source at http://eol.org/collections/55367/taxa

  • eol_invasive_
eol_invasive_(name='Brassica oleracea', dataset='gisd')
eol_invasive_(name=c('Lymantria dispar','Cygnus olor','Hydrilla verticillata','Pinus concolor'),
eol_invasive_(name='Sargassum', dataset='gisd')
eol_invasive_(name='Ciona intestinalis', dataset='mineps')
eol_invasive_(name=c('Lymantria dispar','Cygnus olor','Hydrilla verticillata','Pinus concolor'),
eol_invasive_(name=c('Branta canadensis','Gallus gallus','Myiopsitta monachus'),
eol_invasive_(name=c('Branta canadensis','Gallus gallus','Myiopsitta monachus'), dataset='isc')

# Count
eol_invasive_(name=c('Lymantria dispar','Cygnus olor','Hydrilla verticillata','Pinus concolor'),
   dataset='gisd', count = TRUE)
Documentation reproduced from package traits, version 0.1.0, License: MIT + file LICENSE

Community examples

Looks like there are no examples yet.