/query/searchByDiseaseName

  • Description

    Retrieve disease(s) for a given source and snapshot by exact name or not.

  • URL (PATH)

    /query/searchByDiseaseName?source=:source&version=:version&diseaseName=:diseaseName&matchExactName=:matchExactName&token=:token

  • Method

    GET

  • Auth required

    Optional (token)

  • Request parameters
    Parameter Description
    source *required
    [alphanumeric]
    example: source=wikipedia
    Name of the ifonrmation source
    version *required
    [alphanumeric with format “aaaa-mm-dd”]
    example: version=2018-09-15
    Date of the information source extraction, in “yyyy-mm-dd” format
    diseaseName
    [alphanumeric]
    example: diseaseName=Cancer
    Name of the disease
    matchExactName
    [boolean] by default always is false
    example: matchExactName=true
    If it is <b>true</b> it allows to consult by the exact name of disease, if it is <b>false</b> it recovers the diseases in whose name the value specified in the parameter diseaseName is found
    token
    [alphanumeric]
    example: token=eyJhbGciOiJI...
    Optional access key to save the current query inside the user's profile
  • Example request
                                         GET http://disnet.ctb.upm.es/api/disnet/query/searchByDiseaseName?source=pubmed&version=2018-04-03&diseaseName=Influenza&matchExactName=true&token=
                                    
  • Success response (application/json)
                                        {
        "token": "null", 
        "authorized": false, 
        "authorizationMessage": "null", 
        "responseCode": "200",
        "responseMessage": "OK",
        "errorsFound": [],
        "diseaseCount": 1,
        "diseaseList": [
            {
                "diseaseId": "DIS006504",
                "name": "Influenza",
                "urlsCount": 100,
                "urls": [
                    "https://www.ncbi.nlm.nih.gov/pubmed/28220658",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28605429",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28648674",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28799220",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28799670",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28825515",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28844381",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28855230",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28870104",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28880061",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28887040",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28902408",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28917132",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28930520",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28956760",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28958678",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28968871",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28978710",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28981699",
                    "https://www.ncbi.nlm.nih.gov/pubmed/28986441",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29016311",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29016325",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29032772",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29046448",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29051331",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29065022",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29075888",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29077596",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29079697",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29079954",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29081496",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29086107",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29088573",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29097380",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29107987",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29109069",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29112968",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29113630",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29117874",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29121624",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29126397",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29129247",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29130266",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29140945",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29141334",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29144466",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29145389",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29145441",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29145498",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29146628",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29149183",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29155812",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29157706",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29162037",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29166867",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29166978",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29168676",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29173310",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29176767",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29178863",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29180488",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29185857",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29190684",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29202715",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29212467",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29216030",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29216845",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29220381",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29220709",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29244811",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29244814",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29246199",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29250946",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29252990",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29262784",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29283997",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29288876",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29294594",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29297852",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29298153",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29315320",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29322273",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29324781",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29351330",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29352897",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29365305",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29388195",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29388196",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29388197",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29388675",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29407029",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29407031",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29447141",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29447145",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29458688",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29466160",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29555588",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29569429",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29569430",
                    "https://www.ncbi.nlm.nih.gov/pubmed/29590549"
                ],
                "codesCount": 9,
                "codes": [
                    {
                        "code": "155559006",
                        "typeCode": "SNOMED_CT"
                    },
                    {
                        "code": "155562009",
                        "typeCode": "SNOMED_CT"
                    },
                    {
                        "code": "195931008",
                        "typeCode": "SNOMED_CT"
                    },
                    {
                        "code": "266353003",
                        "typeCode": "SNOMED_CT"
                    },
                    {
                        "code": "266393000",
                        "typeCode": "SNOMED_CT"
                    },
                    {
                        "code": "6142004",
                        "typeCode": "SNOMED_CT"
                    },
                    {
                        "code": "C0021400",
                        "typeCode": "UMLS"
                    },
                    {
                        "code": "D007251",
                        "typeCode": "MeSH"
                    },
                    {
                        "code": "J11.1",
                        "typeCode": "ICD-10"
                    }
                ],
                "disnetConceptsCount": 33
            }
        ]
    }
                                    
  • Error response (application/json)

    Common errors

    Source error

    Version error

    Disease name error