GeneLab Public API

NASA GeneLab provides a RESTfulApplication Programming Interfaces (API) to its full-text search, and data andmetadata retrieval capabilities. The API provides a choice of standard weboutput formats, either JavaScript Object Notation (JSON) or Hyper Text MarkupLanguage (HTML), of query results. The GeneLab Data Query API returns metadataon data files associated with dataset(s), including the location of these filesfor download via https. The GeneLabMetadata Query API returns entire sets of metadata for inputdataset accession numbers. TheGeneLab Dataset Search API can be used to searchdataset metadata by keywords and/or metadata. It can also be usedto provide search of three other omics databases: the National Institutes ofHealth (NIH) / National Center for Biotechnology Information's (NCBI) GeneExpression Omnibus (GEO); the European Bioinformatics Institute's (EBI)Proteomics Identification (PRIDE); the Argonne National Laboratory's (ANL)Metagenomics Rapid Annotations using Subsystems Technology (MG-RAST).

Data Query API

Syntax

https://genelab-data.ndc.nasa.gov/genelab/data/glds/files/{GLDS_STUDY_IDs}/?page={CURRENT_PAGE_NUMBER}&size={RESULTS_PER_PAGE}

Returns: JSON-formatted response

Example requests:

• Single study request using GLDS accession number
• https://genelab-data.ndc.nasa.gov/genelab/data/glds/files/87
• Multiple studies request using combination of range and comma separated list
• https://genelab-data.ndc.nasa.gov/genelab/data/glds/files/137,87-95,13,20-50

 
NOTE: study_files element in the JSON response has the remote_url attribute, which can be used to obtain the specific download URL for the file by prefacing with the GeneLab data server address, https://genelab-data.ndc.nasa.gov . In the example query/response below, the first study file for GLDS-87 study in the response below can be downloaded from https://genelab-data.ndc.nasa.gov/datamanager/file/Home/genelab/genelab-data/GLDS-87/metadata/GLDS-87_metadata_Zanello_STS135-ISA.zip

Example Requests:

Single Study Request:

·          https://genelab-data.ndc.nasa.gov/genelab/data/glds/files/87

Response:

 {
 "hits": 1,
 "input": "87",
 "studies": {
 "GLDS-87": {
 "file_count": 7,
 "study_files": [
 {
 "date_created": 1516405876433,
 "file_name": "GLDS-87_metadata_Zanello_STS135-ISA.zip",
 "file_size": 4809,
 "remote_url": "/datamanager/file/Home/genelab/genelab-data/GLDS-87/metadata/GLDS-87_metadata_Zanello_STS135-ISA.zip"
 },
 {
 "date_created": 1506008634109,
 "file_name": "GLDS-87_microarray_14R_(Mouse430_2).CEL.gz",
 "file_size": 6374949,
 "remote_url": "/datamanager/file/Home/Public/genelab/GLDS-87/microarray/GLDS-87_microarray_14R_(Mouse430_2).CEL.gz"
 },
 {
 "date_created": 1506008634109,
 "file_name": "GLDS-87_microarray_16R_(Mouse430_2).CEL.gz",
 "file_size": 6274393,
 "remote_url": "/datamanager/file/Home/Public/genelab/GLDS-87/microarray/GLDS-87_microarray_16R_(Mouse430_2).CEL.gz"
 },
 {
 "date_created": 1506008634109,
 "file_name": "GLDS-87_microarray_20R_(Mouse430_2).CEL.gz",
 "file_size": 6384622,
 "remote_url": "/datamanager/file/Home/Public/genelab/GLDS-87/microarray/GLDS-87_microarray_20R_(Mouse430_2).CEL.gz"
 },
 {
 "date_created": 1506008634109,
 "file_name": "GLDS-87_microarray_52R_(Mouse430_2).CEL.gz",
 "file_size": 6297226,
 "remote_url": "/datamanager/file/Home/Public/genelab/GLDS-87/microarray/GLDS-87_microarray_52R_(Mouse430_2).CEL.gz"
 },
 {
 "date_created": 1506008634109,
 "file_name": "GLDS-87_microarray_54R_(Mouse430_2).CEL.gz",
 "file_size": 6017124,
 "remote_url": "/datamanager/file/Home/Public/genelab/GLDS-87/microarray/GLDS-87_microarray_54R_(Mouse430_2).CEL.gz"
 },
 {
 "date_created": 1506008634109,
 "file_name": "GLDS-87_microarray_58R_(Mouse430_2).CEL.gz",
 "file_size": 6329707,
 "remote_url": "/datamanager/file/Home/Public/genelab/GLDS-87/microarray/GLDS-87_microarray_58R_(Mouse430_2).CEL.gz"
 }
 ]
 }
 },
 "success": true,
 "total_hits": 2,
 "valid_input": [
 "87"
 ]
} 

Multiple Study Data Files Request:

• https://genelab-data.ndc.nasa.gov/genelab/data/glds/files/137,86-87

Response:

 {
 "hits": 3,
 "input": "137,86-87",
 "studies": {
 "GLDS-137": {
 "study_files": [
 {
 "file_name": "GLDS-137_metadata_RR3-Liver.zip",
 "remote_url": "/datamanager/file/Home/genelab/genelab-data/GLDS-137/metadata/GLDS-137_metadata_RR3-Liver.zip",