Competitor Insights

Retrieves daily aggregated insights and metrics for one of your monitored competitor profiles over a specified date range. This endpoint provides analytics data such as followers, engagement, and other publicly available metrics that are tracked on a daily basis. The available metrics depend on what data the social network makes publicly accessible for competitor analysis.
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

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

Available metrics vary by social network and are typically limited to public data (followers, post counts, engagement on public posts).

Competitor metric codes usually have a -pub suffix (e.g., fb-pub-daily-page-fans, ig-pub-daily-followers-count).

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

curl --location --request GET 'https://api.swonkie.dev/v2/competitor/UG9zdElkMTIzNDU2Nzg1423/insights?skip=0&take=100&since=2026-01-01&until=2026-01-31&metrics=ig-pub-daily-followers-count,ig-pub-post-count' \ --header 'X-API-ID: {{apiId}}' \ --header 'X-API-KEY: {{apiKey}}'

{ "hasMore": false, "items": [ { "date": "2026-01-31T00:00:00.000Z", "insights": [ { "metric": "ig-pub-daily-followers-count", "value": 125340, "type": "NUMBER" }, { "metric": "ig-pub-post-count", "value": 2, "type": "NUMBER" } ] }, { "date": "2026-01-30T00:00:00.000Z", "insights": [ { "metric": "ig-pub-daily-followers-count", "value": 125120, "type": "NUMBER" }, { "metric": "ig-pub-post-count", "value": 1, "type": "NUMBER" } ] } ], "total": 31 }

Notes

Request

Responses

Competitor Insights

Notes#

Request

Responses

Notes