Logo
NASA Open APIs API Documentation

GeneLab

Number of APIs: 1


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

Parameters

Data Type

Notes

Values

Required

{GLDS_STUDY_IDs}

Integers

Comma separated list with mixture of single GLDS accession numbers and ranges

ex. 87-95,137

Yes

{CURRENT_PAGE_NUMBER}

Integer

Current page number in pagination

Starts from 0

No

{RESULTS_PER_PAGE}

Integer

Number of results returned per page in pagination

Max 25 results per page

No

Example requests:

 
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",

ENDPOINTS