Refresh engagement metrics for recently published posts

Cloudflare Cron callback. Schedule hourly (15 * * * *), not daily.

The tick is hourly but each platform decides for itself whether it is due, based on what its API costs: free, generously rate-limited reads (Bluesky, Mastodon, Reddit, Threads, Facebook, dev.to, LinkedIn) refresh every hour, while X — whose tweet lookup requires a paid tier with a monthly read quota — refreshes once a day. Running this hourly is what lets one cron serve both cadences; running it daily would silently downgrade every platform to daily.

Only posts Cadencz published, and only the last 30 days, are read. A failure on one platform or channel never stops the rest — the response reports each outcome separately.

Authenticates with WORKER_SECRET.

post/api/v1/jobs/refresh-analytics

Request

Base URL: https://api.cadencz.com (the document declares no server; this is the origin it was published from)
URL: https://api.cadencz.com/api/v1/jobs/refresh-analytics
Auth: none declared

Response

Successful Response

status'ok' required

workspacesinteger required

refreshedinteger required

failed_platformsinteger required

Example response

{
  "failed_platforms": 1,
  "refreshed": 240,
  "status": "ok",
  "workspaces": 12,
  "workspaces_detail": []
}

Changes

No recorded changes to this operation across all 1 revision of this API.