pub.chive.admin.getTrendingVelocity Documentation (EN)

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.

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

Parameters

limit Maximum number of results

window Time window for velocity calculation

View raw schema

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

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

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