JASPAR API
This API provides an easy-to-use REST web interface to query/retrieve matrix
profile data from the latest version of the JASPAR database. The API comes
with a human browsable interface and also a programmatic interface which
return the results in eight different formats, including json,
jsonp, jaspar, meme,
transfac, pfm, yaml and
bed.
collections
list
List all the collections available in JASPAR.
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
search | A search term. |
order | Which field to use when ordering the results. |
release | Access a specific release of JASPAR. Available releases are: 2020 and 2022. If blank, the query will provide data from the latest release. |
read
API endpoint that returns a list of all matrix profiles based on collection name.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
collection required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
search | A search term. |
order | Which field to use when ordering the results. |
version | If set to latest, return latest version |
release | Access a specific release of JASPAR. Available releases are: 2020 and 2022. If blank, the query will provide data from the latest release. |
dl
list
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
q | Free-text search across TF name, base ID, species, cell line and more. |
id_type | Type of deep learning entry to list: 'summary' (default) or 'model'. |
tax_group | Taxonomic group. For example: Vertebrates |
tax_id | Taxa ID. For example: 9606 for Human |
class | Transcription factor class. For example: Zipper-Type |
family | Transcription factor family. For example: SMAD factors |
type | Type of data/experiment. Only applies when id_type='model'. For example: ChIP-seq |
version | If set to 'latest' (default), return latest versions only. |
model > read
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
model_id required |
summary > read
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
profile_id required |
infer
read
Infer matrix profiles, given a protein sequence.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
sequence required |
live-api
matrix
list
REST API endpoint that returns a list of all matrix profiles.
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
search | A search term. |
order | Which field to use when ordering the results. |
collection | JASPAR Collection name. For example: CORE or CNE. |
name | Search by TF name (case-sensitive). For example: SMAD3 |
tax_group | Taxonomic group. For example: Vertebrates |
tax_id | Taxa ID. For example: 9606 for Human & 10090 for Mus musculus. Multiple IDs can be added separated by commas (e.g. tax_id=9606,10090). |
tf_class | Transcription factor class. For example: Zipper-Type |
tf_family | Transcription factor family. For example: SMAD factors |
data_type | Type of data/experiment. For example: ChIP-seq, PBM, SELEX etc. |
version | If set to latest, return latest version |
release | Access a specific release of JASPAR. Available releases are: 2020 and 2022. If blank, the query will provide data from the latest release. |
read
Gets profile detail information
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
matrix_id required |
versions > list
List matrix profile versions based on base_id
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
base_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
order | Which field to use when ordering the results. |
matrix-history
list
REST API endpoint that returns the matrix history of the JASPAR database.
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
order | Which field to use when ordering the results. |
name | Search by TF name (case-insensitive, exact match). For example: SMAD3 |
base_id | JASPAR matrix base identifier (case-insensitive, exact match). For example: MA0001 |
collection | JASPAR matrix collection (case-insensitive, exact match). For example: CORE |
release | JASPAR release year in which the profile appeared. For example: 2022 |
change_status | How the profile changed relative to the immediately preceding release: 'new', 'updated', 'unchanged', 'removed' or 'retired'. Combine with release= to answer 'what changed as of release X' directly. 'removed' and 'retired' rows are synthesized (a base_id present in the preceding release but absent from this one) and carry the last-known matrix_id/version/name/collection: 'removed' means the profile was individually curated out of a collection still offered today; 'retired' means its entire collection is no longer offered (e.g. CNE, FAM, PBM, PBM_HLH, PBM_HOMEO, PHYLOFACTS, POLII, SPLICE, all discontinued after the 2020 release). |
version | If set to latest, return latest version |
releases
list
REST API endpoint that returns all releases of JASPAR database.
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
order | Which field to use when ordering the results. |
read
Gets JASPAR release information based on release number
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
release_number required |
sites
read
List matrix profile sites based on matrix_id
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
matrix_id required |
species
list
API endpoint that returns a list of all species.
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
search | A search term. |
order | Which field to use when ordering the results. |
release | Access a specific release of JASPAR. Available releases are: 2020 and 2022. If blank, the query will provide data from the latest release. |
read
API endpoint that returns a list of all matrix profiles based on species.
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
tax_id required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
search | A search term. |
order | Which field to use when ordering the results. |
version | If set to latest, return latest version |
release | Access a specific release of JASPAR. Available releases are: 2020 and 2022. If blank, the query will provide data from the latest release. |
taxon
list
List all the taxonomic groups that are available in JASPAR.
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
release | Access a specific release of JASPAR. Available releases are: 2020 and 2022. If blank, the query will provide data from the latest release. |
read
API endpoint that returns a list of all matrix profiles based on taxonomic group.
Available taxonomic groups are: vertebrates, plants, insects, nematodes, fungi, urochordates
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
tax_group required |
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
search | A search term. |
order | Which field to use when ordering the results. |
version | If set to latest, return latest version |
release | Access a specific release of JASPAR. Available releases are: 2020 and 2022. If blank, the query will provide data from the latest release. |
tffm
list
REST API endpoint that returns a list of all TFFM profiles.
Query Parameters
The following parameters should be included as part of a URL query string.
| Parameter | Description |
|---|---|
page | A page number within the paginated result set. |
page_size | Number of results to return per page. |
search | A search term. |
order | Which field to use when ordering the results. |
tax_group | Taxonomic group. For example: Vertebrates or Plants |
release | Access a specific release of JASPAR. Available releases are: 2020 and 2022. If blank, the query will provide data from the latest release. |
read
Gets TFFM detail information
Path Parameters
The following parameters should be included in the URL path.
| Parameter | Description |
|---|---|
tffm_id required |