Guides
Analytics
Post and account metrics powered by Tinybird.
Aether serves analytics from Tinybird pipes — post-level metrics, account trends, and best posting times.
Availability
Analytics requires Tinybird to be configured on your Aether deployment. Returns 503 ANALYTICS_UNAVAILABLE when the service is not configured.
Post metrics
curl https://api.aetherhq.dev/v1/analytics/posts/{postId} \
-H "Authorization: Bearer $AETHER_API_KEY"const metrics = await client.analytics.getPostMetrics("post_abc123");Account metrics
curl "https://api.aetherhq.dev/v1/analytics/accounts?profileId=prof_ig123&from=2026-06-01&to=2026-06-30&granularity=day" \
-H "Authorization: Bearer $AETHER_API_KEY"| Parameter | Description |
|---|---|
profileId | Filter to one SocialProfile |
platform | Filter by platform |
from, to | Date range (ISO dates) |
granularity | day, week, or month |
const data = await client.analytics.getAccountMetrics({
profileId: "prof_ig123",
from: "2026-06-01",
to: "2026-06-30",
granularity: "day",
});Best posting times
curl "https://api.aetherhq.dev/v1/analytics/best-times?profileId=prof_ig123" \
-H "Authorization: Bearer $AETHER_API_KEY"const times = await client.analytics.getBestPostingTimes({ platform: "instagram" });Sync profile data
Trigger a manual analytics sync for a profile:
curl -X POST https://api.aetherhq.dev/v1/profiles/{profileId}/sync \
-H "Authorization: Bearer $AETHER_API_KEY"See Analytics API.