{"openapi":"3.1.0","info":{"title":"Predictions API","version":"1.0.0","description":"Dated, public predictions about data, AI and tech by named people and organizations, with sources and outcomes. Claims as their authors made them, linked to the source; outcomes are judged against the evidence linked. Free to read; cite Predictions (predictions.fru.dev). Responses are cached for an hour.","contact":{"email":"fru.dev3@gmail.com"}},"servers":[{"url":"https://predictions.fru.dev"}],"paths":{"/api/predictions":{"get":{"operationId":"listPredictions","summary":"Predictions, newest first","parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["open","due","true","missed","partly","judged","all"],"default":"all"}},{"name":"topic","in":"query","schema":{"type":"string"}},{"name":"person","in":"query","schema":{"type":"string"}},{"name":"company","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/predictions/{id}":{"get":{"operationId":"getPrediction","summary":"One prediction with its change history","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown prediction"}}}},"/api/coming-due":{"get":{"operationId":"comingDue","summary":"Open predictions by target date, and the ones past due","parameters":[{"name":"days","in":"query","schema":{"type":"integer","minimum":1,"maximum":7300,"default":365}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/people":{"get":{"operationId":"listPeople","summary":"People with scorecards (hit rate over judged predictions only; partly counts half)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/companies":{"get":{"operationId":"listCompanies","summary":"Companies for the companies.fru.dev registry sync: slug, name, domain, site URL, scorecard, dated items (target dates)","parameters":[{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only rows changed after this time (UTC)"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/changes":{"get":{"operationId":"listChanges","summary":"Append-only change log","parameters":[{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only rows changed after this time (UTC)"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":200}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/search":{"get":{"operationId":"search","summary":"Search predictions, people, 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"}}}}}}},"/calendar.ics":{"get":{"operationId":"calendarFeed","summary":"Target dates of open predictions as iCalendar","parameters":[{"name":"topic","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/calendar":{"schema":{"type":"string"}}}}}}}}}