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

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

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

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