My Profile Insights Posts
GET
/profile/{profileId}/insights/posts
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
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 --request GET 'https://api.swonkie.dev/v2/profile/UG9zdElkMTIzNDU2Nzg53123/insights/posts?skip=0&take=100&since=2026-01-01&until=2026-01-31&metrics=fb-post-likes,fb-post-comments,fb-post-shares' \
--header 'X-API-ID: {{apiId}}' \
--header 'X-API-KEY: {{apiKey}}'Response Response Example
{
"hasMore": true,
"items": [
{
"id": "fb_post_123456789",
"picture": "https://storage.example.com/posts/abc123.jpg",
"type": "FEED",
"format": "IMAGE",
"url": "https://facebook.com/brandpage/posts/123456789",
"caption": "Check out our latest product launch! 🚀 #innovation #tech",
"publishedAt": "2026-01-30T14:30:00.000Z",
"insights": [
{
"metric": "fb-post-likes",
"value": 234,
"type": "NUMBER"
},
{
"metric": "fb-post-comments",
"value": 45,
"type": "NUMBER"
},
{
"metric": "fb-post-shares",
"value": 12,
"type": "NUMBER"
},
{
"metric": "fb-post-reach",
"value": 5420,
"type": "NUMBER"
}
]
},
{
"id": "fb_post_987654321",
"picture": null,
"type": "FEED",
"format": "TEXT",
"url": "https://facebook.com/brandpage/posts/987654321",
"caption": "Happy Monday everyone! What are your goals for this week?",
"publishedAt": "2026-01-27T09:00:00.000Z",
"insights": [
{
"metric": "fb-post-likes",
"value": 156,
"type": "NUMBER"
},
{
"metric": "fb-post-comments",
"value": 67,
"type": "NUMBER"
},
{
"metric": "fb-post-shares",
"value": 8,
"type": "NUMBER"
},
{
"metric": "fb-post-reach",
"value": 3890,
"type": "NUMBER"
}
]
}
],
"total": 45
}Modified at 2026-03-11 19:13:35