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 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 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

Getting Started

My Profile Insights Posts

My Profile Insights

Notes#

Request

Responses

Notes