Snapchat Analytics

Snapchat analytics endpoints provide insights for your connected Snapchat accounts.

1. GET /api/snapchat/overview

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

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/snapchat/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": 30,
        "value_last_period": 25,
        "percentage_change": "+20.0%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "views",
        "name": "Views",
        "value_current_period": 45000,
        "value_last_period": 38000,
        "percentage_change": "+18.4%",
        "description": "Total number of times your posts were viewed"
      },
      {
        "key": "likes",
        "name": "Likes",
        "value_current_period": 1200,
        "value_last_period": 1000,
        "percentage_change": "+20.0%",
        "description": "The number of likes on your posts"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 80,
        "value_last_period": 65,
        "percentage_change": "+23.1%",
        "description": "The number of comments on your posts"
      },
      {
        "key": "shares",
        "name": "Shares",
        "value_current_period": 200,
        "value_last_period": 160,
        "percentage_change": "+25.0%",
        "description": "The number of times your posts were shared"
      },
      {
        "key": "screenshots",
        "name": "Screenshots",
        "value_current_period": 95,
        "value_last_period": 80,
        "percentage_change": "+18.8%",
        "description": "The number of screenshots taken of your posts"
      }
    ],
    "total_followers": 8500,
    "post_performance": {
      "most_engaging": [],
      "least_engaging": [],
      "most_views": [],
      "least_views": [],
      "most_shared": [],
      "least_shared": []
    }
  }
}

Metrics

Key	Name	Description
posts	Posts	Total posts published
views	Views	Total number of times your posts were viewed
likes	Likes	The number of likes on your posts
comments	Comments	The number of comments on your posts
shares	Shares	The number of times your posts were shared
screenshots	Screenshots	The number of screenshots taken of your posts

---

2. GET /api/snapchat/posts

Returns analytics for individual posts.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/snapchat/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": 30,
        "value_last_period": 25,
        "percentage_change": "+20.0%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "views",
        "name": "Views",
        "value_current_period": 45000,
        "value_last_period": 38000,
        "percentage_change": "+18.4%",
        "description": "Total number of times your posts were viewed"
      },
      {
        "key": "likes",
        "name": "Likes",
        "value_current_period": 1200,
        "value_last_period": 1000,
        "percentage_change": "+20.0%",
        "description": "The number of likes on your posts"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 80,
        "value_last_period": 65,
        "percentage_change": "+23.1%",
        "description": "The number of comments on your posts"
      },
      {
        "key": "shares",
        "name": "Shares",
        "value_current_period": 200,
        "value_last_period": 160,
        "percentage_change": "+25.0%",
        "description": "The number of times your posts were shared"
      },
      {
        "key": "screenshots",
        "name": "Screenshots",
        "value_current_period": 95,
        "value_last_period": 80,
        "percentage_change": "+18.8%",
        "description": "The number of screenshots taken of your posts"
      }
    ],
    "posts": [
      {
        "id": "snap_123456",
        "page_id": "snapchat_account_123",
        "format": "video",
        "text": "Fun snap!",
        "permalink": "https://snapchat.com/add/username",
        "media_type": "VIDEO",
        "media_url": "https://example.com/video.mp4",
        "stats": {
          "views": 1500,
          "likes": 40,
          "comments": 5,
          "shares": 10,
          "screenshots": 3
        },
        "timestamp": "2025-05-01 12:00:00"
      }
    ]
  }
}

Post Stats

Field	Description
views	Number of views
likes	Number of likes
comments	Number of comments
shares	Number of shares
screenshots	Number of screenshots

✅ Result: You have successfully retrieved Snapchat analytics data!