Analytics

Synced post engagement and automation run counts for this account. Post analytics follows the Posts scope. Automation analytics is available to any key with api. Paths are in the Analytics reference.

Post engagement

Likes, comments, shares, impressions, views, and clicks for posts published in the window. days defaults to 7 and is capped at 90. Numbers are the last sync, stored on each publication. Pull a fresh copy with POST /api/v1/posts/{id}/sync before you read the summary.

The body has windowDays, since, totals, byChannel, and topPosts (up to 10, highest impressions first). A key limited to Ads cannot call this path.

curl -sS "https://public-api.athenous.io/api/v1/posts/analytics/summary?days=7" \
  -H "X-Api-Key: $ATHENOUS_API_KEY"

Automation summary

days defaults to 7 and is capped at 90. The body has windowDays, since, totals (runs, success, failed, cancelled, successRate), byRule, and byStatus.

curl -sS "https://public-api.athenous.io/api/v1/automation/analytics/summary?days=7" \
  -H "X-Api-Key: $ATHENOUS_API_KEY"

One rule

The same window for a single rule. The rule must belong to this account. The body adds ruleId and lastRunAt.

curl -sS "https://public-api.athenous.io/api/v1/automation/rules/RULE_ID/analytics?days=30" \
  -H "X-Api-Key: $ATHENOUS_API_KEY"

Campaign metrics

Impressions, clicks, and spend stay on the campaign after POST /api/v1/campaigns/{id}/sync. Read them from Ads. This analytics path does not return that campaign dashboard.