Downloading Content for Analysis
This page is recommended for advanced users. It explains how to download study record data in Extensible Markup Language (XML), a machine-readable format, and in other data formats.
The structure of study records in XML is defined by this XML schema.
Use of ClinicalTrials.gov data is subject to these Terms and Conditions.
- Download Study Information from the Search Results List
- ClinicalTrials.gov Application Programming Interface (API)
- Download All Study Record Content for Analysis
- Access or Download the Clinical Trials Transformation Initiative (CTTI)'s Database for Aggregate Analysis of ClinicalTrials.gov (AACT)
Download Study Information from the Search Results List
The Download option on the Search Results page is an advanced feature that allows you to download information about some or all of the studies shown in the search results:
Click on the Download link (shown above), which is located in the upper-right corner of the List tab on the Search Results page. A pop-up box containing download options will appear:
Number of Studies: Choose the number of studies you want to download using the dropdown list. Your options are:
- The top 10, 100, 1,000 or 10,000 studies retrieved by your search. These options will be available only for searches that find as many or more than the specified number of studies. For example, if your search finds fewer than 1,000 studies, "Top 10 Studies" and "Top 100 Studies" can be selected, but "Top 1000 Studies" will not appear in the dropdown list.
- All studies retrieved by your search (up to a maximum of 10,000 study records). For example, if your search finds 54 studies, "54 Found Studies" will appear in the dropdown list.
Download Table Contents (1 row per study):
Select Table Columns
Use the dropdown menu to choose which table columns are downloaded for each study and in what format:
- Displayed Columns. Choose this option to download only table columns shown onscreen. The default study columns shown onscreen are Row, Status, Study Title, Condition and Interventions. To change which columns are shown in your search results, close the window you are in, click on the Show/Hide Columns link (located on the right side of the search results List tab), and then add or remove columns by marking or unmarking the column names.
- All Available Columns. Choose this option to download all available table columns. Includes over 20 columns such as Status, Conditions, Interventions, Study Type, Phase, and Sponsor/Collaborators. For more information about columns, see Customize Your Search Results Display.
Select file format.
Use the dropdown list to select one of the following formats for your saved file:
- PDF. Save as Portable Document Format (PDF), a standard format accessible using the freely available Adobe Acrobat Reader DC.
- Plain text. Save as unformatted text that can be read in a simple editor, such as Notepad.
- Tab-separated values. Save each study as a separate line in the file, with tabs as delimiters, or spacers, between each field. This format is useful for importing study information into spreadsheets and databases.
- Comma-separated values. Save each study as a separate line in the file, with commas as delimiters, or spacers, between each field. This format is useful for importing study information into spreadsheets and databases.
- XML. Save as XML, a machine-readable format that will be most useful to advanced users.
Click on the Download button directly beneath the "Select file format" drop-down menu to save this file to your computer.
For Advanced Users - Download XML Study Record Content.
Click on the Download button under "For Advanced Users:" to save the complete XML for all study records (that is, all registration information as well as any available results information) retrieved by your search (up to a maximum of 1,000 study records) as a zip file or compressed package to your computer. (Sample zip file readers with free trial periods: WinZip and PKZip)
Note: It may take several minutes to download a large number of studies.
To download XML for more than 1,000 study records in a single zip file, see the next section on Use URL Parameters to Display and Save Data.
ClinicalTrials.gov Application Programming Interface (API)
A new ClinicalTrials.gov Application Programming Interface (API) is available for beta testing and feedback.
After further development, it is intended to replace the current API (described below).
Download Records from the Search Results List
To immediately begin downloading study records (that is, all registration information as well as any available results information) for the studies found by your search, add "download_fields" between "results/" and "?" in "search request" URL, and one or more of the following URL parameters to the end of the "search request" URL:
|down_count||Number of records to download: 10, 100, 1000, 10000||Specify if the top 10, 100, 1000, or 10,000 (maximum) studies retrieved by your search are to be downloaded.|
|down_flds||Fields to download: all, default||Specify "all" available fields listed in the Show/Hide Columns window or "default" fields (including Title, Status, Has Study Results, Conditions, and Interventions) in the download file.|
|down_fmt||File format: plain, csv, tsv, xml, pdf||Specify the format of the downloaded file. (See Select File Format)|
|down_chunk||Set of records to download: 1, 2, 3,...,N||Specify which set of records to include in the downloaded file relative to the option selected for the down_count parameter. For example, down_chunk=1 when down_count=10 indicates the first set of 10 study records (i.e., rows 1 to 10 on the Search Results List). For down_chunk=2 when down_count=10, the second set 10 study records (i.e., rows 11 to 20) is downloaded.|
*Bold text indicates the default setting for each parameter (used if that parameter is missing/not specified)
Entering the above URL in a browser searches for "cancer" in the Other Terms search field and downloads a PDF file (default file format when down_fmt is missing) that includes the default fields (when down_flds is missing) for the top 10 studies listed in rows 1 to 10 of the Search Results List (default when down_chunk is missing). To download the "second set" of 10 study records (that is, rows 11 to 20) for the same search as a plain text file, use the following URL:
Display a Single Record in XML
To display an individual study protocol record in your browser in XML, add the URL parameter "displayxml=true" to the end of a "show study" URL:
Some completed studies have results information posted on ClinicalTrials.gov (see How to Find Results of Studies). To include both protocol and results information, choose a study with posted results and use the URL parameter "resultsxml=true":
The resultsxml output is a superset of the protocol and study results XML. Do not include both the displayxml and resultsxml parameters in the URL.
Download Multiple Records in XML
To immediately begin downloading study records (that is, all registration information as well as any available results information) in XML, add "download fields" between "results/" and "?" in "search request" URL. Optionally, append the "down_chunk URL parameter to the end of a "search request" URL as described previously:
Note: It may take several minutes to download a large number of studies.
Downloading All Study Record Content for Analysis
A single zip file containing all study records available on ClinicalTrials.gov (that is, all registration information as well as any available results information for all study records) in XML format is available here:
- To download the zip file containing all public data, enter the following URL into your browser:
Note: This is a very large file. It will likely take several minutes to download the entire zip file. Additionally, many receiving systems may subject the zip file to automatic security/virus scanning. This scanning may take several additional minutes to complete before the zip file is ready for use. Please be patient.
The zip file contains multiple directories subdividing the large number of files into more manageable quantities. A top level "Contents.txt" file contains information about the number of study records and the date the studies were published.
Access or Download the Clinical Trials Transformation Initiative (CTTI)'s Database for Aggregate Analysis of ClinicalTrials.gov (AACT)
The CTTI Improving Public Access to Aggregate Content of ClinicalTrials.gov page provides instructions on accessing the database directly or downloading a static snapshot.
Supporting information, such as a data dictionary, database schema, and a guide for researchers and analysts, are also available on the AACT database page.