VirusWorld logo VirusWorld logo
The Hormel Institute logo
Advanced search

VirusWorldDB REST API

Access to the VirusWorldDB data through our API.

API link: https://virus-world.org/api.php

Retrieves virus information for a given taxonomy id, including:
  • General information
  • Lineage
  • Uniprot IDs
  • Structures available (from VIPER, PDB and EMDB)
Example for Taxonomy ID 10246 
curl -X 'GET' -k 'https://virus-world.org/api.php/entry/10246' -H 'accept: application/json'
Request URL:
https://virus-world.org/api.php/entry/10246

Retrieves a list of viruses with its information as shown in taxonomy browser (main table). If filter not set, all results will be retrieved.
Viruses can be filtered by the following parameters:
Name Description
host (optional) Host of the virus. Filter: includes.
genome (optional) Genome type. Filter: exact match.
family (optional) Family, if set the genome is ignored. Filter: exact match.
genus (optional) Genus, if set the family and genome are ignored. Filter: exact match.
Example using filters: host is human and family is parvoviridae. 
curl -X 'GET' -k 'https://virus-world.org/api.php/list/viruses?host=human&family=parvoviridae' -H 'accept: application/json'
Request URL:
https://virus-world.org/api.php/list/viruses?host=human&family=parvoviridae

Retrieves a list of all the genome types in VirusWorld
Example: 
curl -X 'GET' -k 'https://virus-world.org/api.php/list/genome' -H 'accept: application/json'
Request URL:
https://virus-world.org/api.php/list/genome

Retrieves a list of families in VirusWorld. If filter not set, itl will retrieve all the families.
Name Description
genome (optional) Genome type of the family. Filter: exact match.
Example using filter: genome is Monodnaviria 
curl -X 'GET' -k 'https://virus-world.org/api.php/list/families?genome=monodnaviria' -H 'accept: application/json'
Request URL:
https://virus-world.org/api.php/list/families?genome=monodnaviria

Retrieves a list of genera in VirusWorld. If filter not set, it will retrieve all the genera.
Name Description
genome (optional) Genome type of the genus. Filter: exact match.
family (optional) Family of the genus. If set, genome will be ignored. Filter: exact match.
Example using filter: family is Parvoviridae 
curl -X 'GET' -k 'https://virus-world.org/api.php/list/genera?family=parvoviridae' -H 'accept: application/json'
Request URL:
https://virus-world.org/api.php/list/genera?family=parvoviridae