pub.chive.tag.getTrending

chive.pub

Documentation

Get trending tags within a specified time window

main query

Get trending tags within a specified time window

Parameters

limit integer Optional

Maximum number of trending tags to return

timeWindow string Optional

Time window for trending calculation

Output

Encodingapplication/json
tags array Required

List of trending tags

timeWindow string Required

Time window used for this response

Known values: day, week, month
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 trending tags to return
Time window for trending calculation
View raw schema 
{
  "type": "query",
  "errors": [],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "tags",
        "timeWindow"
      ],
      "properties": {
        "tags": {
          "type": "array",
          "items": {
            "ref": "#tagSummary",
            "type": "ref"
          },
          "description": "List of trending tags"
        },
        "timeWindow": {
          "type": "string",
          "description": "Time window used for this response",
          "knownValues": [
            "day",
            "week",
            "month"
          ]
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [],
    "properties": {
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 50,
        "minimum": 1,
        "description": "Maximum number of trending tags to return"
      },
      "timeWindow": {
        "type": "string",
        "default": "week",
        "description": "Time window for trending calculation",
        "knownValues": [
          "day",
          "week",
          "month"
        ]
      }
    }
  },
  "description": "Get trending tags within a specified time window"
}
promotionTarget object

Target of tag promotion

Properties

type string Required

Type of promotion target

Known values: facet, authority
uri string Required

URI of the promotion target

View raw schema 
{
  "type": "object",
  "required": [
    "type",
    "uri"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "description": "URI of the promotion target"
    },
    "type": {
      "type": "string",
      "description": "Type of promotion target",
      "knownValues": [
        "facet",
        "authority"
      ]
    }
  },
  "description": "Target of tag promotion"
}
tagSummary object

Summary information for a tag

Properties

displayForms array of string Required

All display forms used for this tag

isPromoted boolean Required

Whether the tag has been promoted to a facet or authority

normalizedForm string Required

Normalized tag form (lowercase, hyphenated)

qualityScore integer Required

Tag quality score (0-100, scaled from 0-1)

minimum: 0maximum: 100
usageCount integer Required

Number of eprints tagged with this tag

minimum: 0
View raw schema 
{
  "type": "object",
  "required": [
    "normalizedForm",
    "displayForms",
    "usageCount",
    "qualityScore",
    "isPromoted"
  ],
  "properties": {
    "isPromoted": {
      "type": "boolean",
      "description": "Whether the tag has been promoted to a facet or authority"
    },
    "promotedTo": {
      "ref": "#promotionTarget",
      "type": "ref",
      "description": "Promotion target if promoted"
    },
    "usageCount": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of eprints tagged with this tag"
    },
    "displayForms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "All display forms used for this tag"
    },
    "qualityScore": {
      "type": "integer",
      "maximum": 100,
      "minimum": 0,
      "description": "Tag quality score (0-100, scaled from 0-1)"
    },
    "normalizedForm": {
      "type": "string",
      "description": "Normalized tag form (lowercase, hyphenated)"
    }
  },
  "description": "Summary information for a tag"
}

Lexicon Garden

@