Skip to main content
POST
/
instagram
/
analyzer
/
insights
Instagram Insights Analyzer Endpoint
curl --request POST \
  --url https://backend.clipvision.ai/instagram/analyzer/insights \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "access_token": "<string>",
  "user_id": "<string>",
  "max_results": 123,
  "time_range": 123
}'
{
  "insights": {
    "most_popular_videos": [
      {
        "id": "<string>",
        "is_shared_to_feed": true,
        "media_type": "<string>",
        "media_url": "<string>",
        "thumbnail_url": "<string>",
        "timestamp": "<string>",
        "insights": [
          {
            "name": "<string>",
            "period": "<string>",
            "values": [
              {
                "value": 123,
                "end_time": "<string>"
              }
            ],
            "title": "<string>",
            "description": "<string>",
            "id": "<string>"
          }
        ]
      }
    ],
    "most_liked_videos": [
      {
        "id": "<string>",
        "is_shared_to_feed": true,
        "media_type": "<string>",
        "media_url": "<string>",
        "thumbnail_url": "<string>",
        "timestamp": "<string>",
        "insights": [
          {
            "name": "<string>",
            "period": "<string>",
            "values": [
              {
                "value": 123,
                "end_time": "<string>"
              }
            ],
            "title": "<string>",
            "description": "<string>",
            "id": "<string>"
          }
        ]
      }
    ],
    "most_commented_videos": [
      {
        "id": "<string>",
        "is_shared_to_feed": true,
        "media_type": "<string>",
        "media_url": "<string>",
        "thumbnail_url": "<string>",
        "timestamp": "<string>",
        "insights": [
          {
            "name": "<string>",
            "period": "<string>",
            "values": [
              {
                "value": 123,
                "end_time": "<string>"
              }
            ],
            "title": "<string>",
            "description": "<string>",
            "id": "<string>"
          }
        ]
      }
    ],
    "most_shared_videos": [
      {
        "id": "<string>",
        "is_shared_to_feed": true,
        "media_type": "<string>",
        "media_url": "<string>",
        "thumbnail_url": "<string>",
        "timestamp": "<string>",
        "insights": [
          {
            "name": "<string>",
            "period": "<string>",
            "values": [
              {
                "value": 123,
                "end_time": "<string>"
              }
            ],
            "title": "<string>",
            "description": "<string>",
            "id": "<string>"
          }
        ]
      }
    ],
    "most_saved_videos": [
      {
        "id": "<string>",
        "is_shared_to_feed": true,
        "media_type": "<string>",
        "media_url": "<string>",
        "thumbnail_url": "<string>",
        "timestamp": "<string>",
        "insights": [
          {
            "name": "<string>",
            "period": "<string>",
            "values": [
              {
                "value": 123,
                "end_time": "<string>"
              }
            ],
            "title": "<string>",
            "description": "<string>",
            "id": "<string>"
          }
        ]
      }
    ],
    "most_reached_videos": [
      {
        "id": "<string>",
        "is_shared_to_feed": true,
        "media_type": "<string>",
        "media_url": "<string>",
        "thumbnail_url": "<string>",
        "timestamp": "<string>",
        "insights": [
          {
            "name": "<string>",
            "period": "<string>",
            "values": [
              {
                "value": 123,
                "end_time": "<string>"
              }
            ],
            "title": "<string>",
            "description": "<string>",
            "id": "<string>"
          }
        ]
      }
    ],
    "follower_count_data": [
      [
        {
          "value": 123,
          "end_time": "<string>"
        }
      ]
    ],
    "impressions_data": [
      [
        {
          "value": 123,
          "end_time": "<string>"
        }
      ]
    ],
    "profile_views_data": [
      [
        {
          "value": 123,
          "end_time": "<string>"
        }
      ]
    ],
    "reach_data": [
      [
        {
          "value": 123,
          "end_time": "<string>"
        }
      ]
    ]
  },
  "error": "<string>"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
access_token
string
required
Minimum length: 1
​
user_id
string
required
Minimum length: 1
​
max_results
integer
​
time_range
integer

0 for "This Week", 1 for "This Month", 2 for "This Year"

Response

Insights fetched successfully

Insights Response Object OpenAPI Schema

​
insights
object

Instagram Statistics OpenAPI Schema

​
error
string