Competitor Insights Posts

Retrieves post-level insights and metrics for one of your monitored competitor profiles over a specified date range. This endpoint provides detailed analytics for individual competitor posts, including publicly available engagement metrics such as likes, comments, shares, and views. The available metrics are limited to what the social network makes publicly accessible without authentication.
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	Competitor Post Insights
Facebook (public)	✅
Instagram (public)	✅

Notes

Only publicly available metrics are supported for competitor posts. Private metrics requiring authentication are not accessible.

Available metrics are limited to public engagement data (likes, comments, shares, views) that the social network makes publicly visible.

Competitor metric codes usually have a -pub suffix (e.g., fb-pub-post-likes, ig-pub-post-comments).

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

curl --location 'https://api.swonkie.dev/v2/competitor/UG9zdElkMTIzNDU2Nzg1423/insights/posts?skip=0&take=100&since=2026-01-01&until=2026-01-31&metrics=ig-pub-post-likes%2Cig-pub-post-comments' \ --header 'X-API-ID: ' \ --header 'X-API-KEY: '

{ "hasMore": true, "items": [ { "id": "ig_post_ABC123456", "picture": "https://storage.example.com/posts/competitor_abc.jpg", "type": "FEED", "format": "IMAGE", "url": "https://instagram.com/p/ABC123456", "caption": "Amazing view from the mountains! 🏔️ #nature #travel", "publishedAt": "2026-01-30T16:45:00.000Z", "insights": [ { "metric": "ig-pub-post-likes", "value": 12450, "type": "NUMBER" }, { "metric": "ig-pub-post-comments", "value": 234, "type": "NUMBER" } ] }, { "id": "ig_post_XYZ789012", "picture": "https://storage.example.com/posts/competitor_xyz.jpg", "type": "REEL", "format": "VIDEO", "url": "https://instagram.com/reel/XYZ789012", "caption": "Quick tips for your daily routine ✨", "publishedAt": "2026-01-28T11:20:00.000Z", "insights": [ { "metric": "ig-pub-post-likes", "value": 8920, "type": "NUMBER" }, { "metric": "ig-pub-post-comments", "value": 156, "type": "NUMBER" } ] } ], "total": 48 }

Competitor Insights Posts

Supported Networks

Notes

Request

Responses

Competitor Insights Posts

Supported Networks#

Notes#

Request

Responses

Supported Networks

Notes