Creator OSDocs

API resource

Analytics

Post analytics

GET/v1/analytics/posts

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Per-post performance across every network, with an overview. Metrics a network doesn’t report come back as 0.

Query parameters

platformstring

Only this network.

accountIdstring

Only this account.

fromDateYYYY-MM-DD

Defaults to 90 days ago. Max range 366 days.

toDateYYYY-MM-DD

Defaults to today.

sortBystring

date, engagement, or a metric such as views.

orderstring

asc or desc.

pageinteger

Page number (default 1).

limitinteger

Page size (default 50).

curl "https://creatoros-production-5658.up.railway.app/v1/analytics/posts?fromDate=2026-09-01&sortBy=engagement&order=desc&limit=10" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "overview": {
    "totalPosts": 42,
    "publishedPosts": 40
  },
  "posts": [
    {
      "id": "post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO",
      "content": "Three hooks that doubled my watch time 👇",
      "publishedAt": "2026-09-18T22:00:04.000Z",
      "platforms": [
        {
          "platform": "instagram",
          "status": "published",
          "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
          "platformPostUrl": "https://www.instagram.com/reel/C9xYz/",
          "analytics": {
            "impressions": 91234,
            "reach": 60412,
            "views": 88210,
            "likes": 5120,
            "comments": 312,
            "shares": 890,
            "saves": 1402,
            "engagementRate": 12.9
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "pages": 5
  }
}

Daily metrics

GET/v1/analytics/daily

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Totals per day plus a per-network breakdown. Good for charts.

Query parameters

platformstring

Only this network.

fromDateISO 8601

Defaults to 180 days ago.

toDateISO 8601

Defaults to now.

curl "https://creatoros-production-5658.up.railway.app/v1/analytics/daily?fromDate=2026-09-01" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "dailyData": [
    {
      "date": "2026-09-24",
      "postCount": 2,
      "platforms": {
        "instagram": 1,
        "tiktok": 1
      },
      "metrics": {
        "impressions": 20412,
        "reach": 15001,
        "likes": 1204,
        "comments": 88,
        "shares": 140,
        "saves": 310,
        "clicks": 12,
        "views": 19870
      }
    }
  ],
  "platformBreakdown": [
    {
      "platform": "instagram",
      "postCount": 21,
      "impressions": 412034,
      "reach": 301220,
      "likes": 24011,
      "comments": 1502,
      "shares": 3301,
      "saves": 6012,
      "clicks": 210,
      "views": 398120
    }
  ]
}

Best time to post

GET/v1/analytics/best-time

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Average engagement by weekday and hour (UTC) from your own history. day_of_week 0 is Monday.

Query parameters

platformstring

Only this network.

accountIdstring

Only this account.

curl "https://creatoros-production-5658.up.railway.app/v1/analytics/best-time?platform=instagram" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "slots": [
    {
      "day_of_week": 3,
      "hour": 22,
      "avg_engagement": 1840.5,
      "post_count": 6
    },
    {
      "day_of_week": 6,
      "hour": 16,
      "avg_engagement": 1522,
      "post_count": 4
    }
  ]
}

Post timeline

GET/v1/analytics/post-timeline

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Day-by-day metrics for one post, per network, so you can see how it grew after publishing.

Query parameters

postIdstringrequired

The post_ id (or the network’s platformPostId).

fromDateISO 8601

Defaults to 90 days ago.

toDateISO 8601

Defaults to now.

curl "https://creatoros-production-5658.up.railway.app/v1/analytics/post-timeline?postId=post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "postId": "post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO",
  "timeline": [
    {
      "date": "2026-09-19",
      "platform": "instagram",
      "platformPostId": "18053924711234567",
      "impressions": 40210,
      "reach": 30112,
      "likes": 2210,
      "comments": 140,
      "shares": 401,
      "saves": 620,
      "clicks": 3,
      "views": 39870
    }
  ]
}

Content decay

GET/v1/analytics/content-decay

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

How fast your posts collect their engagement: the average share of final engagement reached at each point after publishing.

Query parameters

platformstring

Only this network.

accountIdstring

Only this account.

curl "https://creatoros-production-5658.up.railway.app/v1/analytics/content-decay" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "buckets": [
    {
      "bucket_order": 0,
      "bucket_label": "First hour",
      "avg_pct_of_final": 18.4,
      "post_count": 40
    },
    {
      "bucket_order": 3,
      "bucket_label": "First week",
      "avg_pct_of_final": 91.2,
      "post_count": 40
    }
  ]
}

Posting frequency

GET/v1/analytics/posting-frequency

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Engagement rate at each posting frequency (posts per week), per network. Use it to find how often to post.

Query parameters

platformstring

Only this network.

accountIdstring

Only this account.

curl "https://creatoros-production-5658.up.railway.app/v1/analytics/posting-frequency" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "frequency": [
    {
      "platform": "instagram",
      "posts_per_week": 5,
      "avg_engagement_rate": 6.8,
      "avg_engagement": 1420.5,
      "weeks_count": 6
    }
  ]
}
PreviousMediaNextComments