ChEMBL
App · 20 actions
Explore ChEMBL, EMBL-EBI's open database of bioactive molecules: search molecules by name, similarity, substructure or properties, read their structures and properties, list measured bioactivities against drug targets, approved drugs with their mechanisms, indications and warnings, and the papers behind the data. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Find molecules by properties | Find molecules whose calculated properties fall in the ranges you set: molecular weight, ALogP (lipophilicity), polar surface area, hydrogen bond donors and acceptors, rotatable bonds and rule-of-five breaks. |
| Find molecules containing a structure | Find molecules that contain a given structure as part of theirs, such as every compound with a quinoline ring. |
| Find similar molecules | Find molecules whose structure is like a given one, most similar first, with how alike each is in percent. |
| Get assay | Get one assay: what it measured, its type, the organism, cell line or tissue it used, its target and how sure ChEMBL is of that target, its conditions and the paper it comes from. |
| Get database status | Get the ChEMBL release being served, when it came out, and how many molecules, activities, targets and documents it holds. |
| Get document | Get one paper, patent or dataset: title, authors, journal, year, DOI, PubMed ID and abstract, with links. |
| Get molecule | Get everything ChEMBL holds on one molecule: its name and development stage, structure (SMILES, InChI, InChIKey), calculated properties such as molecular weight and ALogP, routes of administration, warnings, trade names, synonyms and ATC codes. |
| Get target | Get one target: its name, type, organism, and the proteins it is made of with their UniProt accessions and gene symbols. |
| List approved drugs | List approved drugs, one per active ingredient, most recently approved first: name, year of first approval, the companies behind it, ATC classes, routes, and any black box warning or withdrawal. |
| List ATC classes | Look up the WHO Anatomical Therapeutic Chemical (ATC) classes that sort drugs by organ system and use: every substance under a code (N02BA, salicylates) or the classes of a substance by name, each with all five levels spelled out. |
| List bioactivities | List measured results (IC50, Ki, EC50, % inhibition...) for a molecule, a target, an assay or a paper, with the value, units and pChEMBL potency of each. |
| List drug indications | List the diseases a drug is approved or in clinical trials for, or the drugs for a disease (such as asthma), with the furthest stage reached for each. |
| List drug warnings | List black box warnings and market withdrawals, for one drug or across all drugs: the kind of harm, the country, the year and the source. |
| List mechanisms of action | List how drugs act on their targets, such as 'Tyrosine-protein kinase ABL inhibitor', for a drug or for a target, with the action type and sources. |
| Look up ChEMBL ID | Find out what a ChEMBL ID names (a compound, target, assay, document, cell line or tissue), whether it is still in use, and its page on the ChEMBL website. |
| Search assays | Find assays (the experiments behind each measurement) by words in their description, such as 'hERG inhibition', optionally of one type: binding, functional, ADME, toxicity. |
| Search cell lines | Find the cell lines ChEMBL's assays use, by name (HeLa), tissue (lung) or organism, with their Cellosaurus and ontology IDs. |
| Search documents | Find the papers, patents and datasets ChEMBL's data come from by words in their title or abstract, optionally of one type or published since a year. |
| Search molecules | Find molecules by name, trade name, synonym or research code (aspirin, Gleevec, STI-571), best match first, optionally only approved drugs or those that reached a clinical phase. |
| Search targets | Find drug targets (proteins, complexes, organisms, cell lines) by name, gene symbol or UniProt accession, best match first, optionally of one type or in one organism. |
Find molecules by properties
Find molecules whose calculated properties fall in the ranges you set: molecular weight, ALogP (lipophilicity), polar surface area, hydrogen bond donors and acceptors, rotatable bonds and rule-of-five breaks. Narrow it to approved drugs or one kind of molecule, and sort by weight or ALogP.
Inputs
- Molecular weight at least
min_molecular_weightnumber - In g/mol, of the parent compound (salts aside).From 0 to 5000.
- Molecular weight at most
max_molecular_weightnumber - In g/mol, of the parent compound. Lipinski's limit is 500.From 0 to 5000.
- ALogP at least
min_alogpnumber - Calculated lipophilicity (how fat-soluble), -20 to 20.From -20 to 20.
- ALogP at most
max_alogpnumber - Calculated lipophilicity, -20 to 20. Lipinski's limit is 5.From -20 to 20.
- Polar surface area at most
max_polar_surface_areanumber - In square angstroms. Under 140 suits oral drugs.From 0 to 1000.
- H-bond donors at most
max_h_bond_donorsnumber - Hydrogen bond donors. Lipinski's limit is 5.From 0 to 100.
- H-bond acceptors at most
max_h_bond_acceptorsnumber - Hydrogen bond acceptors. Lipinski's limit is 10.From 0 to 100.
- Rotatable bonds at most
max_rotatable_bondsnumber - A measure of flexibility. Under 10 suits oral drugs.From 0 to 100.
- Rule-of-five breaks at most
max_rule_of_five_violationsnumber - How many of Lipinski's four limits it may break, 0 to 4.From 0 to 4.
- Development stage
stagetext - Only molecules that got this far. Leave empty for all.One of:
approved(Approved drugs only),phase_3(Phase 3 or later),phase_2(Phase 2 or later),phase_1(Phase 1 or later),clinical(Any clinical stage). - Molecule type
molecule_typetext - Only this kind of molecule. Leave empty for every kind.One of:
Small molecule,Protein,Antibody,Antibody drug conjugate(Antibody-drug conjugate),Oligonucleotide,Oligosaccharide,Enzyme,Gene,Cell. - Order
ordertext - How to sort them. Leave empty for ChEMBL's own order.One of:
lightest(Lightest first),heaviest(Heaviest first),least_lipophilic(Lowest ALogP first),most_lipophilic(Highest ALogP first). - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
moleculeslist- The molecules in those ranges
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"count": 1,
"molecules": [
{
"chembl_id": "CHEMBL25",
"development_stage": "Approved",
"first_approval": 1950,
"formula": "C9H8O4",
"inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
"max_phase": 4.0,
"molecular_weight": 180.16,
"molecule_type": "Small molecule",
"name": "ASPIRIN",
"properties": {
"alogp": 1.31,
"aromatic_rings": 1,
"drug_likeness": 0.55,
"formula": "C9H8O4",
"h_bond_acceptors": 3,
"h_bond_donors": 1,
"heavy_atoms": 13,
"molecular_weight": 180.16,
"natural_product_likeness": 0.12,
"parent_molecular_weight": 180.16,
"polar_surface_area": 63.6,
"rotatable_bonds": 2,
"rule_of_five_violations": 0
},
"smiles": "CC(=O)Oc1ccccc1C(=O)O",
"url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
}
],
"next_offset": null,
"summary": "1 molecule in those ranges.",
"total_count": 1
}Find molecules containing a structure
Find molecules that contain a given structure as part of theirs, such as every compound with a quinoline ring. Give the structure as SMILES (at least 5 characters), a ChEMBL ID or an InChIKey.
Inputs
- Structure
structuretextRequired - The structure to search with: a SMILES string, a ChEMBL ID or an InChIKey.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
moleculeslist- The molecules containing the structure
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"count": 1,
"molecules": [
{
"chembl_id": "CHEMBL25",
"development_stage": "Approved",
"first_approval": 1950,
"formula": "C9H8O4",
"inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
"max_phase": 4.0,
"molecular_weight": 180.16,
"molecule_type": "Small molecule",
"name": "ASPIRIN",
"smiles": "CC(=O)Oc1ccccc1C(=O)O",
"url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
}
],
"next_offset": null,
"summary": "1 molecule containing the structure.",
"total_count": 1
}Find similar molecules
Find molecules whose structure is like a given one, most similar first, with how alike each is in percent. Give the structure as SMILES, a ChEMBL ID or an InChIKey.
Inputs
- Structure
structuretextRequired - The structure to search with: a SMILES string, a ChEMBL ID or an InChIKey.
- Minimum similarity (%)
similaritynumber - How alike a structure must be to count, 40 to 100 percent. 100 finds the same structure (and its salts). Defaults to 70.From 40 to 100.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
moleculeslist- The similar molecules
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"count": 1,
"molecules": [
{
"chembl_id": "CHEMBL25",
"development_stage": "Approved",
"first_approval": 1950,
"formula": "C9H8O4",
"inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
"max_phase": 4.0,
"molecular_weight": 180.16,
"molecule_type": "Small molecule",
"name": "ASPIRIN",
"similarity": 100.0,
"smiles": "CC(=O)Oc1ccccc1C(=O)O",
"url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
}
],
"next_offset": null,
"summary": "1 molecule at least 70% similar.",
"total_count": 1
}Get assay
Get one assay: what it measured, its type, the organism, cell line or tissue it used, its target and how sure ChEMBL is of that target, its conditions and the paper it comes from.
Inputs
- Assay
assaytextRequired - The assay's ChEMBL ID, such as CHEMBL846547, from a bioactivity or 'Search assays'.
Outputs
assay_categorytext- Its category, such as screening or confirmatory
assay_typetext- B, F, A, T, P or U
assay_type_labeltext- Binding, Functional, ADME, Toxicity...
cell_chembl_idtext- The cell line's ChEMBL ID
cell_typetext- The cell type used
chembl_idtext- The record's ChEMBL ID, such as CHEMBL25
classificationslist- Its place in ChEMBL's assay classification
confidence_labeltext- The confidence score in words
confidence_scorenumber- How sure the target mapping is, 0 to 9 (9 is surest)
descriptiontext- What the assay measured, as reported
document_chembl_idtext- The paper or dataset it comes from
formattext- The assay format, such as single protein format
organismtext- The organism the assay used
parameterslist- The assay's conditions
relationship_labeltext- How the target relates to what was tested
straintext- The strain used
subcellular_fractiontext- The subcellular fraction used
summarytext- One line: type, organism and description
target_chembl_idtext- The target the assay is mapped to
tax_idnumber- That organism's NCBI taxonomy ID
test_typetext- In vitro, in vivo or ex vivo
tissuetext- The tissue used
tissue_chembl_idtext- The tissue's ChEMBL ID
urltext- The record's page on the ChEMBL website
Example output
{
"assay_category": null,
"assay_type": "B",
"assay_type_label": "Binding",
"cell_chembl_id": null,
"cell_type": null,
"chembl_id": "CHEMBL846547",
"classifications": [],
"confidence_label": "Homologous single protein target assigned",
"confidence_score": 8,
"description": "Inhibition of v-Abl tyrosine kinase.",
"document_chembl_id": "CHEMBL1130562",
"format": "single protein format",
"organism": null,
"parameters": [
{
"comments": null,
"relation": "=",
"text_value": null,
"type": "DOSE",
"units": "mg.kg-1",
"value": 30.0
}
],
"relationship_label": "Homologous protein target assigned",
"strain": null,
"subcellular_fraction": null,
"summary": "CHEMBL846547: binding assay. Inhibition of v-Abl tyrosine kinase.",
"target_chembl_id": "CHEMBL1862",
"tax_id": null,
"test_type": null,
"tissue": null,
"tissue_chembl_id": null,
"url": "https://www.ebi.ac.uk/chembl/explore/assay/CHEMBL846547"
}Get database status
Get the ChEMBL release being served, when it came out, and how many molecules, activities, targets and documents it holds. Run it on a schedule to notice a new release.
Inputs
None.
Outputs
activitiesnumber- Measured bioactivities
compound_recordsnumber- Compound records, counting every source
documentsnumber- Papers, patents and datasets
moleculesnumber- Distinct compounds in the release
release_datetext- When the release came out, as YYYY-MM-DD
release_numbernumber- The release's number, such as 37
statustext- UP when the service is running
summarytext- One line: release, date and size
targetsnumber- Targets
versiontext- The release being served, such as ChEMBL_37
Example output
{
"activities": 24527044,
"compound_records": 3824604,
"documents": 101100,
"molecules": 2921148,
"release_date": "2026-05-01",
"release_number": 37,
"status": "UP",
"summary": "ChEMBL 37, released 2026-05-01: 2,921,148 molecules, 24,527,044 activities.",
"targets": 18552,
"version": "ChEMBL_37"
}Get document
Get one paper, patent or dataset: title, authors, journal, year, DOI, PubMed ID and abstract, with links.
Inputs
- Document
documenttextRequired - The document's ChEMBL ID, such as CHEMBL1130562, from a bioactivity, an assay or 'Search documents'.
Outputs
abstracttext- The abstract
authorstext- The authors
chembl_idtext- The record's ChEMBL ID, such as CHEMBL25
doc_typetext- PUBLICATION, PATENT, DATASET or BOOK
doitext- The DOI
doi_urltext- A link to the DOI
first_pagetext- The first page
issuetext- The journal issue
journaltext- The journal's short name
journal_full_titletext- The journal's full name
last_pagetext- The last page
patent_idtext- The patent number, for a patent
pubmed_idnumber- The PubMed ID
pubmed_urltext- A link to the PubMed record
summarytext- One line: title, journal and year
titletext- The title
urltext- The record's page on the ChEMBL website
volumetext- The journal volume
yearnumber- The year it was published
Example output
{
"abstract": null,
"authors": "Zimmermann J, Buchdunger E, Mett H, Meyer T, Lydon NB",
"chembl_id": "CHEMBL1130562",
"doc_type": "PUBLICATION",
"doi": "10.1016/S0960-894X(96)00601-4",
"doi_url": "https://doi.org/10.1016/S0960-894X(96)00601-4",
"first_page": "187",
"issue": "2",
"journal": "Bioorg Med Chem Lett",
"journal_full_title": "Bioorganic & medicinal chemistry letters.",
"last_page": "192",
"patent_id": null,
"pubmed_id": null,
"pubmed_url": null,
"summary": "Potent and selective inhibitors of the Abl-kinase: phenylamino-pyrimidine (PAP) derivatives (CHEMBL1130562), Bioorg Med Chem Lett, 1997.",
"title": "Potent and selective inhibitors of the Abl-kinase: phenylamino-pyrimidine (PAP) derivatives",
"url": "https://www.ebi.ac.uk/chembl/explore/document/CHEMBL1130562",
"volume": "7",
"year": 1997
}Get molecule
Get everything ChEMBL holds on one molecule: its name and development stage, structure (SMILES, InChI, InChIKey), calculated properties such as molecular weight and ALogP, routes of administration, warnings, trade names, synonyms and ATC codes.
Inputs
- Molecule
moleculetextRequired - The molecule's ChEMBL ID (such as CHEMBL25) or standard InChIKey. 'Search molecules' finds the ID from a name.
Outputs
atc_codeslist- Its WHO ATC classification codes, such as N02BA01
black_box_warningtrue/false- Carries a black box warning on its label
chembl_idtext- The record's ChEMBL ID, such as CHEMBL25
chemical_probetrue/false- A recommended chemical probe for research
development_stagetext- The furthest stage in words: Approved, Phase 3, Phase 2, Phase 1, Early phase 1, Clinical, phase unknown, or Preclinical
first_approvalnumber- The year it was first approved, for a drug
first_in_classtrue/false- The first approved drug acting this way
max_phasenumber- The furthest stage reached: 4 approved, 3, 2 or 1 a clinical phase, 0.5 early phase 1, -1 clinical with the phase unknown; empty for preclinical
molecule_typetext- Small molecule, Protein, Antibody, Oligonucleotide...
nametext- ChEMBL's preferred name, such as ASPIRIN; empty for many compounds
natural_producttrue/false- A natural product or derived from one
oraltrue/false- Given by mouth, for an approved drug
orphantrue/false- Approved for a rare disease (orphan designation)
parent_chembl_idtext- The parent compound's ChEMBL ID; for a salt, the free base
parenteraltrue/false- Given by injection or infusion, for an approved drug
prodrugtrue/false- A prodrug, turned into the active compound in the body
propertiesobject- Properties ChEMBL calculates from the structure
research_codeslist- Development codes, such as STI-571
structureobject- The molecule's structure, in three standard notations
summarytext- One line: name, stage, type, approval year and formula
synonymslist- Every name ChEMBL knows it by
topicaltrue/false- Applied to the skin or another surface, for an approved drug
trade_nameslist- Brand names it is sold under
urltext- The record's page on the ChEMBL website
usan_stemtext- The USAN naming stem, such as -tinib
usan_stem_definitiontext- What the stem means, such as kinase inhibitors
withdrawntrue/false- Withdrawn from the market somewhere
Example output
{
"atc_codes": [
"B01AC06",
"N02BA01",
"N02BA51",
"A01AD05",
"N02BA71"
],
"black_box_warning": false,
"chembl_id": "CHEMBL25",
"chemical_probe": false,
"development_stage": "Approved",
"first_approval": 1950,
"first_in_class": false,
"max_phase": 4.0,
"molecule_type": "Small molecule",
"name": "ASPIRIN",
"natural_product": true,
"oral": true,
"orphan": false,
"parent_chembl_id": "CHEMBL25",
"parenteral": false,
"prodrug": false,
"properties": {
"alogp": 1.31,
"aromatic_rings": 1,
"drug_likeness": 0.55,
"formula": "C9H8O4",
"h_bond_acceptors": 3,
"h_bond_donors": 1,
"heavy_atoms": 13,
"molecular_weight": 180.16,
"natural_product_likeness": 0.12,
"parent_molecular_weight": 180.16,
"polar_surface_area": 63.6,
"rotatable_bonds": 2,
"rule_of_five_violations": 0
},
"research_codes": [
"BAY1019036",
"NSC-27223"
],
"structure": {
"inchi": "InChI=1S/C9H8O4/c1-6(10)13-8-5-3-2-4-7(8)9(11)12/h2-5H,1H3,(H,11,12)",
"inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
"smiles": "CC(=O)Oc1ccccc1C(=O)O"
},
"summary": "ASPIRIN (CHEMBL25): approved small molecule, first approved in 1950. C9H8O4, 180.16 g/mol.",
"synonyms": [
"Acetylsalicylic acid",
"Aspirin",
"BAY1019036",
"Durlaza",
"NSC-27223",
"Vazalore"
],
"topical": false,
"trade_names": [
"Aspirin",
"Durlaza",
"Vazalore"
],
"url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25",
"usan_stem": null,
"usan_stem_definition": null,
"withdrawn": false
}Get target
Get one target: its name, type, organism, and the proteins it is made of with their UniProt accessions and gene symbols.
Inputs
- Target
targettextRequired - The target's ChEMBL ID, such as CHEMBL203. 'Search targets' finds it from a name or gene.
Outputs
chembl_idtext- The record's ChEMBL ID, such as CHEMBL25
componentslist- The proteins (or other parts) it is made of
gene_symbolslist- The genes behind its proteins, such as EGFR
nametext- The target's name, such as Epidermal growth factor receptor
organismtext- The organism, such as Homo sapiens
species_grouptrue/false- True when the target groups the same protein across species
summarytext- One line: name, type, organism and gene
target_typetext- SINGLE PROTEIN, PROTEIN COMPLEX, ORGANISM, CELL-LINE...
tax_idnumber- The organism's NCBI taxonomy ID, such as 9606
uniprot_accessionslist- UniProt accessions of its proteins, such as P00533
urltext- The record's page on the ChEMBL website
Example output
{
"chembl_id": "CHEMBL203",
"components": [
{
"accession": "P00533",
"component_type": "PROTEIN",
"description": "Epidermal growth factor receptor",
"gene_symbols": [
"EGFR"
],
"relationship": "SINGLE PROTEIN"
}
],
"gene_symbols": [
"EGFR"
],
"name": "Epidermal growth factor receptor",
"organism": "Homo sapiens",
"species_group": false,
"summary": "Epidermal growth factor receptor (CHEMBL203): single protein in Homo sapiens, gene EGFR.",
"target_type": "SINGLE PROTEIN",
"tax_id": 9606,
"uniprot_accessions": [
"P00533"
],
"url": "https://www.ebi.ac.uk/chembl/explore/target/CHEMBL203"
}List approved drugs
List approved drugs, one per active ingredient, most recently approved first: name, year of first approval, the companies behind it, ATC classes, routes, and any black box warning or withdrawal. Narrow it to a span of years or a naming stem such as -tinib.
Inputs
- First approved in or after
approved_sincenumber - A year, such as 2020.From 1900 to 2100.
- First approved in or before
approved_untilnumber - A year, such as 2024.From 1900 to 2100.
- Name stem
usan_stemtext - Only drugs whose name has this USAN stem, which says what kind of drug it is: -tinib (kinase inhibitors), -mab (antibodies), -vir (antivirals).
- Order
ordertext - Defaults to the most recently approved first.One of:
newest(Most recently approved first),oldest(Earliest approved first). - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
drugslist- The approved drugs
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"count": 1,
"drugs": [
{
"applicants": [
"Novartis Pharmaceuticals Corp"
],
"atc_classes": [
{
"code": "L01EA01",
"description": "ANTINEOPLASTIC AND IMMUNOMODULATING AGENTS: ANTINEOPLASTIC AGENTS: PROTEIN KINASE INHIBITORS: BCR-ABL tyrosine kinase inhibitors"
}
],
"availability": "Prescription only",
"black_box_warning": false,
"chembl_id": "CHEMBL941",
"first_approval": 2001,
"first_in_class": true,
"formula": "C29H31N7O",
"molecular_weight": 493.62,
"name": "Imatinib",
"names": [
"Imatinib (INN)",
"Imatinib mesylate (EMA, FDA, USAN)"
],
"oral": true,
"parenteral": false,
"prodrug": false,
"research_codes": [
"STI-571"
],
"smiles": "Cc1ccc(NC(=O)c2ccc(CN3CCN(C)CC3)cc2)cc1Nc1nccc(-c2cccnc2)n1",
"topical": false,
"url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL941",
"usan_stem": "-tinib",
"usan_stem_definition": "tyrosine kinase inhibitors",
"withdrawn": false
}
],
"next_offset": null,
"summary": "1 approved drug.",
"total_count": 1
}List ATC classes
Look up the WHO Anatomical Therapeutic Chemical (ATC) classes that sort drugs by organ system and use: every substance under a code (N02BA, salicylates) or the classes of a substance by name, each with all five levels spelled out.
Inputs
- ATC code
codetext - A code or the start of one: N (nervous system), N02 (analgesics), N02BA (salicylates) or N02BA01 (aspirin).
- Substance name
drug_nametext - Only classes for substances whose WHO name contains this, such as imatinib.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
classeslist- The ATC classes
countnumber- How many are on this page
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"classes": [
{
"code": "N02BA01",
"level1": "N",
"level1_description": "NERVOUS SYSTEM",
"level2": "N02",
"level2_description": "ANALGESICS",
"level3": "N02B",
"level3_description": "OTHER ANALGESICS AND ANTIPYRETICS",
"level4": "N02BA",
"level4_description": "Salicylic acid and derivatives",
"name": "acetylsalicylic acid",
"path": "N NERVOUS SYSTEM > N02 ANALGESICS > N02B OTHER ANALGESICS AND ANTIPYRETICS > N02BA Salicylic acid and derivatives"
}
],
"count": 1,
"next_offset": null,
"summary": "1 ATC class.",
"total_count": 1
}List bioactivities
List measured results (IC50, Ki, EC50, % inhibition...) for a molecule, a target, an assay or a paper, with the value, units and pChEMBL potency of each. Narrow them by measurement type, assay type or minimum potency, and sort the most potent first.
Inputs
- Molecule
moleculetext - Only this molecule (and its salts and other forms), by ChEMBL ID such as CHEMBL941.
- Target
targettext - Only this target, by ChEMBL ID such as CHEMBL1862.
- Assay
assaytext - Only this assay, by ChEMBL ID such as CHEMBL846547.
- Document
documenttext - Only results from this paper or dataset, by ChEMBL ID.
- Measurement type
standard_typetext - Only this kind of measurement, such as IC50 or Ki.
- Assay type
assay_typetext - Only this kind of assay. Leave empty for every kind.One of:
B(Binding),F(Functional),A(ADME (absorption, distribution, metabolism, excretion)),T(Toxicity),P(Physicochemical),U(Unclassified). - Minimum pChEMBL
min_pchemblnumber - Only results at least this potent, as -log10 of the molar value: 6 is 1 uM, 9 is 1 nM.From 0 to 15.
- Most potent first
most_potent_firsttrue/false - Sort by potency, strongest first. Results without a pChEMBL value are left out.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
activitieslist- The measured results
countnumber- How many are on this page
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"activities": [
{
"activity_comment": null,
"activity_id": 909963,
"assay_chembl_id": "CHEMBL846547",
"assay_description": "Inhibition of v-Abl tyrosine kinase.",
"assay_type": "B",
"assay_type_label": "Binding",
"data_validity_comment": null,
"document_chembl_id": "CHEMBL1130562",
"document_journal": "Bioorg Med Chem Lett",
"document_year": 1997,
"measurement": "IC50 = 38 nM",
"molecule_chembl_id": "CHEMBL941",
"molecule_name": "IMATINIB",
"parent_molecule_chembl_id": "CHEMBL941",
"pchembl_value": 7.42,
"relation": "=",
"smiles": "Cc1ccc(NC(=O)c2ccc(CN3CCN(C)CC3)cc2)cc1Nc1nccc(-c2cccnc2)n1",
"standard_type": "IC50",
"target_chembl_id": "CHEMBL1862",
"target_name": "Tyrosine-protein kinase ABL1",
"target_organism": "Homo sapiens",
"units": "nM",
"value": 38.0
}
],
"count": 1,
"next_offset": null,
"summary": "1 activity.",
"total_count": 1
}List drug indications
List the diseases a drug is approved or in clinical trials for, or the drugs for a disease (such as asthma), with the furthest stage reached for each.
Inputs
- Molecule
moleculetext - Only this molecule (and its salts and other forms), by ChEMBL ID such as CHEMBL941.
- Disease
diseasetext - Only indications whose disease name contains this.
- Development stage
stagetext - Only indications that got this far. Leave empty for all.One of:
approved(Approved drugs only),phase_3(Phase 3 or later),phase_2(Phase 2 or later),phase_1(Phase 1 or later),clinical(Any clinical stage). - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
indicationslist- The indications
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"count": 1,
"indications": [
{
"development_stage": "Approved",
"disease": "chronic myelogenous leukemia",
"efo_id": "EFO:0000339",
"max_phase": 4.0,
"mesh_heading": "Leukemia, Myelogenous, Chronic, BCR-ABL Positive",
"mesh_id": "D015464",
"molecule_chembl_id": "CHEMBL1642",
"parent_molecule_chembl_id": "CHEMBL941",
"references": [
{
"reference": "setid=211ef2da-2868-4a77-8055-1cb2cd78e24b",
"source": "DailyMed",
"url": "https://dailymed.nlm.nih.gov/dailymed/drugInfo.cfm?setid=211ef2da-2868-4a77-8055-1cb2cd78e24b"
}
]
}
],
"next_offset": null,
"summary": "1 indication.",
"total_count": 1
}List drug warnings
List black box warnings and market withdrawals, for one drug or across all drugs: the kind of harm, the country, the year and the source.
Inputs
- Molecule
moleculetext - Only this molecule (and its salts and other forms), by ChEMBL ID such as CHEMBL941.
- Warning type
warning_typetext - Only this kind. Leave empty for both.One of:
Black Box Warning,Withdrawn(Withdrawn from the market). - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
warningslist- The warnings
Example output
{
"count": 1,
"next_offset": null,
"summary": "1 warning.",
"total_count": 1,
"warnings": [
{
"adverse_effect": null,
"country": "United States",
"description": null,
"molecule_chembl_id": "CHEMBL4303288",
"parent_molecule_chembl_id": "CHEMBL1380",
"references": [
{
"reference": "setid=211ef2da-2868-4a77-8055-1cb2cd78e24b",
"source": "DailyMed",
"url": "https://dailymed.nlm.nih.gov/dailymed/drugInfo.cfm?setid=211ef2da-2868-4a77-8055-1cb2cd78e24b"
}
],
"warning_class": "hepatotoxicity",
"warning_type": "Black Box Warning",
"year": null
}
]
}List mechanisms of action
List how drugs act on their targets, such as 'Tyrosine-protein kinase ABL inhibitor', for a drug or for a target, with the action type and sources.
Inputs
- Molecule
moleculetext - Only this molecule (and its salts and other forms), by ChEMBL ID such as CHEMBL941.
- Target
targettext - Only this target, by ChEMBL ID such as CHEMBL1862.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
mechanismslist- The mechanisms of action
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"count": 1,
"mechanisms": [
{
"action_type": "INHIBITOR",
"binding_site_comment": null,
"comment": null,
"development_stage": "Approved",
"direct_interaction": true,
"disease_efficacy": true,
"max_phase": 4.0,
"mechanism_of_action": "Tyrosine-protein kinase ABL inhibitor",
"molecule_chembl_id": "CHEMBL1642",
"parent_molecule_chembl_id": "CHEMBL941",
"references": [
{
"reference": "setid=211ef2da-2868-4a77-8055-1cb2cd78e24b",
"source": "DailyMed",
"url": "https://dailymed.nlm.nih.gov/dailymed/drugInfo.cfm?setid=211ef2da-2868-4a77-8055-1cb2cd78e24b"
}
],
"selectivity_comment": null,
"target_chembl_id": "CHEMBL1862"
}
],
"next_offset": null,
"summary": "1 mechanism.",
"total_count": 1
}Look up ChEMBL ID
Find out what a ChEMBL ID names (a compound, target, assay, document, cell line or tissue), whether it is still in use, and its page on the ChEMBL website. An unknown ID comes back with 'found' set to false rather than failing the step.
Inputs
- ChEMBL ID
chembl_idtextRequired - Any ChEMBL ID, such as CHEMBL25 or CHEMBL1862.
Outputs
chembl_idtext- The record's ChEMBL ID, such as CHEMBL25
entity_typetext- COMPOUND, TARGET, ASSAY, DOCUMENT, CELL or TISSUE
foundtrue/false- True when ChEMBL has a record with this ID
statustext- ACTIVE, INACTIVE or OBS (obsolete)
summarytext- One line saying what the ID names
urltext- The record's page on the ChEMBL website
Example output
{
"chembl_id": "CHEMBL25",
"entity_type": "COMPOUND",
"found": true,
"status": "ACTIVE",
"summary": "CHEMBL25 is a compound.",
"url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
}Search assays
Find assays (the experiments behind each measurement) by words in their description, such as 'hERG inhibition', optionally of one type: binding, functional, ADME, toxicity.
Inputs
- Search for
querytextRequired - Words from the assay's description.
- Assay type
assay_typetext - Only this kind of assay. Leave empty for every kind.One of:
B(Binding),F(Functional),A(ADME (absorption, distribution, metabolism, excretion)),T(Toxicity),P(Physicochemical),U(Unclassified). - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
assayslist- The assays that matched
countnumber- How many are on this page
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"assays": [
{
"assay_category": null,
"assay_type": "B",
"assay_type_label": "Binding",
"cell_chembl_id": null,
"cell_type": null,
"chembl_id": "CHEMBL846547",
"classifications": [],
"confidence_label": "Homologous single protein target assigned",
"confidence_score": 8,
"description": "Inhibition of v-Abl tyrosine kinase.",
"document_chembl_id": "CHEMBL1130562",
"format": "single protein format",
"organism": null,
"parameters": [
{
"comments": null,
"relation": "=",
"text_value": null,
"type": "DOSE",
"units": "mg.kg-1",
"value": 30.0
}
],
"relationship_label": "Homologous protein target assigned",
"score": 21.0,
"strain": null,
"subcellular_fraction": null,
"summary": "CHEMBL846547: binding assay. Inhibition of v-Abl tyrosine kinase.",
"target_chembl_id": "CHEMBL1862",
"tax_id": null,
"test_type": null,
"tissue": null,
"tissue_chembl_id": null,
"url": "https://www.ebi.ac.uk/chembl/explore/assay/CHEMBL846547"
}
],
"count": 1,
"next_offset": null,
"summary": "1 assay matching 'abl kinase'.",
"total_count": 1
}Search cell lines
Find the cell lines ChEMBL's assays use, by name (HeLa), tissue (lung) or organism, with their Cellosaurus and ontology IDs. Leave every field empty to list them all, by name.
Inputs
- Name
nametext - Only cell lines whose name contains this.
- Tissue
tissuetext - Only cell lines from a tissue whose name contains this.
- Organism
organismtext - Only cell lines from this organism, by Latin name.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
cell_lineslist- The cell lines that matched
countnumber- How many are on this page
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"cell_lines": [
{
"cellosaurus_id": "CVCL_0030",
"chembl_id": "CHEMBL3308376",
"clo_id": "CLO_0003684",
"description": "HeLa (Cervical adenocarcinoma cells)",
"efo_id": "EFO_0001185",
"name": "HeLa",
"organism": "Homo sapiens",
"tax_id": 9606,
"tissue": "Cervical adenocarcinoma",
"url": "https://www.ebi.ac.uk/chembl/explore/cell_line/CHEMBL3308376"
}
],
"count": 1,
"next_offset": null,
"summary": "1 cell line.",
"total_count": 1
}Search documents
Find the papers, patents and datasets ChEMBL's data come from by words in their title or abstract, optionally of one type or published since a year.
Inputs
- Search for
querytextRequired - Words from the title or abstract.
- Document type
doc_typetext - Only this kind of document. Leave empty for every kind.One of:
PUBLICATION(Journal article),PATENT,DATASET(Deposited dataset),BOOK. - Published in or after
published_sincenumber - A year, such as 2015.From 1900 to 2100.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
documentslist- The documents that matched
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"count": 1,
"documents": [
{
"abstract": null,
"authors": "Zimmermann J, Buchdunger E, Mett H, Meyer T, Lydon NB",
"chembl_id": "CHEMBL1130562",
"doc_type": "PUBLICATION",
"doi": "10.1016/S0960-894X(96)00601-4",
"doi_url": "https://doi.org/10.1016/S0960-894X(96)00601-4",
"first_page": "187",
"issue": "2",
"journal": "Bioorg Med Chem Lett",
"journal_full_title": "Bioorganic & medicinal chemistry letters.",
"last_page": "192",
"patent_id": null,
"pubmed_id": null,
"pubmed_url": null,
"score": 12.0,
"summary": "Potent and selective inhibitors of the Abl-kinase: phenylamino-pyrimidine (PAP) derivatives (CHEMBL1130562), Bioorg Med Chem Lett, 1997.",
"title": "Potent and selective inhibitors of the Abl-kinase: phenylamino-pyrimidine (PAP) derivatives",
"url": "https://www.ebi.ac.uk/chembl/explore/document/CHEMBL1130562",
"volume": "7",
"year": 1997
}
],
"next_offset": null,
"summary": "1 document matching 'abl kinase'.",
"total_count": 1
}Search molecules
Find molecules by name, trade name, synonym or research code (aspirin, Gleevec, STI-571), best match first, optionally only approved drugs or those that reached a clinical phase. Each result has its ChEMBL ID, stage, formula and structure.
Inputs
- Search for
querytextRequired - A name, trade name, synonym or research code, such as aspirin, Gleevec or STI-571.
- Development stage
stagetext - Only molecules that got this far. Leave empty for all.One of:
approved(Approved drugs only),phase_3(Phase 3 or later),phase_2(Phase 2 or later),phase_1(Phase 1 or later),clinical(Any clinical stage). - Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
moleculeslist- The molecules that matched
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
total_countnumber- How many match in all, across every page
Example output
{
"count": 1,
"molecules": [
{
"chembl_id": "CHEMBL25",
"development_stage": "Approved",
"first_approval": 1950,
"formula": "C9H8O4",
"inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
"max_phase": 4.0,
"molecular_weight": 180.16,
"molecule_type": "Small molecule",
"name": "ASPIRIN",
"score": 36.0,
"smiles": "CC(=O)Oc1ccccc1C(=O)O",
"url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
}
],
"next_offset": null,
"summary": "1 molecule matching 'aspirin'.",
"total_count": 1
}Search targets
Find drug targets (proteins, complexes, organisms, cell lines) by name, gene symbol or UniProt accession, best match first, optionally of one type or in one organism.
Inputs
- Search for
querytextRequired - A target name, gene symbol or UniProt accession, such as EGFR or P00533.
- Target type
target_typetext - Only this kind of target. Leave empty for every kind.One of:
SINGLE PROTEIN,PROTEIN COMPLEX,PROTEIN FAMILY,PROTEIN-PROTEIN INTERACTION,SELECTIVITY GROUP,NUCLEIC-ACID(Nucleic acid),ORGANISM,CELL-LINE(Cell line),TISSUE. - Organism
organismtext - Only targets in this organism, by Latin name.
- Page size
limitnumber - How many to return, 1 to 100. Defaults to 20.From 1 to 100.
- Offset
offsetnumber - How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0.At least 0.
Outputs
countnumber- How many are on this page
next_offsetnumber- Pass as 'Offset' to get the next page; empty on the last page
summarytext- One line saying how many matched and which are shown
targetslist- The targets that matched
total_countnumber- How many match in all, across every page
Example output
{
"count": 1,
"next_offset": null,
"summary": "1 target matching 'EGFR'.",
"targets": [
{
"chembl_id": "CHEMBL203",
"gene_symbols": [
"EGFR"
],
"name": "Epidermal growth factor receptor",
"organism": "Homo sapiens",
"score": 11.0,
"target_type": "SINGLE PROTEIN",
"tax_id": 9606,
"uniprot_accessions": [
"P00533"
],
"url": "https://www.ebi.ac.uk/chembl/explore/target/CHEMBL203"
}
],
"total_count": 1
}