Bluesky Analytics

Bluesky analytics endpoints provide insights for your connected Bluesky accounts.

1. GET /api/bluesky/overview

Returns account-level metrics with current vs. previous period comparison.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/bluesky/overview?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "metrics": [
      {
        "key": "posts",
        "name": "Posts",
        "value_current_period": 55,
        "value_last_period": 48,
        "percentage_change": "+14.6%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "impressions",
        "name": "Impressions",
        "value_current_period": 18000,
        "value_last_period": 15500,
        "percentage_change": "+16.1%",
        "description": "Total number of times your posts were shown"
      },
      {
        "key": "likes",
        "name": "Likes",
        "value_current_period": 650,
        "value_last_period": 580,
        "percentage_change": "+12.1%",
        "description": "The number of likes on your posts"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 90,
        "value_last_period": 75,
        "percentage_change": "+20.0%",
        "description": "The number of comments on your posts"
      },
      {
        "key": "reposts",
        "name": "Reposts",
        "value_current_period": 110,
        "value_last_period": 95,
        "percentage_change": "+15.8%",
        "description": "The number of reposts of your posts"
      },
      {
        "key": "quotes",
        "name": "Quotes",
        "value_current_period": 35,
        "value_last_period": 30,
        "percentage_change": "+16.7%",
        "description": "The number of quotes of your posts"
      }
    ],
    "total_followers": 1800,
    "post_performance": {
      "most_engaging": [],
      "least_engaging": [],
      "most_views": [],
      "least_views": [],
      "most_reposted": [],
      "least_reposted": []
    }
  }
}

Metrics

Key	Name	Description
posts	Posts	Total posts published
impressions	Impressions	Total number of times your posts were shown
likes	Likes	The number of likes on your posts
comments	Comments	The number of comments on your posts
reposts	Reposts	The number of reposts of your posts
quotes	Quotes	The number of quotes of your posts

---

2. GET /api/bluesky/posts

Returns analytics for individual posts.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/bluesky/posts?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "stats": [
      {
        "key": "posts",
        "name": "Posts",
        "value_current_period": 55,
        "value_last_period": 48,
        "percentage_change": "+14.6%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "impressions",
        "name": "Impressions",
        "value_current_period": 18000,
        "value_last_period": 15500,
        "percentage_change": "+16.1%",
        "description": "Total number of times your posts were shown"
      },
      {
        "key": "likes",
        "name": "Likes",
        "value_current_period": 650,
        "value_last_period": 580,
        "percentage_change": "+12.1%",
        "description": "The number of likes on your posts"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 90,
        "value_last_period": 75,
        "percentage_change": "+20.0%",
        "description": "The number of comments on your posts"
      },
      {
        "key": "reposts",
        "name": "Reposts",
        "value_current_period": 110,
        "value_last_period": 95,
        "percentage_change": "+15.8%",
        "description": "The number of reposts of your posts"
      },
      {
        "key": "quotes",
        "name": "Quotes",
        "value_current_period": 35,
        "value_last_period": 30,
        "percentage_change": "+16.7%",
        "description": "The number of quotes of your posts"
      }
    ],
    "posts": [
      {
        "id": "did:plc:abc123/post",
        "page_id": "bluesky_account_123",
        "format": "text",
        "text": "Hello Bluesky!",
        "permalink": "https://bsky.app/post/abc123",
        "media_type": "TEXT",
        "media_url": null,
        "stats": {
          "impressions": 327,
          "likes": 12,
          "comments": 2,
          "reposts": 5,
          "quotes": 1
        },
        "timestamp": "2025-05-01 14:00:00"
      }
    ]
  }
}

Post Stats

Field	Description
impressions	Number of impressions
likes	Number of likes
comments	Number of comments
reposts	Number of reposts
quotes	Number of quotes

✅ Result: You have successfully retrieved Bluesky analytics data!