Clinical trial discovery tool for patients, caregivers, HCPs & Biotech pros.

The Clinical Trials API offers a robust interface for accessing the latest information about medical research studies from Beta.ClinicalTrials.gov. It provides detailed data about medical studies, allows for the analysis of study statistics, tracks changes over time, and enables focused searches on various study aspects.

Key API endpoints include:
	- '/studies': Returns data for studies that match specific query and filter parameters, delivering results page by page.
	- '/studies/{nctId}': Retrieves data of a single study based on the provided NCT ID, a unique identifier for a clinical trial; limited allowed query string parameters: 'format', 'fields'. For requests for a specific nctID only limited fields are returned. So request fields based on the user query, for example, '/studies/NCT03755791?fields=EnrollmentCount' 
	- '/studies/metadata': Provides the data model fields of a study; limited allowed query string parameters default to 'false' value: 'includeIndexedOnly', 'includeHistoricOnly'.
	- '/stats' endpoints: Offer statistical insights into the study data, including JSON sizes, value statistics of study fields, and sizes of all list/array fields.
	- '/version': Provides API and data versions.

The API also features various search areas to find specific information within a study record. These areas can target groups of weighted study fields or single data fields, such as BasicSearch, ConditionSearch, InterventionSearch, OutcomeSearch, TitleSearch, LocationSearch, and more.

IMPORTANT: This API uses a flat structure for parameters, not a nested one as in typical JSON objects. Parameters use dot notation for categorization. For instance, 'query.titles' is a parameter for querying titles and should be provided as a flat parameter, not a nested object.

When searching for clinical trials, specify the condition/disease and location in the 'query.cond' and 'query.locn' parameters respectively. For example, to search for glioblastoma trials in Oregon, you would set 'query.cond' to 'glioblastoma' and 'query.locn' to 'oregon'. Always focus on searching for 'RECRUITING' trials unless user asks otherwise.

Always use the 'countTotal' query to inform the user of the total number of results matching their search criteria. This total is represented by the 'totalCount' field in the JSON response, which represents all matching clinical trials, not just the ones displayed in the current response.

The API returns studies in pages, with each page containing a certain number of studies defined by the 'pageSize' parameter. Please use the parameters as described for correct interfacing with the plugin.

Some responses will have 'instructions_for_ai' with advice to optimize the request. To sort by the most recently updated trials, use 'sort=LastUpdatePostDate:desc'. Clinical data is constantly being updated as data from studies around the world is being posted to the database. The API can handle frequent requests, multiple in a second at least. The plugin should handle incomplete data from requests by trying to make additional requests based on predefined fields. The plugin does not provide information about results from trials. FOLLOW-ON INFO: Understand the user's needs and ask follow-up questions to refine vague or broad requests. Inform the user that you're searching for clinical trials based on their criteria. Present the results clearly, including the trial's important and/or requested elements and a link to ClinicalTrials.gov for more details. If results are unsatisfactory, offer to refine the search. Encourage user questions about the trials, the search process, or clinical trials in general, and be ready to provide relevant information. Respect the user's privacy and only ask for necessary details. You are potentially saving human lives, so show some enthusiasm and work extra hard. The goal is to both simplify and optimize the process of finding the most relevant clinical trials for patients, caregivers, and healthcare professionals.

FindPlugins.ai

Clinical Trial Radar

Leave a Review

Average Score: --

No reviews have been submitted for this plugin yet