pub.chive.admin.getViewDownloadTimeSeries Documentation (EN)

main query

Get view and download time series data

Parameters

granularity string Optional

Time bucket granularity

uri string at-uri Optional

Specific eprint URI (aggregate if omitted)

Output

Encodingapplication/json

buckets array Required

Time series data buckets

timestamp stringdatetime Required

Query timestamp

Errors

AuthenticationRequired

AdminRequired

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

granularity Time bucket granularity

uri Specific eprint URI (aggregate if omitted)

View raw schema

{
  "description": "Get view and download time series data",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "buckets": {
          "description": "Time series data buckets",
          "items": {
            "ref": "#timeSeriesBucket",
            "type": "ref"
          },
          "type": "array"
        },
        "timestamp": {
          "description": "Query timestamp",
          "format": "datetime",
          "type": "string"
        }
      },
      "required": [
        "buckets",
        "timestamp"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "granularity": {
        "description": "Time bucket granularity",
        "knownValues": [
          "hour",
          "day",
          "week"
        ],
        "type": "string"
      },
      "uri": {
        "description": "Specific eprint URI (aggregate if omitted)",
        "format": "at-uri",
        "type": "string"
      }
    },
    "type": "params"
  },
  "type": "query"
}

timeSeriesBucket object

A time series data point for views and downloads

Properties

downloads integer Required

Download count in this bucket

timestamp string datetime Required

Bucket timestamp

views integer Required

View count in this bucket

View raw schema

{
  "description": "A time series data point for views and downloads",
  "properties": {
    "downloads": {
      "description": "Download count in this bucket",
      "type": "integer"
    },
    "timestamp": {
      "description": "Bucket timestamp",
      "format": "datetime",
      "type": "string"
    },
    "views": {
      "description": "View count in this bucket",
      "type": "integer"
    }
  },
  "required": [
    "timestamp",
    "views",
    "downloads"
  ],
  "type": "object"
}