Skip to content
PostFlow

Read analytics

GET
/analytics
curl --request GET \
  --url 'https://postflow.biz.id/api/v1/analytics?days=7' \
  --header 'Authorization: Bearer <token>'

Published posts over 7, 30 or 90 days compared with the period before: totals, per day, per account, per content type, best times (90 days) and top posts. Metrics arrive 24 hours and 7 days after publishing.

MCP tool: get_analytics.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
days
string
default: 7
Allowed values: 7 30 90

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
days
required
integer
tiktok
required
Any of:
object
handoffs
required
integer
statsEnabled
required
boolean
reconnect
required
Array<object>
object
socialAccountId
required
string
name
required
string
totals
required
object
reach
required
number
likes
required
number
comments
required
number
shares
required
number
saves
required
number
views
required
number
available
required

How many posts reported each metric (platforms don’t all report every one).

object
reach
integer
likes
integer
comments
integer
shares
integer
saves
integer
views
integer
fetchedAt
required
Any of:
string format: date-time
posts
required
integer
measured
required

Posts with metrics (they arrive 24 hours after publishing).

integer
engagement
required

Likes + comments + shares + saves

number
rate
required
Any of:

Engagement ÷ reach

number
previous
required
object
reach
required
number
likes
required
number
comments
required
number
shares
required
number
saves
required
number
views
required
number
available
required

How many posts reported each metric (platforms don’t all report every one).

object
reach
integer
likes
integer
comments
integer
shares
integer
saves
integer
views
integer
fetchedAt
required
Any of:
string format: date-time
posts
required
integer
measured
required

Posts with metrics (they arrive 24 hours after publishing).

integer
engagement
required

Likes + comments + shares + saves

number
rate
required
Any of:

Engagement ÷ reach

number
daily
required
Array<object>
object
date
required
string
posts
required
integer
reach
required
Any of:
number
engagement
required
Any of:
number
previousDaily
required
Array<object>
object
date
required
string
posts
required
integer
reach
required
Any of:
number
engagement
required
Any of:
number
accounts
required
Array<object>
object
socialAccountId
required
string
platform
required
string
Allowed values: facebook instagram tiktok threads bluesky youtube telegram
name
required
string
avatarUrl
required
Any of:
string
published
required
integer
measured
required
integer
totals
required
object
reach
required
number
likes
required
number
comments
required
number
shares
required
number
saves
required
number
views
required
number
available
required

How many posts reported each metric (platforms don’t all report every one).

object
reach
integer
likes
integer
comments
integer
shares
integer
saves
integer
views
integer
engagement
required
number
engagementRate
required
Any of:
number
byType
required
Array<object>
object
contentType
required
string
Allowed values: fb_post fb_photo fb_video fb_reel ig_image ig_carousel ig_reel ig_story tt_video tt_photo th_text th_image th_video th_carousel tg_message tg_media bs_post bs_video yt_short yt_video
platform
required
string
Allowed values: facebook instagram tiktok threads bluesky youtube telegram
posts
required
integer
avgReach
required
Any of:
number
avgEngagement
required
number
rate
required
Any of:
number
heat
required
Array<object>
object
weekday
required
integer
hour
required
integer
posts
required
integer
avgEngagement
required
number
heatDays
required
integer
topPosts
required
Array<object>
object
postTargetId
required
string
postId
required
string
platform
required
string
Allowed values: facebook instagram tiktok threads bluesky youtube telegram
contentType
required
string
Allowed values: fb_post fb_photo fb_video fb_reel ig_image ig_carousel ig_reel ig_story tt_video tt_photo th_text th_image th_video th_carousel tg_message tg_media bs_post bs_video yt_short yt_video
accountName
required
string
caption
required
string
thumbUrl
required
Any of:
string
publishedAt
required
string format: date-time
permalink
required
Any of:
string
window
required
string
Allowed values: 24h 7d
totals
required
object
reach
required
number
likes
required
number
comments
required
number
shares
required
number
saves
required
number
views
required
number
available
required

How many posts reported each metric (platforms don’t all report every one).

object
reach
integer
likes
integer
comments
integer
shares
integer
saves
integer
views
integer
engagement
required
number
rate
required
Any of:
number

Example 

{
  "accounts": [
    {
      "platform": "facebook"
    }
  ],
  "byType": [
    {
      "contentType": "fb_post",
      "platform": "facebook"
    }
  ],
  "topPosts": [
    {
      "platform": "facebook",
      "contentType": "fb_post",
      "window": "24h"
    }
  ]
}

401

Section titled “401”

Missing, invalid, expired or deleted key or token.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

429

Section titled “429”

More than 120 requests in a minute with this key.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}
© 2026 PostFlow