API usage

We also provide restful API for programing languages, such as Python, Java and so on. Or command line tools such as curl.

All APIs support the following parameters:

• length: return how many results
• start: he query start from, e.g. A total of 100 data, start=10&length=10, it will return the 10~20 data

1、Inquire Enhancer

The endpoint is /api/enhancer
The following parameters are:

• tissue: A549.
• eid: e.g. enh7.
• spe: e.g. 5, select the enhancers that appear in more than how many tissues/cell lines.
• eq: e.g. 5, select the enhancers that appear in exact how many tissues/cell lines

For example: curl "http://lcbb.swjtu.edu.cn/EnhancerDB/api/enhancer?tissue=A549"

{
  "data": [
        {
      "Score": 74.43,
      "chrom": "chr10",
      "eid": "enh6696",
      "end": 38875752,
      "id": 251341,
      "number": [
        {
          "label": "Lung (A549)",
          "url": "/ErreDB/enhancer/details?tissue=A549&eid=251341"
        }
      ],
      "start": 38871708
    },
    ......
    {
      "Score": 74.27,
      "chrom": "chrY",
      "eid": "enh68532",
      "end": 13690602,
      "id": 479940,
      "number": [
        {
          "label": "Lung (A549)",
          "url": "/ErreDB/enhancer/details?tissue=A549&eid=479940"
        }
      ],
      "start": 13686546
    }

  ],
  "draw": 1,
  "length": 10,
  "recordsFiltered": 93418,
  "recordsTotal": 93418,
  "start": 0
}

2、Inquire TFBS

The endpoint is /api/tfbs
The following parameters are:

• tf: eg: ATF1.

For example: curl "http://lcbb.swjtu.edu.cn/EnhancerDB/api/tfbs?tf=ATF1"

{
  "data": [
    {
      "chrom": "chr1",
      "end": 714185,
      "id": 293,
      "predict": false,
      "software": "UCSC Txn Factor",
      "start": 713973,
      "target": "ATF1",
      "tissue": "Conserved"
    },
    ......
    {
      "chrom": "chr1",
      "end": 936387,
      "id": 379,
      "predict": false,
      "software": "UCSC Txn Factor",
      "start": 936174,
      "target": "ATF1",
      "tissue": "Conserved"
    },
  ],
  "draw": 1,
  "length": 10,
  "recordsFiltered": 48717,
  "recordsTotal": 48717,
  "start": 0
}

3. Inquire by specific label

The endpoint is /api/label
The following parameters are:

• type:
  • enhancer
  • tf
  • gene
  • mirna
  • snp
• label:
  • for enhancer: enhancer id, e.g. enh7
  • for tf: tf name, e.g. ATF1
  • for gene: gene name or Ensembl ID, e.g. TP53
  • for mirna: mirna name or miRBase ID, e.g. hsa-miR-181a-3p
  • for snp: dbSNP ID, e.g. rs79227320

For example: curl "http://lcbb.swjtu.edu.cn/EnhancerDB/api/label?label=TP53&type=gene"

{
  "data": [
    {
      "Ensembl": "ENSG00000141510.11",
      "cancer": 1.0,
      "chrom": "chr17",
      "end": 7590856,
      "gene_name": "TP53",
      "id": 44934,
      "normal": 0.74,
      "start": 7565097,
      "strand": "-",
      "tss": 7590856
    }
  ],
  "draw": 1,
  "length": 10,
  "recordsFiltered": 1,
  "recordsTotal": 1,
  "start": 0
}

4. Inquire by specific genomic region

The endpoint is /api/position
The following parameters are:

• type:
  • enhancer
  • tf
  • gene
  • mirna
  • snp
• position: e.g. chr1:100-100000

For example: curl "http://lcbb.swjtu.edu.cn/EnhancerDB/api/position?type=mirna&position=chr1%3A100-10000000"

{
  "data": [
    {
      "Name": "hsa-miR-200a-3p",
      "TSS": 1103243,
      "cancer": 0.0,
      "chrom": "chr1",
      "end": 1103317,
      "id": 13,
      "mirBase": "MIMAT0000682",
      "normal": 0.914768,
      "start": 1103296,
      "strand": "+"
    },
    {
      "Name": "hsa-miR-200b-3p",
      "TSS": 1102484,
      "cancer": 0.0,
      "chrom": "chr1",
      "end": 1102561,
      "id": 10,
      "mirBase": "MIMAT0000318",
      "normal": 0.908635,
      "start": 1102540,
      "strand": "+"
    },
    {
      "Name": "hsa-miR-34a-3p",
      "TSS": 9211836,
      "cancer": 0.719127,
      "chrom": "chr1",
      "end": 9211773,
      "id": 40,
      "mirBase": "MIMAT0004557",
      "normal": 0.796865,
      "start": 9211752,
      "strand": "-"
    }
  ],
  "draw": 1,
  "length": 10,
  "recordsFiltered": 3,
  "recordsTotal": 3,
  "start": 0
}