MASTERMIND API

All of the Power of the Mastermind Genomic Search Engine - Automated.

Try It

The Mastermind API

Mastermind offers a Base API and Advanced API for integrating insight from the genomic medical literature into your platform or automated genomic analysis pipeline.

View the full API documentation here

API Demo

Try the interactive demo below, powered by the Mastermind API.

Log in to try the interactive API demo below.

Suggestions Endpoint Base API

Returns the canonical name(s) to query in Mastermind for the given disease, gene, or variant.

See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.

Log in to get your API token.
Try this: Proto-Oncogene B-Raf
Try this: braf:c.1799T>A
Try this: malignant melanoma
Try this: Increased inflammatory response
Try this: Vemurafenib

API Results

Submit API URL query to see results.

Request

API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
Counts Endpoint Base API
Returns the number of articles that match the given query.
See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.
Log in to get your API token.
and
Try this: braf
 Add another gene
and
Try this: braf:V600E
 Add another variant
and
Try this: del chr11:110,600,000-121,300,000
 Add another cnv
and
Try this: melanoma
 Add another disease
and
Try this: HP:0012649
 Add another hpo_id
and
Try this: UNII:207SMY3FQT
 Add another unii_id
and
Try this: functional-sub
 Add another category
Try this: basket
Try this: 1672099200
Try this: abstract
Try this: 2
API Results
Submit API URL query to see results.
Request
API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
Articles Endpoint Advanced API
Returns the list of articles, ranked by relevance, for the given query.
See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.
Log in to get your API token.
and
Try this: braf
 Add another gene
and
Try this: braf:V600E
 Add another variant
and
Try this: del chr11:110,600,000-121,300,000
 Add another cnv
and
Try this: melanoma
 Add another disease
and
Try this: HP:0012649
 Add another hpo_id
and
Try this: UNII:207SMY3FQT
 Add another unii_id
and
Try this: functional-sub
 Add another category
Try this: basket
Try this: 1672099200
Try this: abstract
Try this: 2
API Results
Submit API URL query to see results.
Request
API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
Diseases Endpoint Advanced API
Returns the top 5 diseases, ranked by number of matched articles, for the given query.
See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.
Log in to get your API token.
and
Try this: braf
 Add another gene
and
Try this: braf:V600E
 Add another variant
and
Try this: del chr11:110,600,000-121,300,000
 Add another cnv
and
Try this: melanoma
 Add another disease
and
Try this: HP:0012649
 Add another hpo_id
and
Try this: UNII:207SMY3FQT
 Add another unii_id
and
Try this: functional-sub
 Add another category
Try this: basket
Try this: 1672099200
Try this: abstract
Try this: 2
API Results
Submit API URL query to see results.
Request
API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
Phenotypes Endpoint Advanced API
This endpoint is in beta and may change before it's finalized.
Returns the top 5 phenotypes, ranked by number of matched articles, for the given query.
See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.
Log in to get your API token.
and
Try this: braf
 Add another gene
and
Try this: braf:V600E
 Add another variant
and
Try this: del chr11:110,600,000-121,300,000
 Add another cnv
and
Try this: melanoma
 Add another disease
and
Try this: HP:0012649
 Add another hpo_id
and
Try this: UNII:207SMY3FQT
 Add another unii_id
and
Try this: functional-sub
 Add another category
Try this: basket
Try this: 1672099200
Try this: abstract
Try this: 2
API Results
Submit API URL query to see results.
Request
API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
Therapies Endpoint Advanced API
This endpoint is in beta and may change before it's finalized.
Returns the top 5 therapies, ranked by number of matched articles, for the given query.
See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.
Log in to get your API token.
and
Try this: braf
 Add another gene
and
Try this: braf:V600E
 Add another variant
and
Try this: del chr11:110,600,000-121,300,000
 Add another cnv
and
Try this: melanoma
 Add another disease
and
Try this: HP:0012649
 Add another hpo_id
and
Try this: UNII:207SMY3FQT
 Add another unii_id
and
Try this: functional-sub
 Add another category
Try this: basket
Try this: 1672099200
Try this: abstract
Try this: 2
API Results
Submit API URL query to see results.
Request
API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
Genes Endpoint Advanced API
Returns the top 5 genes, ranked by number of matched articles, for the given query.
See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.
Log in to get your API token.
and
Try this: braf
 Add another gene
and
Try this: braf:V600E
 Add another variant
and
Try this: del chr11:110,600,000-121,300,000
 Add another cnv
and
Try this: melanoma
 Add another disease
and
Try this: HP:0012649
 Add another hpo_id
and
Try this: UNII:207SMY3FQT
 Add another unii_id
and
Try this: functional-sub
 Add another category
Try this: basket
Try this: 1672099200
Try this: abstract
Try this: 2
API Results
Submit API URL query to see results.
Request
API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
Variants Endpoint Advanced API
Returns the top 5 variants, ranked by number of matched articles, for the given query.
See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.
Log in to get your API token.
and
Try this: braf
 Add another gene
and
Try this: braf:V600E
 Add another variant
and
Try this: del chr11:110,600,000-121,300,000
 Add another cnv
and
Try this: melanoma
 Add another disease
and
Try this: HP:0012649
 Add another hpo_id
and
Try this: UNII:207SMY3FQT
 Add another unii_id
and
Try this: functional-sub
 Add another category
Try this: basket
Try this: 1672099200
Try this: abstract
Try this: 2
API Results
Submit API URL query to see results.
Request
API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
CNVs Endpoint Advanced API
Returns the top 5 CNVs, ranked by number of matched articles, for the given query.
See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.
Log in to get your API token.
and
Try this: braf
 Add another gene
and
Try this: braf:V600E
 Add another variant
and
Try this: del chr11:110,600,000-121,300,000
 Add another cnv
and
Try this: melanoma
 Add another disease
and
Try this: HP:0012649
 Add another hpo_id
and
Try this: UNII:207SMY3FQT
 Add another unii_id
and
Try this: functional-sub
 Add another category
Try this: basket
Try this: 1672099200
Try this: abstract
Try this: 2
API Results
Submit API URL query to see results.
Request
API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
Article Info Endpoint Advanced API
Returns the matched diseases, genes, variants, and article meta-data for the given article PMID.
See the full API documentation linked above for details and information about each of the input filters below, including acceptable values, formatting, etc.
Log in to get your API token.
Try this PMID, for example: 23543365
API Results
Submit API URL query to see results.
Request
API URL:
Example usage:
Response
Status code:
Body:
Submit API query above to see results.
"File Annotation Counts" Endpoint Advanced API
Returns an annotated VCF from an input VCF file containing multiple variants as genomic coordinates with each variant in the output file annotated with the number of articles and Mastermind URL for each variant.
Easily integrate evidence from Mastermind into your existing genomics pipeline. Use the API to upload a VCF file, and get automatic annotations from Mastermind.
Mastermind VCF Annotations add annotations to variants containing the nubmer of publications which cite evidence for the variant, along with a URL to investigate the evidence.
Two annotations are added to each variant within the VCF file which contains evidence found by Mastermind in the medical literature:
  1. MMCNT: The number of articles found for this variant.
  2. MMURI: The Mastermind URL to view and investigate the matched articles.
Contact us to try it
View the full API documentation here