{"openapi":"3.1.0","info":{"title":"Hotlist API","version":"1.0.0","license":{"name":"Free to read with attribution to Hotlist (hotlist.fru.dev)","url":"https://hotlist.fru.dev/agents"},"description":"What's trending in data, tech and AI, by day: the top 20 terms of every day with trend scores from public engagement signals. Free to read; cite Hotlist (hotlist.fru.dev). Cached; please stay under 60 requests a minute."},"servers":[{"url":"https://hotlist.fru.dev"}],"security":[],"paths":{"/api/today":{"get":{"operationId":"getToday","summary":"The latest day's top 20 trending terms","responses":{"200":{"description":"The ranking","content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"string"},"day":{"type":"string"},"terms":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"term":{"type":"string"},"slug":{"type":"string"},"category":{"type":"string","enum":["models","ai","dev","data","companies","hardware","people"]},"score":{"type":"number","description":"0 to 100"},"lift":{"type":"number","description":"Share of the day against the term's own 14-day mean"},"mentions":{"type":"integer"},"sources":{"type":"object","additionalProperties":{"type":"integer"}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"},"eng":{"type":"number"}}}},"url":{"type":"string"}}}}}}}}},"4XX":{"description":"Bad request, not found or rate limited"}}}},"/api/days/{day}":{"get":{"operationId":"getDay","summary":"A day's top 20","parameters":[{"name":"day","in":"path","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"The ranking","content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"string"},"day":{"type":"string"},"terms":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"term":{"type":"string"},"slug":{"type":"string"},"category":{"type":"string","enum":["models","ai","dev","data","companies","hardware","people"]},"score":{"type":"number","description":"0 to 100"},"lift":{"type":"number","description":"Share of the day against the term's own 14-day mean"},"mentions":{"type":"integer"},"sources":{"type":"object","additionalProperties":{"type":"integer"}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"source":{"type":"string"},"eng":{"type":"number"}}}},"url":{"type":"string"}}}}}}}}},"404":{"description":"No ranking for that day"},"4XX":{"description":"Bad request, not found or rate limited"}}}},"/api/calendar":{"get":{"operationId":"getCalendar","summary":"Each day's number one","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":400}}],"responses":{"200":{"description":"Days, oldest first","content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"string"},"days":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"top":{"type":"string"},"slug":{"type":"string"},"category":{"type":"string"},"score":{"type":"number"}}}}}}}}},"4XX":{"description":"Bad request, not found or rate limited"}}}},"/api/terms":{"get":{"operationId":"listTerms","summary":"Terms that made a daily top 20","parameters":[{"name":"cat","in":"query","required":false,"schema":{"type":"string","enum":["models","ai","dev","data","companies","hardware","people"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"A page of terms, most recent first","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"terms":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"cat":{"type":"string"},"domain":{"type":"string"},"auto":{"type":"boolean","description":"true: a new name found in titles, not checked by hand (Unverified)"},"firstSeen":{"type":"string"},"peakDay":{"type":"string"},"peakScore":{"type":"number"},"daysTop":{"type":"integer"},"daysFirst":{"type":"integer"}}}}}}}}},"4XX":{"description":"Bad request, not found or rate limited"}}}},"/api/terms/{slug}":{"get":{"operationId":"getTerm","summary":"A term and its daily scores (is it trending?)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The term","content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"string"},"term":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"cat":{"type":"string"},"domain":{"type":"string"},"auto":{"type":"boolean","description":"true: a new name found in titles, not checked by hand (Unverified)"},"firstSeen":{"type":"string"},"peakDay":{"type":"string"},"peakScore":{"type":"number"},"daysTop":{"type":"integer"},"daysFirst":{"type":"integer"}}},"series":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"score":{"type":"number"},"rank":{"type":"integer"}}}}}}}}},"404":{"description":"Unknown term"},"4XX":{"description":"Bad request, not found or rate limited"}}}},"/api/risers":{"get":{"operationId":"getRisers","summary":"Biggest week-over-week risers","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Risers","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"risers":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"term":{"type":"string"},"category":{"type":"string"},"thisWeek":{"type":"number"},"lastWeek":{"type":"number"},"change":{"type":"number"}}}}}}}}},"4XX":{"description":"Bad request, not found or rate limited"}}}},"/api/search":{"get":{"operationId":"search","summary":"Search terms, categories and days","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":20}}],"responses":{"200":{"description":"Ranked hits","content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"subtitle":{"type":"string"},"href":{"type":"string"},"group":{"type":"string"}}}}}}}}},"4XX":{"description":"Bad request, not found or rate limited"}}}}}}