Analytics

Get Post Analytics

GET /api/v1/analytics/posts/:id
Authorization: Bearer chirpie_sk_YOUR_KEY

Returns engagement metrics for a published post. Metrics are cached for 1 hour — subsequent requests within that window return cached data.

Response `200 OK` (X post)

{
  "data": {
    "post_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "platform": "x",
    "impressions": 1250,
    "likes": 42,
    "retweets": 8,
    "replies": 3,
    "quotes": 1,
    "bookmarks": 5,
    "clicks": 15,
    "fetched_at": "2026-03-23T10:30:00.000Z"
  }
}

Response `200 OK` (Bluesky post)

{
  "data": {
    "post_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "platform": "bluesky",
    "impressions": 0,
    "likes": 18,
    "retweets": 4,
    "replies": 2,
    "quotes": 1,
    "bookmarks": 0,
    "clicks": 0,
    "fetched_at": "2026-03-23T11:00:00.000Z"
  }
}

Response `200 OK` (LinkedIn post)

{
  "data": {
    "post_id": "c3d4e5f6-a7b8-9012-cdef-234567890123",
    "platform": "linkedin",
    "impressions": 0,
    "likes": 25,
    "retweets": 6,
    "replies": 4,
    "quotes": 0,
    "bookmarks": 0,
    "clicks": 0,
    "fetched_at": "2026-03-23T11:30:00.000Z"
  }
}

Response `200 OK` (Threads post)

{
  "data": {
    "post_id": "d4e5f6a7-b8c9-0123-defa-345678901234",
    "platform": "threads",
    "impressions": 890,
    "likes": 32,
    "retweets": 7,
    "replies": 5,
    "quotes": 3,
    "bookmarks": 0,
    "clicks": 0,
    "fetched_at": "2026-03-23T12:00:00.000Z"
  }
}

Response `200 OK` (Mastodon post)

{
  "data": {
    "post_id": "e5f6a7b8-c9d0-1234-efab-456789012345",
    "platform": "mastodon",
    "impressions": 0,
    "likes": 15,
    "retweets": 6,
    "replies": 3,
    "quotes": 0,
    "bookmarks": 0,
    "clicks": 0,
    "fetched_at": "2026-03-23T12:30:00.000Z"
  }
}

Response `200 OK` (Instagram post)

{
  "data": {
    "post_id": "f6a7b8c9-d0e1-2345-fabc-567890123456",
    "platform": "instagram",
    "impressions": 2100,
    "likes": 85,
    "retweets": 12,
    "replies": 8,
    "quotes": 0,
    "bookmarks": 15,
    "clicks": 0,
    "fetched_at": "2026-03-23T13:00:00.000Z"
  }
}

Response `200 OK` (Facebook post)

{
  "data": {
    "post_id": "a7b8c9d0-e1f2-3456-abcd-678901234567",
    "platform": "facebook",
    "impressions": 3400,
    "likes": 120,
    "retweets": 45,
    "replies": 22,
    "quotes": 0,
    "bookmarks": 0,
    "clicks": 38,
    "fetched_at": "2026-03-23T13:30:00.000Z"
  }
}

Metrics

Metric	X	Bluesky	LinkedIn	Threads	Mastodon	Instagram	Facebook	Reddit	Pinterest	TikTok	YouTube	GBP	Description
`impressions`	Yes	No	No	Yes	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Views
`likes`	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	Yes	Yes	No	Likes/favourites/reactions
`retweets`	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	Yes	Yes	No	No	Reposts/shares/saves
`replies`	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	Yes	Yes	No	Replies/comments
`quotes`	Yes	Yes	No	Yes	No	No	No	No	No	No	No	No	Quote posts
`bookmarks`	Yes	No	No	No	No	Yes	No	No	Yes	Yes	No	No	Bookmarks/saves
`clicks`	Yes	No	No	No	No	No	Yes	No	Yes	No	No	Yes	Clicks
`fetched_at`	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	When fetched

Telegram and Snapchat do not expose analytics via their APIs. Analytics calls return all zeros.
Bluesky does not expose impressions, bookmarks, or click counts via the AT Protocol.
LinkedIn exposes likes, comments (mapped to replies), and shares (mapped to retweets) but does not expose impressions, clicks, bookmarks, or quotes.
Threads exposes views (mapped to impressions), likes, replies, reposts (mapped to retweets), and quotes but does not expose bookmarks or clicks.
Mastodon exposes favourites (mapped to likes), reblogs (mapped to retweets), and replies but does not expose impressions, bookmarks, clicks, or quotes.
Instagram exposes impressions, likes, comments (mapped to replies), shares (mapped to retweets), and saves (mapped to bookmarks) but does not expose clicks or quotes.
Facebook exposes impressions, reactions (mapped to likes), comments (mapped to replies), shares (mapped to retweets), and clicks but does not expose bookmarks or quotes.
Reddit exposes views (mapped to impressions), upvotes (mapped to likes), and comments (mapped to replies).
Pinterest exposes impressions, saves (mapped to retweets), pin clicks (mapped to clicks), and closeups (mapped to bookmarks).
TikTok exposes views (mapped to impressions), likes, comments (mapped to replies), shares (mapped to retweets), and saves (mapped to bookmarks).
YouTube exposes views (mapped to impressions), likes, and comments (mapped to replies).
Google Business Profile exposes views (mapped to impressions) and clicks.

Unavailable metrics return 0.

Error Responses

Status	Code	Condition
`400`	`bad_request`	Post not yet published or missing platform ID
`404`	`not_found`	Post not found
`502`	`upstream_error`	Failed to fetch from platform (returns cached data if available)

Analytics Retention

Plan	Retention
Free	48 hours
Starter	30 days
Pro	90 days
Scale	365 days
Enterprise	365 days

On this page