ink.branchline.listAuthorActivity Documentation (EN)

main query

Per-day bud counts for an author over the trailing 30 days in the viewer's local timezone, plus a current streak (consecutive days ending today with at least one bud). Powers the leaf-themed activity strip on profile pages.

Parameters

actor string did Required

DID of the author whose activity to aggregate.

tz string Required

IANA timezone identifier (e.g. America/New_York) used to bucket createdAt into local days and to anchor 'today'.

Output

Encodingapplication/json

currentStreak integer Required

Consecutive days ending at `until` (inclusive) where count >= 1. Zero if the caller's 'today' has no buds yet.

days array Required

Exactly 30 entries, oldest-first, with zero-count days included.

since string Required

Inclusive start of the window in tz-local calendar form (YYYY-MM-DD). Always 29 days before `until`.

totalBuds integer Required

Sum of counts across the 30-day window.

until string Required

Inclusive end of the window in tz-local calendar form (YYYY-MM-DD). Always the caller's local 'today'.

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

actor * DID of the author whose activity to aggregate.

tz * IANA timezone identifier (e.g. America/New_York) used to bucket createdAt into local days and to anchor 'today'.

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "since",
        "until",
        "days",
        "currentStreak",
        "totalBuds"
      ],
      "properties": {
        "days": {
          "type": "array",
          "items": {
            "ref": "#dayCount",
            "type": "ref"
          },
          "description": "Exactly 30 entries, oldest-first, with zero-count days included."
        },
        "since": {
          "type": "string",
          "description": "Inclusive start of the window in tz-local calendar form (YYYY-MM-DD). Always 29 days before `until`."
        },
        "until": {
          "type": "string",
          "description": "Inclusive end of the window in tz-local calendar form (YYYY-MM-DD). Always the caller's local 'today'."
        },
        "totalBuds": {
          "type": "integer",
          "description": "Sum of counts across the 30-day window."
        },
        "currentStreak": {
          "type": "integer",
          "description": "Consecutive days ending at `until` (inclusive) where count >= 1. Zero if the caller's 'today' has no buds yet."
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "actor",
      "tz"
    ],
    "properties": {
      "tz": {
        "type": "string",
        "description": "IANA timezone identifier (e.g. America/New_York) used to bucket createdAt into local days and to anchor 'today'."
      },
      "actor": {
        "type": "string",
        "format": "did",
        "description": "DID of the author whose activity to aggregate."
      }
    }
  },
  "description": "Per-day bud counts for an author over the trailing 30 days in the viewer's local timezone, plus a current streak (consecutive days ending today with at least one bud). Powers the leaf-themed activity strip on profile pages."
}

dayCount object

No description available.

Properties

count integer Required

Number of buds the author created on this local day.

date string Required

tz-local calendar date (YYYY-MM-DD).

View raw schema

{
  "type": "object",
  "required": [
    "date",
    "count"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "tz-local calendar date (YYYY-MM-DD)."
    },
    "count": {
      "type": "integer",
      "description": "Number of buds the author created on this local day."
    }
  }
}