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.

Bulk rules

Creating, enabling, and importing rules is on Automation. Paid plans can import up to 500 rules from CSV on https://api.athenous.io. An API key cannot call that path.

curl -sS "https://api.athenous.io/api/v1/automation/rules/csv/template" \
  -H "Accept: text/csv" --cookie "athenous_token=$ATHENOUS_TOKEN" -o rules-template.csv

curl -sS -X POST "https://api.athenous.io/api/v1/automation/rules/csv/import" \
  -H "Content-Type: text/csv" --cookie "athenous_token=$ATHENOUS_TOKEN" \
  --data-binary @rules.csv

Columns are name, description, trigger_type, trigger_config, conditions, actions, enabled, priority, severity, guard_config, tags, timezone, retry_max, retry_backoff_seconds, event_type, target_resource_type. Export is GET /api/v1/automation/rules/csv/export. Campaign bulk is on Ads. Post bulk is on Posts.