miRmap web REST API
With the miRmap web REST API, you can:
- Choose the source of predictions (species and miRmap run),
- Download pre-computed miRmap predictions,
- Predict miRNA targets with miRmap on your own sequences.
Listing miRmap prediction sets
Query
Query | URL | Parameter | Required | Description |
---|---|---|---|---|
GET | /remote/run | query | No | Search-key for run names. |
Result is returned as a JSON string with the following format:
{"items": [{"id": int, "description": string, "url_gene": string, "name": string}, ... ], "totalCount": int}
Examples
wget https://mirmap.ezlab.org/remote/run
wget https://mirmap.ezlab.org/remote/run?query=human
Querying miRmap prediction sets
Queries
The main query (below) requires a gene and/or a miRNA ID that can be obtained with the following queries.
Query | URL | Parameter | Required | Description |
---|---|---|---|---|
GET | /remote/mirna | run | Yes | miRmap run ID (see above). |
query | No | Search-key for miRNAs. |
Result is returned as a JSON string with the following format:
{"items": [{"id": int, "name": string}, ... ], "totalCount": int}
Query | URL | Parameter | Required | Description |
---|---|---|---|---|
GET | /remote/gene | run | Yes | miRmap run ID (see above). |
query | No | Search-key for genes. |
Result is returned as a JSON string with the following format:
{"items": [{"id": int, "name": string, "names": [string], "description": string}, ... ], "totalCount": int}
The main query.
Query | URL | Parameter | Required | Description |
---|---|---|---|---|
POST | /remote/db | json_request | yes | JSON-formatted query.{"queries":[{"run":<id>, "mirna":<id|null>, "gene":<id|null>}, ...], "valuesFormat":"<percentile|raw>", "valuesLevel":"<pair|site>", "withSequence":<true|false>, "format":"<json|csv>"}With the percentile option, the raw values are scaled from 0 to 100. With the pair option, one prediction per (miRNA,mRNA) pair is returned. All target sites are returned with site option. |
Result is returned as a JSON or CSV string. Column order for CSV is the same as JSON format.
{"items": [[run_id, mirna_id, mirna_mature_name, mirna_seq, transcript_id, transcript_stable_id, transcript_canonical, utr3_seq, transcript_chr, transcript_strand, gene_stable_id, name, site_end, site_chr_end, seed_length, tgs_au, tgs_position, tgs_pairing3p, dg_duplex, dg_binding, dg_duplex_seed, dg_binding_seed, dg_open, dg_total, prob_exact, prob_binomial, cons_bls, selec_phylop, mirmap_score],
... ],
"totalCount": int}
Examples
wget "https://mirmap.ezlab.org/remote/mirna?run=1&query=let-7e-3p"
wget "https://mirmap.ezlab.org/remote/gene?run=1&query=NUP37"
wget --post-data='json_request={"queries":[{"run":1,"mirna":11028,"gene":11965}],"valuesFormat":"percentile","withSequence":false,"format":"csv"}' https://mirmap.ezlab.org/remote/db
wget --post-data='json_request={"queries":[{"run":1,"mirna":11028,"gene":null}],"valuesFormat":"percentile","withSequence":false}' https://mirmap.ezlab.org/remote/db
Predicting miRNA targets with miRmap
Description
To predict the targets on a gene or a miRNA from the database (not your own), use the corresponding id, as shown in the previous section.
Query | URL | Parameter | Required | Description |
---|---|---|---|---|
POST | /remote/mirmap | json_request | yes | JSON-formatted query.{"queries":[{"run":<id>, "mirna":<id>, "gene":<id>, "mirna_seq":<sequence>, "gene_seq":<sequence>}, ...], "valuesFormat":"<percentile|raw>", "valuesLevel":"<pair|site>", "format":"<json|csv>"}A single parameter in each pair (mirna,mirna_seq) and (gene,gene_seq) is required. |
Result has the same format as database interrogation (/remote/db); please see above.
Examples
wget --post-data='json_request={"queries":[{"run":1,"mirna_seq":"CUAUACGGCCUCCUAGCUUUCC","gene":11965}],"valuesFormat":"percentile","withSequence":false}' https://mirmap.ezlab.org/remote/mirmap