MASTERMIND API

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

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.

Log in to get your API token.
Try this disease, for example: myeloid leukemia
Try this hpo, for example: arachnodactyly
Try this gene, for example: Proto-Oncogene B-Raf
Try this variant, for example: braf:c.1799T>A

API Results

Submt 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.

Additional search parameters available for this endpoint include, categories, scope, and since. See the full API documentation for details.

Log in to get your API token.
Try this disease, for example: melanoma
Try this hpo_id, for example: HP:0001166
Try this gene, for example: braf
Try this variant, for example: braf:V600E
Try this page, for example: 2

API Results

Submt 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.

Additional search parameters available for this endpoint include, categories, scope, and since. See the full API documentation for details.

Log in to get your API token.
Try this disease, for example: melanoma
Try this hpo_id, for example: HP:0001166
Try this gene, for example: braf
Try this variant, for example: braf:V600E
Try this page, for example: 2

API Results

Submt 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.

Additional search parameters available for this endpoint include, categories, scope, and since. See the full API documentation for details.

Log in to get your API token.
Try this disease, for example: melanoma
Try this hpo_id, for example: HP:0001166
Try this gene, for example: braf
Try this variant, for example: braf:V600E
Try this page, for example: 2

API Results

Submt 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.

Additional search parameters available for this endpoint include, categories, scope, and since. See the full API documentation for details.

Log in to get your API token.
Try this disease, for example: melanoma
Try this hpo_id, for example: HP:0001166
Try this gene, for example: braf
Try this variant, for example: braf:V600E
Try this page, for example: 2

API Results

Submt 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.

Additional search parameters available for this endpoint include, categories, scope, and since. See the full API documentation for details.

Log in to get your API token.
Try this disease, for example: melanoma
Try this hpo_id, for example: HP:0001166
Try this gene, for example: braf
Try this variant, for example: braf:V600E
Try this page, for example: 2

API Results

Submt 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.

Log in to get your API token.
Try this PMID, for example: 23543365

API Results

Submt 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