Competitor Insights
GET
/competitor/{competitorId}/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 | Competitor Daily Insights |
|---|---|
| Facebook (public) | ✅ |
| Instagram (public) | ✅ |
Notes
-pub suffix (e.g., fb-pub-daily-page-fans, ig-pub-daily-followers-count).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/competitor/UG9zdElkMTIzNDU2Nzg1423/insights?skip=0&take=100&since=2026-01-01&until=2026-01-31&metrics=ig-pub-daily-followers-count%2Cig-pub-post-count' \
--header 'X-API-ID: ' \
--header 'X-API-KEY: 'Response Response Example
{
"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
}Modified at 2026-06-19 17:25:23