NCBI Datasets is a new resource that lets you easily gather data from across NCBI databases.
NCBI Datasets is a resource that lets you easily gather data from across NCBI databases. You can use it to find and download sequence, annotation, and metadata for genes and genomes using our command-line interface (CLI) tools or NCBI Datasets web interface.
NCBI Datasets tools are under active development. To submit feedback, please create a GitHub issue or contact NCBI directly with your questions, comments or feature requests.
:warning: The NCBI Datasets command-line tools (CLI) v13.x and older, as well as the API v1, will be deprecated in June 2024 and then retired in December 2024. Please download and install the latest version using the instructions below.
Install the latest version (CLI v16.x) of the NCBI Datasets CLI tools, datasets and dataformat, using conda:
conda install -c conda-forge ncbi-datasets-cli
For other installation options, see our CLI tools download and install instructions.
Use datasets to download biological sequence data across all domains of life from NCBI.
Use dataformat to convert metadata included as part of the data package from JSON Lines format to other formats.
Use datasets to download a genome data package for the human reference genome GRCh38:
datasets download genome taxon human --reference --filename human-reference.zip
Use dataformat to extract selected fields of metadata from the downloaded data package for the human reference genome, GRCh38:
dataformat tsv genome --package human-reference.zip --fields organism-name,assminfo-name,accession,assminfo-submitter
Organism name Assembly Name Assembly Accession Assembly Submitter
Homo sapiens GRCh38.p14 GCF_000001405.40 Genome Reference Consortium
The Datasets CLI schematic below also outlines the available commands for the datasets CLI.
Download large numbers of genomes by first downloading a dehydrated zip archive and then accessing the data in three steps.
Try this example for the human reference genome:
Download the dehydrated zip archive:
datasets download genome accession GCF_000001405.40 --dehydrated --filename human_GRCh38_dataset.zip
Unzip the downloaded zip archive:
unzip human_GRCh38_dataset.zip -d my_human_dataset
Rehydrate to access the data:
datasets rehydrate --directory my_human_dataset/
For more information, see how to download large genome data packages.
NCBI Datasets provides sequence, annotation, metadata and other biological data as NCBI Datasets Data Package zip archives.
We currently offer four types of data package:
NCBI Datasets data packages include data report files that contain metadata about the requested records. Data report schemas describe each type of data report, including available fields, with descriptions and examples.