{"openapi":"3.1.0","info":{"title":"H2 Papers JSON API","version":"0.1.0","description":"Structured Japanese-language database of PubMed molecular-hydrogen medical literature. Every paper-returning endpoint embeds safety_notes inline. See /llms.txt for the citation policy."},"servers":[{"url":"https://h2-papers.org"}],"paths":{"/api/papers/{pmid}":{"get":{"summary":"Single paper detail","parameters":[{"name":"pmid","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{1,9}$"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["ja","en"]}}],"responses":{"200":{"description":"Paper detail incl. safety_notes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Paper"}}}},"404":{"description":"Not found"}}}},"/api/papers/search":{"get":{"summary":"Search the paper corpus","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"delivery_method","in":"query","schema":{"type":"string","enum":["inhalation","hydrogen_water","injection","bath","topical","animal","in_vitro","mixed","na"]}},{"name":"effect_reported","in":"query","schema":{"type":"string","enum":["positive","null","mixed","adverse","not_assessed"]}},{"name":"study_type","in":"query","schema":{"type":"string","enum":["human_rct","human_observational","human_case","animal","in_vitro","review","meta_analysis","letter","other"]}},{"name":"year_min","in":"query","schema":{"type":"integer"}},{"name":"year_max","in":"query","schema":{"type":"integer"}},{"name":"lineage_only","in":"query","schema":{"type":"string","enum":["0","1"]}},{"name":"include_predatory","in":"query","schema":{"type":"string","enum":["0","1"]}},{"name":"lang","in":"query","schema":{"type":"string","enum":["ja","en"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Search result"}}}},"/api/safety-notes":{"get":{"summary":"List safety-notes detail pages"}},"/api/safety-notes/{slug}":{"get":{"summary":"Safety-notes detail page","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/topics":{"get":{"summary":"List topic meta-views"}},"/api/topics/{method}/{slug}":{"get":{"summary":"Topic meta-view with paper list + related safety notes","parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string","enum":["inhalers","hydrogen-water","injection","bath","topical"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}]}},"/.well-known/coverage.json":{"get":{"summary":"Corpus statistics (transparency)"}}},"components":{"schemas":{"Paper":{"type":"object","required":["pmid","title","safety_notes","_canonical"],"properties":{"pmid":{"type":"string"},"title":{"type":"string"},"abstract":{"type":"string","nullable":true},"classification":{"type":"object","properties":{"delivery_method":{"type":"string"},"effect_reported":{"type":"string"},"study_type":{"type":"string"}}},"safety_notes":{"type":"object","description":"ALWAYS cite this field together with the paper. Editorial coupling rule.","required":["primary_message","details_url"],"properties":{"primary_message":{"type":"string"},"details_url":{"type":"string"}}},"_canonical":{"type":"string","format":"uri"}}}}},"externalDocs":{"description":"Citation policy + endpoint manifest","url":"https://h2-papers.org/llms.txt"}}