biocontext_kb.core.clinicaltrials
=================================

.. py:module:: biocontext_kb.core.clinicaltrials


Functions
---------

.. autoapisummary::

   biocontext_kb.core.clinicaltrials.get_recruiting_studies_by_location
   biocontext_kb.core.clinicaltrials.get_studies_by_condition
   biocontext_kb.core.clinicaltrials.get_studies_by_intervention
   biocontext_kb.core.clinicaltrials.get_study_details
   biocontext_kb.core.clinicaltrials.search_studies


Package Contents
----------------

.. py:function:: get_recruiting_studies_by_location(location_country, location_state = None, location_city = None, condition = None, study_type = 'ALL', age_range = 'ALL', page_size = 50)

   Find recruiting clinical trials by geographic location. Returns paginated results with summary breakdowns.

   :returns: Studies list with summary containing search location, total studies, study type/phase/condition breakdowns, recruiting locations or error message.
   :rtype: dict


.. py:function:: get_studies_by_condition(condition, status = 'ALL', study_type = 'ALL', location_country = None, page_size = 50, sort = 'LastUpdatePostDate:desc')

   Search trials by condition with summary statistics. Returns paginated results with breakdowns by status, study type, and phase.

   :returns: Studies list with summary containing condition searched, total studies, status/study type/phase breakdowns or error message.
   :rtype: dict


.. py:function:: get_studies_by_intervention(intervention, condition = None, phase = None, status = 'ALL', intervention_type = 'ALL', page_size = 50, sort = 'LastUpdatePostDate:desc')

   Search trials by intervention with condition and phase filters. Returns paginated results with breakdowns.

   :returns: Studies list with summary containing intervention searched, total studies, status/phase breakdowns, top conditions/sponsors or error message.
   :rtype: dict


.. py:function:: get_study_details(nct_id, fields = 'IdentificationModule,StatusModule,SponsorCollaboratorsModule,DescriptionModule,ConditionsModule,DesignModule,ArmsInterventionsModule,OutcomesModule,EligibilityModule,ContactsLocationsModule')

   Get complete trial details by NCT ID. Retrieves study design, eligibility, outcomes, locations, contacts, and metadata.

   :returns: Study details with protocol sections including identification, status, sponsors, description, conditions, design, interventions, outcomes, eligibility, locations or error message.
   :rtype: dict


.. py:function:: search_studies(condition = None, intervention = None, sponsor = None, status = None, phase = None, study_type = None, location_country = None, min_age = None, max_age = None, sex = None, page_size = 25, sort = 'LastUpdatePostDate:desc')

   Advanced search for trials with flexible multi-field filtering. Specify at least one search parameter.

   :returns: Paginated search results containing studies list with trial metadata or error message.
   :rtype: dict