/api/v2/analyticsGETFetches performance metrics. Pass
postId for one post's
aggregated + per-platform metrics, or accountId to list
metrics across an account's posts. One of the two is required.
Analytics requires an active subscription and includes one request
per post in the plan's monthly post allowance.Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Query Parameters
postId?string
Post ID for single-post analytics
accountId?string
Connected account ID to list analytics for
platform?"twitter" | "instagram" | "youtube" | "tiktok" | "pinterest" | "linkedin" | "bluesky" | "facebook" | "threads" | "googlebusiness"
Filter by platform (requires accountId)
source?"akarso" | "platform"
Where metrics come from: posts published via Akarso, or fetched directly from the platform account
fromDate?string
Only posts published after this ISO time
toDate?string
Only posts published before this ISO time
sortBy?"date" | "likes" | "comments" | "impressions" | "views" | "shares" | "saves" | "clicks" | "engagement"
order?"asc" | "desc"
limit?number
Page size
page?number
Page number, 1-based
Response
200
success *boolean
post?object | null
Present for single-post queries
total?number | null
Present for list queries
page?number | null
limit?number | null
posts?object[] | null
Present for list queries
400 · Invalid request body, path, or query parameters
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
401 · Missing or invalid API key
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
402
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
subscribeUrl?string
URL to start a subscription
403
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
limit?number
The plan limit that was hit
used?number
Current usage in this billing period
connected?number
Currently connected accounts
404 · Resource not found
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
429 · Upstream rate limit reached
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
502 · Upstream platform request failed
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
503 · Upstream service temporarily unavailable or submission outcome unknown
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details