Data & API

Use GeoSignalsHub intelligence in your own research.

The public v1 API provides read-only access to processed observations, forecasts and analysis reports. Choose JSON for applications or CSV for spreadsheets and data-science workflows.

Open API discovery

Quick start

curl "https://geosignalshub.com/api/v1/data/covid-countries?format=json&limit=100"
curl -o conflicts.csv "https://geosignalshub.com/api/v1/data/active-conflicts?format=csv&limit=500"
curl "https://geosignalshub.com/api/v1/forecasts/conflicts?format=json"
curl -o report.csv "https://geosignalshub.com/api/v1/reports/outbreak-monitor?format=csv"

Base URL

https://geosignalshub.com/api/v1

Access

Public, read-only access. Authentication is not currently required.

Formats

Set format=json or format=csv. JSON is the default.

Observed data endpoints

Processed measurements and source-event records. Browse the machine-readable catalog.

ID	Description	Try it
`covid-countries`	Latest global COVID-19 country snapshot	JSON · CSV
`covid-history`	Locally retained COVID-19 country history	JSON · CSV
`cholera`	WHO cholera country reporting	JSON · CSV
`measles`	WHO measles country reporting	JSON · CSV
`malaria`	WHO malaria country reporting	JSON · CSV
`tuberculosis`	WHO tuberculosis country reporting	JSON · CSV
`mpox`	Latest global mpox country snapshot	JSON · CSV
`hantavirus`	Hantavirus surveillance snapshot	JSON · CSV
`active-conflicts`	Active conflict intelligence summary	JSON · CSV
`conflict-events`	Recent active-conflict source events	JSON · CSV

Forecast endpoints

Forward-looking watchlists and early-warning signals, kept separate from observed records. Browse the forecast catalog.

ID	Description	Try it
`conflicts`	Forecast-only conflict watchlist	JSON · CSV
`conflict-events`	Forecast-only conflict source events	JSON · CSV
`disease-signals`	Emerging disease early-warning signals	JSON · CSV

Analysis report endpoints

Monitoring summaries, alerts, metadata and dataset-refresh information. Browse the report catalog.

ID	Description	Try it
`conflict-monitor`	Conflict monitor coverage and methodology report	JSON · CSV
`outbreak-monitor`	Latest outbreak monitoring summary	JSON · CSV
`outbreak-alerts`	Current outbreak alert report	JSON · CSV
`data-refresh`	Dataset freshness and refresh status report	JSON · CSV
`covid-summary`	COVID-19 surveillance metadata report	JSON · CSV

Parameters and responses

Pagination

Tabular data and forecasts accept limit from 1 to 10,000 and a zero-based offset. Defaults are limit=1000 and offset=0.

JSON envelope

Dataset responses include the dataset ID, description, total row count, offset, returned count, limit and a data array.

CSV downloads

CSV responses include a download filename and column headings. Nested report fields use dotted column names when flattened.

HTTP status and errors

200 indicates success; 400 an invalid format or pagination value; 404 an unknown resource; and 503 a known resource whose current export is unavailable. JSON errors include stable error identifiers and a human-readable message.

Caching, freshness and limits

Public responses may be cached for five minutes. Data freshness varies by upstream source; use the data-refresh report to inspect processing status. Clients should cache responses, avoid excessive polling and tolerate fields being added as the v1 API evolves.

Interpretation and attribution

Observed data, model-derived forecasts and automated analysis are intentionally separated. Users remain responsible for validating important findings against the cited primary sources. GeoSignalsHub data is provided for informational and research use and should not be treated as professional advice.