pub.chive.admin.getMetricsOverview

lexicons.governance.chive.pub

Documentation

Get metrics overview with trending eprints for a given period

main query

Get metrics overview with trending eprints for a given period

Parameters

days integer Optional

Number of days to aggregate

Output

Encodingapplication/json
trending array Optional

Trending eprints in the period

Errors

AuthenticationRequired
AdminRequired
Try It

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

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Number of days to aggregate
View raw schema 
{
  "description": "Get metrics overview with trending eprints for a given period",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "period": {
          "description": "Period information",
          "ref": "#periodInfo",
          "type": "ref"
        },
        "trending": {
          "description": "Trending eprints in the period",
          "items": {
            "ref": "#trendingEprint",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "days": {
        "default": 7,
        "description": "Number of days to aggregate",
        "maximum": 90,
        "minimum": 1,
        "type": "integer"
      }
    },
    "type": "params"
  },
  "type": "query"
}
periodInfo object

Time period information

Properties

days integer Required

Number of days in the period

endDate string datetime Required

Period end date

startDate string datetime Required

Period start date

View raw schema 
{
  "description": "Time period information",
  "properties": {
    "days": {
      "description": "Number of days in the period",
      "type": "integer"
    },
    "endDate": {
      "description": "Period end date",
      "format": "datetime",
      "type": "string"
    },
    "startDate": {
      "description": "Period start date",
      "format": "datetime",
      "type": "string"
    }
  },
  "required": [
    "days",
    "startDate",
    "endDate"
  ],
  "type": "object"
}
trendingEprint object

A trending eprint with engagement metrics

Properties

authorDid string did Optional

Author DID

authorHandle string Optional

Author handle

downloads integer Required

Total downloads in period

title string Required

Eprint title

uri string at-uri Required

Eprint AT URI

velocity integer Optional

Engagement velocity in milliunits

views integer Required

Total views in period

View raw schema 
{
  "description": "A trending eprint with engagement metrics",
  "properties": {
    "authorDid": {
      "description": "Author DID",
      "format": "did",
      "type": "string"
    },
    "authorHandle": {
      "description": "Author handle",
      "type": "string"
    },
    "downloads": {
      "description": "Total downloads in period",
      "type": "integer"
    },
    "title": {
      "description": "Eprint title",
      "type": "string"
    },
    "uri": {
      "description": "Eprint AT URI",
      "format": "at-uri",
      "type": "string"
    },
    "velocity": {
      "description": "Engagement velocity in milliunits",
      "type": "integer"
    },
    "views": {
      "description": "Total views in period",
      "type": "integer"
    }
  },
  "required": [
    "uri",
    "title",
    "views",
    "downloads"
  ],
  "type": "object"
}

Lexicon Garden

@