Aveiro API
Authentication
Sites
List Sites
List Templates
Create Site
Pages
Create a Page
Delete a Page
List Pages
Reorder Pages
Update a Page
Site Media
Publish Site
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
Social Performance
Website Mockup Video
TrademarkTrademark
Ctrl k
Search…
Sign up
Aveiro API
Authentication
Sites
List Sites
List Templates
Create Site
Pages
Create a Page
Delete a Page
List Pages
Reorder Pages
Update a Page
Site Media
Publish Site
Audience
Newsletter API Overview
Newsletter Campaigns
Social
Social API Overview
Social Accounts
Social Media
Social Posts
Social Performance
Website Mockup Video
Sponsored
Aveiro
aveiro.app
Sponsored
Aveiro
aveiro.app
TrademarkTrademark
AveiroBlogContact
© Aveiro. All rights reserved.
Built with Aveiro

Social Performance

GET /api/v1/social/performance — engagement data for published posts, so agents can learn what performs before drafting.
Updated 11d ago
Social Posts
Website Mockup Video
In short
Engagement snapshots (views/likes/comments/shares/saves per platform) are captured automatically ~1h, 20h, 72h and 7d after each post publishes. This route returns published posts with their first and latest snapshots — read it before drafting to see which content, platforms and timing perform.

How metrics are collected

After a post publishes, an hourly collector reads live engagement from each platform through Chirio on a decaying schedule — roughly 1h, 20h, 72h, and 7d after publish. The ~1h snapshot captures early velocity; the ~20h snapshot settles next-day totals; the ~7d snapshot the week totals. Collection then stops (engagement plateaus within a week). Instagram stories expire after 24 hours, so they are only read at ~1h and ~20h — a second pass before the story disappears. Feed posts continue through all four stages. A metric is null when the platform doesn't expose it or the connected account's token can't read it — never zero. Notable platform limits:
Platform
Available
Notes
Instagramviews, reach, likes, comments, saves, sharesviews/reach/saves/shares need a token with the insights permission — accounts connected before it was requested must be reconnected
Threadsviews, likes, replies, reposts, quotes, sharesAll metrics need the insights permission; older connections must be reconnected
Ximpressions, likes, replies, retweets, bookmarks, quotesReading metrics requires a paid X API tier; on the free tier every metric fails
LinkedInlikes, commentsNo view counts on this API surface
Redditscore (as likes), comments, upvote ratioAlways available
Orbit—No readable metrics surface; targets report null metrics

Get performance

GET /api/v1/social/performance?days=&limit=&offset=
Authorization: Bearer av_live_…
Required scope: social:write

Query parameters

Param
Description
daysLook-back window in days (default 30, max 90)
limitMax posts to return (default 50, max 100)
offsetPagination offset

Example response

first is the earliest snapshot (early velocity — the strongest predictor of final reach); latest the most recent (settled totals). Both are null for a post published less than ~1h ago. The full snapshot series for one post is returned by Get post as metrics.

Errors

HTTP
Code
When
400VALIDATION_ERRORNon-numeric days/limit/offset
401UNAUTHORIZEDMissing or invalid token
403FORBIDDENToken lacks social:write

Related

  • Social API overview
  • Social posts
  • Social accounts
{
  "posts": [
    {
      "postId": "d5c9…",
      "content": "Launch day! …",
      "platformOverrides": { "threads": "Shorter launch caption…" },
      "publishedAt": "2026-08-03T09:00:12Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "acc_…",
          "url": "https://www.instagram.com/p/…",
          "first": {
            "stage": 0,
            "views": 412, "likes": 38, "comments": 4, "shares": 2, "saves": 6,
            "extra": { "reach": 390 },
            "capturedAt": "2026-08-03T10:00:41Z"
          },
          "latest": {
            "stage": 3,
            "views": 5210, "likes": 301, "comments": 27, "shares": 19, "saves": 44,
            "extra": { "reach": 4788 },
            "capturedAt": "2026-08-10T09:30:08Z"
          }
        }
      ]
    }
  ]
}