1. Insights
swonkie.dev
  • Introduction
  • Quick Start
  • Changelog
  • Social Networks
    • Facebook
    • Instagram
    • LinkedIn
    • TikTok
    • Threads
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Insights
    • Getting Started
    • My Profile Insights
      GET
    • My Profile Insights Posts
      GET
    • Competitor Insights
      GET
    • Competitor Insights Posts
      GET
  • Posts
    • Getting Started
    • List Posts
      GET
    • Get a Post
      GET
    • Create a Post
      POST
    • Update a Post
      PUT
    • Validate a Post
      GET
    • Delete a Post
      DELETE
    • Change Post Stage
      PATCH
  • Labels
    • Getting Started
    • List Labels
      GET
    • Create a Label
      POST
  • Media
    • Get a Media
    • Create a Media
    • Upload File to Media
    • Confirm Uploaded Media
    • Delete a Media
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Insights

My Profile Insights

GET
/profile/{profileId}/insights
Retrieves daily aggregated insights and metrics for one of your connected social media profiles over a specified date range. This endpoint provides analytics data such as followers, impressions, reach, engagement, and other network-specific metrics that are tracked on a daily basis. Each social network has its own set of available metrics that you can request.
You can find available metric codes in the metric documentation for each source. Only metrics explicitly marked as API supported are available through the API.

Notes#

Available metrics vary by social network. Consult the metrics documentation for your specific network (Facebook, Instagram, LinkedIn, TikTok, Threads, etc.).
Formula metrics (calculated metrics) are not supported via the API.
The notes object only appears when deprecated or soon-to-be-deprecated metrics are requested.
Data is returned in descending order by date (most recent first).

Request

Path Params

Query Params

Header Params

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.swonkie.dev/v2/profile/UG9zdElkMTIzNDU2Nzg52312/insights?skip=0&take=100&since=2026-01-01&until=2026-01-31&metrics=fb-daily-page-fans,fb-daily-page-impressions' \
--header 'X-API-ID: {{apiId}}' \
--header 'X-API-KEY: {{apiKey}}'
Response Response Example
{
    "hasMore": false,
    "items": [
        {
            "date": "2026-01-31T00:00:00.000Z",
            "insights": [
                {
                    "metric": "fb-daily-page-fans",
                    "value": 15420,
                    "type": "NUMBER"
                },
                {
                    "metric": "fb-daily-page-impressions",
                    "value": 8523,
                    "type": "NUMBER"
                },
                {
                    "metric": "fb-daily-page-engaged-users",
                    "value": 1245,
                    "type": "NUMBER"
                }
            ]
        },
        {
            "date": "2026-01-30T00:00:00.000Z",
            "insights": [
                {
                    "metric": "fb-daily-page-fans",
                    "value": 15400,
                    "type": "NUMBER"
                },
                {
                    "metric": "fb-daily-page-impressions",
                    "value": 7890,
                    "type": "NUMBER"
                },
                {
                    "metric": "fb-daily-page-engaged-users",
                    "value": 1123,
                    "type": "NUMBER"
                }
            ]
        }
    ],
    "total": 31,
    "notes": {
        "metricsDeprecated": {
            "message": "Some of the requested metrics have been deprecated and are no longer being tracked. Check the deprecation article for more information.",
            "metrics": [
                {
                    "metric": "fb-daily-page-impressions-viral",
                    "deprecatedAt": "2025-11-15T00:00:00.000Z",
                    "deprecationArticle": "https://help.swonkie.com/en/article/changelog-1fi74jn/"
                }
            ]
        },
        "futureDeprecatedMetrics": {
            "message": "Some of the requested metrics are scheduled for deprecation in the future. Check the deprecation article for more information.",
            "metrics": [
                {
                    "metric": "fb-daily-page-fans-locale",
                    "deprecatedAt": "2026-06-01T00:00:00.000Z",
                    "deprecationArticle": "https://help.swonkie.com/en/article/future-changes/"
                }
            ]
        }
    }
}
Modified at 2026-03-11 19:13:35
Previous
Getting Started
Next
My Profile Insights Posts
Built with