The Stave API is currently in closed prototype. Please contact us for access.

Forecasts take the shape of absolute probabilities at certain times. When you query this endpoint for a locale, you will receive a JSON of dates and probabilities per topic.

Example query:
http://stave-proto.herokuapp.com/pred/<your API key here>_nairobi

Example response:

[{"date":"2022-02-28","protests":0.0,"riots":0.0,"violence":0.0,"explosions":0.0,"battles":0.0,"all_types":0.0}]

Update status, current model accuracy, and regional tracked count can be tracked via out stats endpoint.

Dates for updates are given in YYYYMMDD format, and models are in YYYYMM format.

Example query:

http://stave-proto.herokuapp.com/stats/nairobi

Example response:

[{"name":"nairobi","id":37,"protests":0.6618637725,"riots":0.6887228261,"violence":0.7500544781,"explosions":1.0,"battles":0.9903846154,"all_types":0.6721018349,"count":1335.0,"data_updated":"20220403","model_updated":"202204"}]

Returns a JSON list of locales for which we currently offer forecasts.

Example query:

http://stave-proto.herokuapp.com/locales

Examples response:

["milan", "nairobi", "jakarta", "bristol"]