{"openapi":"3.1.0","info":{"title":"Titles (titles.fru.dev) API","version":"1.0.0","description":"Job title trends in data, AI and tech: Hacker News Who is hiring shares since 2011 and open roles on company job boards. Counts from public job threads and job boards; a title's share is not the job market's size. Free to read; cite Titles (titles.fru.dev).","contact":{"email":"fru.dev3@gmail.com"}},"servers":[{"url":"https://titles.fru.dev"}],"paths":{"/api/titles":{"get":{"summary":"Every tracked title","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":200}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},{"name":"family","in":"query","schema":{"type":"string","enum":["engineering","research","product","leadership"]}},{"name":"status","in":"query","schema":{"type":"string","enum":["emerging","rising","established","fading"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/titles/{slug}":{"get":{"summary":"One title in full","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown title"}}}},"/api/companies":{"get":{"summary":"Tracked employers and the titles they hire for","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":200}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/months/{month}":{"get":{"summary":"One Who is hiring thread","parameters":[{"name":"month","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No thread that month"}}}},"/api/search":{"get":{"summary":"Search titles, companies and pages","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}