pub.chive.admin.getTrendingVelocity

lexicons.governance.chive.pub

Documentation

Get trending eprints ranked by engagement velocity

main query

Get trending eprints ranked by engagement velocity

Parameters

limit integer Optional

Maximum number of results

window string Optional

Time window for velocity calculation

Output

Encodingapplication/json
items array Required

Trending eprints with velocity data

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
Maximum number of results
Time window for velocity calculation
View raw schema 
{
  "description": "Get trending eprints ranked by engagement velocity",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "items": {
          "description": "Trending eprints with velocity data",
          "items": {
            "ref": "#velocityEntry",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "items"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "limit": {
        "default": 20,
        "description": "Maximum number of results",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "window": {
        "default": "24h",
        "description": "Time window for velocity calculation",
        "knownValues": [
          "24h",
          "7d",
          "30d"
        ],
        "type": "string"
      }
    },
    "type": "params"
  },
  "type": "query"
}
velocityEntry object

Eprint trending velocity entry

Properties

acceleration integer Optional

Velocity change between windows in milliunits (divide by 1000)

authorDid string did Optional

Author DID

dailyAvgBaseline integer Optional

Baseline window daily average views in milliunits (divide by 1000)

dailyAvgCurrent integer Optional

Current window daily average views in milliunits (divide by 1000)

downloads integer Optional

Total downloads in window

title string Required

Eprint title

uri string at-uri Required

Eprint AT URI

velocity integer Required

Engagement velocity in milliunits (divide by 1000 for ratio of current to baseline)

views integer Optional

Total views in window

View raw schema 
{
  "description": "Eprint trending velocity entry",
  "properties": {
    "acceleration": {
      "description": "Velocity change between windows in milliunits (divide by 1000)",
      "type": "integer"
    },
    "authorDid": {
      "description": "Author DID",
      "format": "did",
      "type": "string"
    },
    "dailyAvgBaseline": {
      "description": "Baseline window daily average views in milliunits (divide by 1000)",
      "type": "integer"
    },
    "dailyAvgCurrent": {
      "description": "Current window daily average views in milliunits (divide by 1000)",
      "type": "integer"
    },
    "downloads": {
      "description": "Total downloads in window",
      "type": "integer"
    },
    "title": {
      "description": "Eprint title",
      "type": "string"
    },
    "uri": {
      "description": "Eprint AT URI",
      "format": "at-uri",
      "type": "string"
    },
    "velocity": {
      "description": "Engagement velocity in milliunits (divide by 1000 for ratio of current to baseline)",
      "type": "integer"
    },
    "views": {
      "description": "Total views in window",
      "type": "integer"
    }
  },
  "required": [
    "uri",
    "title",
    "velocity"
  ],
  "type": "object"
}

Lexicon Garden

@