My Profile Insights
GET
/profile/{profileId}/insights
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.
Supported Networks
| Network | Daily Insights |
|---|---|
| ✅ | |
| ✅ | |
| Instagram v2 | ✅ |
| ✅ | |
| TikTok | ✅ |
| Threads | ✅ |
| Google My Business | ✅ |
| YouTube | ✅ |
| Meta Ads | ✅ |
| X (Twitter) | ❌ Not supported |
Notes
notes object only appears when deprecated or soon-to-be-deprecated metrics are requested.Request
Path Params
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '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%2Cfb-daily-page-impressions' \
--header 'X-API-ID: ' \
--header 'X-API-KEY: '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-06-19 17:25:23