1. Insights
swonkie.dev
  • Introduction
  • Quick Start
  • Changelog
  • Social Networks
    • Facebook
    • Instagram
    • LinkedIn
    • TikTok
    • Threads
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Insights
    • Getting Started
    • My Profile Insights
      GET
    • My Profile Insights Posts
      GET
    • Competitor Insights
      GET
    • Competitor Insights Posts
      GET
  • Posts
    • Getting Started
    • List Posts
      GET
    • Get a Post
      GET
    • Create a Post
      POST
    • Update a Post
      PUT
    • Validate a Post
      GET
    • Delete a Post
      DELETE
    • Change Post Stage
      PATCH
  • Labels
    • Getting Started
    • List Labels
      GET
    • Create a Label
      POST
  • Media
    • Get a Media
    • Create a Media
    • Upload File to Media
    • Confirm Uploaded Media
    • Delete a Media
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Insights

Competitor Insights

GET
/competitor/{competitorId}/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).

Request

Path Params

Query Params

Header Params

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
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}}'
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-03-11 19:13:36
Previous
My Profile Insights Posts
Next
Competitor Insights Posts
Built with