codeforamerica / clinical_trials_python

Python API for the ClinicalTrials.gov API

Clincal Trials Python API

A Python API wrapper for the ClincalTrials.gov API.

Documentation for ClinicalTrials.gov can be found here.

Usage

The Trials class only has two methods -- search and download. The same information from search is returned to the download method in ZIP file format.

>>> from clinical_trials import Trials
>>> t = Trials()
>>> t.search("alzheimer's disease")

>>> t.search('diabetes', 'cond')
>>> t.search('diabetes', 'condition')
>>> t.search(condition='diabetes')

>>> # Specify the number of trials turned.
... t.search(intervention='Fluoxetine', count=200)

>>> # Find trials no longer recruiting.
... t.search('lyme disease', recruiting='closed')

>>> # If you want plain XML returned back.
... t.search(sponsor='NHLBI', output_format=None)

>>> # You can also find trials by location -- up to 3 states or countries.
... t.search('cancer', state='TX')

>>> t.search('diabetes', state1='TX', state2='NY', state3='CA')
>>> t.search(condition='lyme disease', country1='US', country2='CA')

>>> # And you can download a ZIP file with the data.
... zip_file = t.download('cancer', count=500)

Copyright

Copyright (c) 2011 Code for America Laboratories.

See LICENSE for details.

clinical_trials_python's Issues

Problem installing api submodule

The original discussion with @mlyne started here.

PyPi doesn't have API submodule

Need to reupload to PyPi since it doesn't have API submodule.

Also, add git clone --recursive instructions to README.

Readme links down

Both the API information and documentation links in README are no longer correct

ImportError: cannot import name 'Trials' from partially initialized module

Trying to import, I got the error

ImportError: cannot import name 'Trials' from partially initialized module 'clinical_trials' (most likely due to a circular import) (C:\...\Anaconda3\lib\site-packages\clinical_trials\__init__.py)