Clinical Trial Matcher

Read this first. This actor returns registry data. It is not medical advice and it does not decide whether anyone is eligible for a trial. Registry records can be incomplete or out of date. Always confirm eligibility, status and sites with the trial team and a clinician. Do not enter identifying patient data (use a rough age and sex only).

Search ClinicalTrials.gov and get one clean dataset: inclusion and exclusion criteria split into lists, age and sex limits checked against your patient, and the recruiting sites in the place you choose. Built on the official ClinicalTrials.gov API v2. No scraping.

Use it to shortlist trials for a patient or a condition, build a trial finder, track new trials in a disease area, or feed structured eligibility into a screening workflow.

What you get

• Search by condition, drug or device, free text, country, state and city
• Filters: recruitment status (open statuses by default), phase, study type, posted results
• Age and sex limit check: give an age and a sex and trials whose registered limits exclude them are dropped and not billed. Trials with no limit are kept. This compares two registry fields only; it is not an eligibility determination
• Eligibility parsed into inclusionCriteria and exclusionCriteria lists, with the original text available on request
• openLocations: only the recruiting or not-yet-recruiting sites in the country, state and city you asked for
• Optional central contacts (name, phone, email) as registered by the sponsor

Price

Pay per event. You pay for trials returned.

Event	Price
Actor start	$0.005 per start event. Apify bills one start event per GB of memory, minimum one; the default run uses 512 MB, so one event.
Clinical trial returned	$0.008

100 trials cost about $0.81. Trials dropped by the patient filters and error items are not charged. Set maxItems to cap spend.

Example input

{
    "condition": "melanoma",
    "country": "United States",
    "state": "Texas",
    "phases": ["PHASE2", "PHASE3"],
    "patientAge": 45,
    "patientSex": "MALE",
    "onlyWithOpenSite": true,
    "maxItems": 20
}

Example output

{
    "status": "found",
    "nctId": "NCT04370587",
    "title": "A Clinical Study of Intratumoral MVR-T3011 (T3011) Given as a Single Agent and in Combination With Intravenous Pembrolizumab in Participants With Advanced or Metastatic Solid Tumors",
    "overallStatus": "RECRUITING",
    "studyType": "INTERVENTIONAL",
    "phases": ["PHASE1", "PHASE2"],
    "conditions": ["Solid Tumor", "Melanoma", "HNSCC", "Sarcoma"],
    "interventions": [{ "type": "BIOLOGICAL", "name": "T3011" }, { "type": "COMBINATION_PRODUCT", "name": "T3011 + pembrolizumab" }],
    "sponsor": "ImmVira Pharma Co. Ltd",
    "enrollment": 30,
    "minimumAge": "18 Years",
    "maximumAge": null,
    "sex": "ALL",
    "healthyVolunteers": false,
    "inclusionCriteria": ["Age 18 years or older.", "..."],
    "exclusionCriteria": ["Have only uninjectable tumors..", "..."],
    "meetsRegisteredAgeSexLimits": true,
    "mismatchReasons": [],
    "openLocations": [{ "facility": "Mary Crowley Cancer Research", "city": "Dallas", "state": "Texas", "country": "United States", "zip": "75230", "status": "RECRUITING" }],
    "hasResults": false,
    "url": "https://clinicaltrials.gov/study/NCT04370587"
}

A run summary (trials returned, scanned, skipped, total matches) is saved under the key-value store key SUMMARY.

FAQ

Where does the data come from? The ClinicalTrials.gov API v2, a free public API of the U.S. National Library of Medicine. Records are as registered by trial sponsors.

Is meetsRegisteredAgeSexLimits an eligibility decision? No. It is null unless you set a patient age, sex or healthy-volunteer filter, and then it only compares the registered age, sex and healthy-volunteer fields. The inclusion and exclusion lists are the sponsor's own text, split into items. Eligibility is decided by the trial team.

Why do some criteria look cut mid-sentence? The lists follow the line breaks in the registered text. Turn on includeEligibilityText to see the original.

Are contacts personal data? Central contacts are the enquiry channel the sponsor published for recruitment. They are off by default. Use them only to enquire about a trial, and follow the anti-spam, privacy and marketing laws that apply to you; do not add them to mailing lists or resell them.

Can I search several conditions? Run once per condition, or put several terms in searchTerms.

Data and limits

• Source: ClinicalTrials.gov (NLM). Trial status and sites change often; results reflect the registry at run time.
• Up to 2000 trials per run.
• If a location filter returns nothing, the run summary carries a warning. US state codes (TX) and US/USA/UK are expanded; other abbreviations are not.
• Age limits are compared in years. Months, weeks and days are converted. Missing limits never exclude a trial.
• This is a research aid. It is not medical advice.