sighting

GET /sighting/stats

Changed on

Aggregated sighting counts over a date range. Returns pre-grouped (no pagination) rows so the homepage can render the top-N charts and the evolution table without fetching raw sightings.

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/sighting/stats
  • Auth
    API key in header X-API-KEY

Query parameters

date_fromstring date

Inclusive lower bound of creation date. Format: YYYY-MM-DD.

date_tostring date

Inclusive upper bound of creation date. Format: YYYY-MM-DD.

type'seen' | 'published-proof-of-concept' | 'exploited' | 'not-exploited' | 'confirmed' | 'not-confirmed' | 'patched' | 'not-patched'

Optional filter on sighting type.

group_by'type,vulnerability' | 'vulnerability,date' required

Grouping dimensions. 'type,vulnerability' returns per-type vulnerability counts (charts); 'vulnerability,date' returns daily counts per vulnerability (table).

Response

Success

Changes