Skip to main content

pytrials

https://img.shields.io/pypi/v/pytrials.svg https://github.com/jvfe/pytrials/workflows/pytest/badge.svg https://img.shields.io/pypi/l/pytrials Documentation Status

Python wrapper around the clinicaltrials.gov API. Documentation for the API can be found here: https://clinicaltrials.gov/api/

Tutorial

To install:

$ pip install pytrials

Basic Usage

from pytrials.client import ClinicalTrials

ct = ClinicalTrials()

# Get 50 full studies related to Coronavirus and COVID in csv format.
ct.get_full_studies(search_expr="Coronavirus+COVID", max_studies=50)

# Get the NCTId, Condition and Brief title fields from 1000 studies related to Coronavirus and Covid, in csv format.
corona_fields = ct.get_study_fields(
    search_expr="Coronavirus+COVID",
    fields=["NCT Number", "Conditions", "Study Title"],
    max_studies=1000,
    fmt="csv",
)

# Read the csv data in Pandas
import pandas as pd

pd.DataFrame.from_records(corona_fields[1:], columns=corona_fields[0])

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.0 (2020-07-06)

  • First release on PyPI.

0.1.2 (2020-07-11)

  • Minor fixes

0.2.0 (2021-04-24)

  • Improved test suite

  • Added get_study_count function

0.2.1 (2023-07-09)

  • Add classic prefix to url - #10

  • Raise error if API status is not ok - #11

0.3.0 (2023-07-09)

  • Add min_rnk option to get_study_fields - #12

1.0.0 (2024-05-01)

Migrates to version 2.0 of the ClinicalTrials API

  • Add support for the new API version

  • Add support for the new API fields

  • Remove get_study_count function

  • Allow CSV format in full_studies

Metadata

Release files for pytrials 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pytrials 1.0.0
File Size Uploaded
pytrials-1.0.0.tar.gz 14.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pytrials 1.0.0
File Interpreter ABI Platform
pytrials-1.0.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 21.5 kB

Release files / pytrials-1.0.0.tar.gz

Download URL pytrials-1.0.0.tar.gz
Size 14.5 kB
Tags Source
SHA-256 checksum
How to use checksums
15caa3a8d2485c12808aba775ea45c14836772c6fa9c5f6b87e400a829eb7b0e
BLAKE2b-256 checksum
How to use checksums
4225cfce60e8420ab506d06b8bbaff12969c75edf4b8c667b0a5701575970f39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.8

Release files / pytrials-1.0.0-py2.py3-none-any.whl

Download URL pytrials-1.0.0-py2.py3-none-any.whl
Size 7.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
0bc23462c6840a7229b6e8b1ae48ade50ded2621687a64d11302699f15d299ae
BLAKE2b-256 checksum
How to use checksums
7da44fb8d2cec56a2e8a304c62943016c8a17301523510a3225276c4e50dc1e5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.8

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page