1. Insights
swonkie.dev
  • Introduction
  • 🆕 MCP Server
  • Changelog
  • Quick Start
  • Social Networks
    • Instagram v2
    • Google My Business
    • YouTube
    • X (Twitter)
    • Threads
    • Instagram
    • LinkedIn
    • TikTok
    • Facebook
  • ✨ Andie
    • Generate an Image
      POST
  • Search
    • Search Profiles
      GET
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Competitors
    • Add Competitor
      POST
    • Delete Competitor
      DELETE
  • Insights
    • Getting Started
    • My Profile Insights Metrics
      GET
    • My Profile Insights
      GET
    • My Profile Insights Posts
      GET
    • Competitor Insights Metrics
      GET
    • Competitor Insights
      GET
    • Competitor Insights Posts
      GET
  • Posts
    • Getting Started
    • Limits by Social Network
    • List Posts
    • Get a Post
    • Create a Post
    • Update a Post
    • Validate a Post
    • Delete a Post
    • Change Post Stage
  • Labels
    • Getting Started
    • List Labels
    • Create a Label
  • Media
    • Get a Media
    • Create a Media
    • Upload File to Media
    • Confirm Uploaded Media
    • Delete a Media
    • Create a Media from URL
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Insights

My Profile Insights Posts

GET
/profile/{profileId}/insights/posts
Retrieves post-level insights and metrics for one of your connected social media profiles over a specified date range. This endpoint provides detailed analytics for individual posts, including engagement metrics, reach, impressions, and other post-specific data. You can request metrics that apply to all posts (like likes, comments) or network-specific metrics (like Facebook reactions, Instagram saves).
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#

NetworkPost Insights
Facebook✅
Instagram✅
Instagram v2✅
LinkedIn✅
TikTok✅
Threads✅
YouTube✅
Meta Ads✅
Google My Business❌ No post-level metrics
X (Twitter)❌ Not supported

Notes#

Available metrics vary by social network and include both generic post metrics (likes, comments, shares) and network-specific metrics.
Formula metrics (calculated metrics) are not supported via the API.
Post types: FEED (regular posts), TEMP (stories/temporary content), REEL (short-form video), ADS (paid advertisements).
The notes object only appears when deprecated or soon-to-be-deprecated metrics are requested.
Data is returned in descending order by publish date (most recent first).

Request

Path Params

Query Params

Header Params

Responses

🟢200
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location '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%2Cfb-post-comments%2Cfb-post-shares' \
--header 'X-API-ID: ' \
--header 'X-API-KEY: '
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-06-19 17:25:23
Previous
My Profile Insights
Next
Competitor Insights Metrics
Built with