I've been able to download specific data types from the TCGA portal (https://portal.gdc.cancer.gov/) using the Manifest files and the GDC Tool.

But it's not clear to me how to download the metadata (e.g. cancer type, stage, etc.) with the links to the UUIDs of a specific data type, e.g. the UUID of a methylation data file to the case UUID:


Any ideas?


1 Answer 1


To download metadata associated with a specific data file, such as the cancer type and stage, you can use the GDC API (Application Programming Interface). The API allows you to query the GDC database and retrieve information in a structured format, such as JSON or XML.

To download the metadata for a specific data file, you will need the file's unique identifier, also known as its UUID. In your example, the UUID of the methylation data file is "14dc6f1f-21d0-4b05-9ad5-1d52f5020b12".

To use the GDC API, you can construct a query using the GDC API endpoint and the file's UUID. For example, to retrieve the metadata for the methylation data file with the UUID "14dc6f1f-21d0-4b05-9ad5-1d52f5020b12", you could use the following query:


This query uses the "files" endpoint of the GDC API and specifies the file's UUID. The "expand=metadata" parameter tells the API to return the metadata associated with the file. The response will be in json format:

{"data": {"data_format": "TXT", "access": "open", "file_name": "5b6353ee-af39-4bb4-a801-1454dfbc338b.methylation_array.sesame.level3betas.txt", "submitter_id": "d67719e6-4149-4492-a265-1f5d5689b904", "data_category": "DNA Methylation", "acl": ["open"], "type": "methylation_beta_value", "platform": "Illumina Human Methylation 450", "file_size": 13168876, "created_datetime": "2022-02-15T17:17:23.357435-06:00", "md5sum": "ab0c90db97a3e12634ef3f54f3ec835d", "updated_datetime": "2022-02-16T19:13:44.087132-06:00", "file_id": "14dc6f1f-21d0-4b05-9ad5-1d52f5020b12", "data_type": "Methylation Beta Value", "state": "released", "experimental_strategy": "Methylation Array", "version": "1", "data_release": "32.0 - 36.0"}, "warnings": {"expand": "unrecognized values: [metadata]"}}

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.