{"openapi":"3.1.0","info":{"title":"MeSH API","version":"1.0.0","description":"Medical Subject Headings (MeSH) as an API, powered by the U.S. National Library of Medicine's official MeSH RDF service. MeSH is the NLM's authoritative controlled vocabulary used to index the biomedical literature in PubMed — a curated thesaurus of diseases, anatomy, chemicals and drugs, organisms, psychiatry and psychology, analytical and diagnostic techniques, health care and more. Each concept is a \"descriptor\" with a stable unique id (e.g. D003920), a preferred name, a set of entry terms (synonyms and lay variants), and a list of allowable qualifiers (subheadings such as drug therapy, diagnosis or epidemiology). /v1/search?q=diabetes searches descriptors by their preferred name (match=contains, exact or startswith) and returns each descriptor's id and label. /v1/term?q=heart attack resolves a lay term or synonym to the MeSH descriptor(s) it belongs to, so colloquial language maps onto the controlled vocabulary (heart attack to Myocardial Infarction). /v1/descriptor?id=D003920 returns a descriptor's full record — its preferred name, all entry terms (synonyms), the allowable qualifiers and see-also cross-references, with a link to the MeSH browser. Ideal for biomedical natural-language processing and text mining, tagging and indexing literature, building clinical and research search tools, autocomplete over medical terminology, and mapping free text onto a standard ontology. Data from NLM MeSH (public domain). For drug-specific clinical nomenclature and interactions, see the RxNorm API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/mesh-api","description":"oanor gateway"}],"tags":[{"name":"Vocabulary"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/descriptor":{"get":{"operationId":"get_v1_descriptor","tags":["Vocabulary"],"summary":"A descriptor full record","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"MeSH descriptor id, e.g. D003920","schema":{"type":"string"},"example":"D003920"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"descriptor":{"id":"D003920","url":"https://meshb.nlm.nih.gov/record/ui?ui=D003920","name":"Diabetes Mellitus","terms":["Diabetes Mellitus"],"see_also":[{"id":"D003919","label":"Diabetes Insipidus"},{"id":"D003927","label":"Diet, Diabetic"},{"id":"D018589","label":"Gastroparesis"},{"id":"D018149","label":"Glucose Intolerance"},{"id":"D017127","label":"Glycation End Products, Advanced"},{"id":"D011236","label":"Prediabetic State"},{"id":"D012592","label":"Scleredema Adultorum"}],"qualifiers":[{"id":"Q000097","label":"blood"},{"id":"Q000134","label":"cerebrospinal fluid"},{"id":"Q000139","label":"chemically induced"},{"id":"Q000145","label":"classification"},{"id":"Q000151","label":"congenital"},{"id":"Q000175","label":"diagnosis"},{"id":"Q000000981","label":"diagnostic imaging"},{"id":"Q000178","label":"diet therapy"},{"id":"Q000188","label":"drug therapy"},{"id":"Q000191","label":"economics"},{"id":"Q000196","label":"embryology"},{"id":"Q000201","label":"enzymology"},{"id":"Q000453","label":"epidemiology"},{"id":"Q000208","label":"ethnology"},{"id":"Q000209","label":"etiology"},{"id":"Q000235","label":"genetics"},{"id":"Q000266","label":"history"},{"id":"Q000276","label":"immunology"},{"id":"Q000378","label":"metabolism"},{"id":"Q000382","label":"microbiology"},{"id":"Q000401","label":"mortality"},{"id":"Q000451","label":"nursing"},{"id":"Q000469","label":"parasitology"},{"id":"Q000473","label":"pathology"},{"id":"Q000503","label":"physiopathology"},{"id":"Q000517","label":"prevention & control"},{"id":"Q000523","label":"psychology"},{"id":"Q000532","label":"radiotherapy"},{"id":"Q000534","label":"rehabilitation"},{"id":"Q000601","label":"surgery"},{"id":"Q000628","label":"therapy"},{"id":"Q000652","label":"urine"},{"id":"Q000662","label":"veterinary"},{"id":"Q000821","label":"virology"}]}},"meta":{"timestamp":"2026-06-01T16:23:44.250Z","request_id":"d7aaf107-6cb8-433b-8c8d-2bbdf2b2548a"},"status":"ok","message":"Descriptor retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Vocabulary"],"summary":"Search MeSH descriptors by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search text, e.g. diabetes","schema":{"type":"string"},"example":"diabetes"},{"name":"match","in":"query","required":false,"description":"exact, contains or startswith","schema":{"type":"string"},"example":"contains"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":12,"match":"contains","query":"diabetes","descriptors":[{"id":"D048909","label":"Diabetes Complications"},{"id":"D003919","label":"Diabetes Insipidus"},{"id":"D018500","label":"Diabetes Insipidus, Nephrogenic"},{"id":"D020790","label":"Diabetes Insipidus, Neurogenic"},{"id":"D003920","label":"Diabetes Mellitus"},{"id":"D003921","label":"Diabetes Mellitus, Experimental"},{"id":"D003923","label":"Diabetes Mellitus, Lipoatrophic"},{"id":"D003922","label":"Diabetes Mellitus, Type 1"},{"id":"D003924","label":"Diabetes Mellitus, Type 2"},{"id":"D016640","label":"Diabetes, Gestational"},{"id":"D000071698","label":"Latent Autoimmune Diabetes in Adults"},{"id":"D054586","label":"National Institute of Diabetes and Digestive and Kidney Diseases (U.S.)"}]},"meta":{"timestamp":"2026-06-01T16:23:44.459Z","request_id":"986d0b8a-1471-4345-aa9e-809e210f437f"},"status":"ok","message":"Descriptors retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/term":{"get":{"operationId":"get_v1_term","tags":["Vocabulary"],"summary":"Resolve a synonym to descriptor(s)","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Term/synonym, e.g. heart attack","schema":{"type":"string"},"example":"heart attack"},{"name":"match","in":"query","required":false,"description":"exact, contains or startswith","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"match":"contains","query":"heart attack","terms":[{"term":"Heart Attack","resource":"T000866941"}]},"meta":{"timestamp":"2026-06-01T16:23:44.643Z","request_id":"5caca00f-a43d-4c1b-a782-fb6dfc1e788c"},"status":"ok","message":"Terms retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"MeSH (Medical Subject Headings) is the U.S. National Library of Medicine's authoritative controlled vocabulary used to index biomedical literature in PubMed — covering diseases, anatomy, chemicals & drugs, organisms, psychology, techniques and more. /v1/search?q=diabetes = search MeSH descriptors by preferred name (match=contains|exact|startswith), returning each descriptor's stable id (e.g. D003920) and label; /v1/term?q=heart attack = resolve a lay term or synonym to the MeSH descriptor(s) it maps to (so 'heart attack' → Myocardial Infarction); /v1/descriptor?id=D003920 = a descriptor's full record — its preferred name, all entry terms (synonyms), the allowable qualifiers/subheadings (e.g. drug therapy, diagnosis, epidemiology) and see-also references, plus a link to the MeSH browser. Ideal for biomedical NLP and text mining, literature tagging and search, clinical and research tooling, and ontology mapping. Data from NLM MeSH (public domain). For drug-specific nomenclature see the RxNorm API.","source":"MeSH — Medical Subject Headings, U.S. National Library of Medicine (id.nlm.nih.gov/mesh)","endpoints":["/v1/search","/v1/term","/v1/descriptor","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:44.727Z","request_id":"271a84c1-19e3-4685-8498-49f3a281dd66"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2400,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":52000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2050,"monthly_call_quota":230000,"rps_limit":12,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5600,"monthly_call_quota":820000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/mesh-api"}