Data API
The Insect Vectors of Plant Disease API is a RESTful JSON based API to query and retrieve vector species data. Information can be retrieved by querying a Taxon Name or ID.
The base URL for you should use is: https://insectvectors/api/vectors. This URL will return the entire dataset.
Taxon Name Service
URL: https://insectvectors.science/api/vectors?name={string}
Description: Retrieves a result set of vector species and their related data for matching taxon. The query is based on the canonical name excluding authority and date. The query is case insensitive.
Results: JSON encoded data.
Examples:
To retrieve data for taxon matching the name Philaenus spumarius.
1 |
|
returns the following result:
{ "count":1,"results":[{"ID":1804,"data":{"resources":[{"name":"resource","type":"set","value":{"resource_title":"Genome assembly ","resource_url":"https://zenodo.org/record/3368385#.X0UD0ZNKg4O","resource_description":"<p>SapFeederHub - Genome assembly version 1 of the meadow spittlebug Philaenus spumarius (Linnaeus, 1758) (Hemiptera, Aphrophoridae).<br></p>"}},{"name":"resource","type":"set","value":{"resource_title":"Spittle Bug Survey - Philaenus spumarius","resource_url":"https://www.spittlebugsurvey.co.uk/philaenus-spumarius","resource_description":""}}],"distribution":"<p>Philaenus spumarius is a common across Europe, Asia and North America. Specimens have also been recorded in New Zeland.</p>","continent":["Asia","Europe","North America"],"image":{"filename":"specimens/E004350.jpg","path":"/files/specimens/E004350.jpg","media":92,"thumbnail":"/thumbs/400×400/specimens/E004350.jpg","fieldname":"image","alt":"Philaenus spumarius","url":"http://insectvectors.science/files/specimens/E004350.jpg","extension":"jpg"},"genus":"Philaenus","specificepithet":"spumarius","infraspecificepithet":"","scientificnameauthority":"(Linnaeus 1758)"... }}]}
Taxon ID Service
URL: https://insectvectors.science/api/vectors/{int}
Description: Retrieves individual vector species data information by taxon ID.
Results: JSON encoded data.
Examples:
To retrieve data for taxon with ID 1804.
1 |
returns the following result:
{"ID":1804,"data":{"resources":[{"name":"resource","type":"set","value":{"resource_title":"Genome assembly ","resource_url":"https://zenodo.org/record/3368385#.X0UD0ZNKg4O","resource_description":"<p>SapFeederHub - Genome assembly version 1 of the meadow spittlebug Philaenus spumarius (Linnaeus, 1758) (Hemiptera, Aphrophoridae).<br></p>"}},{"name":"resource","type":"set","value":{"resource_title":"Spittle Bug Survey - Philaenus spumarius","resource_url":"https://www.spittlebugsurvey.co.uk/philaenus-spumarius","resource_description":""}}],"distribution":"<p>Philaenus spumarius is a common across Europe, Asia and North America. Specimens have also been recorded in New Zeland.</p>","continent":["Asia","Europe","North America"],"image":{"filename":"specimens/E004350.jpg","path":"/files/specimens/E004350.jpg","media":92,"thumbnail":"/thumbs/400×400/specimens/E004350.jpg","fieldname":"image","alt":"Philaenus spumarius","url":"http://insectvectors.science/files/specimens/E004350.jpg","extension":"jpg"},"genus":"Philaenus","specificepithet":"spumarius","infraspecificepithet":"","scientificnameauthority":"(Linnaeus 1758)"... }}
Downloadable Resources
The entire dataset is available as versioned JSON format files at the following location https://doi.org/10.5281/zenodo.5468947.