Public ranking of useful city searches

Aggregated, privacy-safe usage by stable city identifier. No coordinates, users, projects, tokens or event rows are exposed. Strict DTO by default; legacy requires public_contract=legacy. See /docs/PUBLIC_API_MIGRATION.md.

get/usage/cities

Request

  • Base URL: https://api.roote.ai
  • URL: https://api.roote.ai/usage/cities
  • Auth: none required

Query parameters

period'24h' | '7d' | '30d' | '90d'

Aggregation period

limitinteger

Page size

offsetinteger

Deterministic pagination offset

public_contract'roote-1.0.0' | 'legacy'

Omit for strict DTO. Version remains an explicit alias. legacy is deprecated; no silent fallback.

Response

Strict public DTO (default and explicit version alias).

OR

Changes

No recorded changes to this operation across all 1 revision of this API.