UnifAPI Docs

Audit an Instagram account's engagement

Returns an engagement audit of a public Instagram account from its recent posts: engagement rate, average likes and comments, best and worst posts, content segments and outliers. Returns `not_found` when the account does not exist or is private.

Pricing — $$ · min $0.01

Minimum 15 credits ($0.01) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/instagram/users/{username}/engagement

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

username*string

Instagram username (URL slug).

Length1 <= length <= 500

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/instagram/users/string/engagement"
{  "request_id": "string",  "data": {    "id": "string",    "username": "string",    "display_name": "string",    "avatar_url": "string",    "is_verified": true,    "is_private": true,    "audit": {      "can_calculate_engagement": true,      "follower_count": 0,      "average_engagement_rate_percent": 0,      "median_engagement_rate_percent": 0,      "average_likes_per_post": 0,      "average_comments_per_post": 0,      "comment_to_like_ratio": 0,      "engagement_volatility_percent": 0,      "best_post_shortcode": "string",      "worst_post_shortcode": "string",      "quality_label": "string",      "quality_label_note": "string",      "posts": [        {          "media": {            "id": "string",            "shortcode": "string",            "url": "string",            "kind": "string",            "media_type": "string",            "caption": "string",            "alt_text": "string",            "created_at": 0,            "owner": {              "id": "string",              "username": "string",              "display_name": "string",              "avatar_url": "string",              "is_verified": true,              "is_private": true            },            "like_count": 0,            "comment_count": 0,            "play_count": 0,            "share_count": 0,            "save_count": 0,            "is_likes_hidden": true,            "image_url": "string",            "thumbnail_url": "string",            "video_url": "string",            "duration": 0,            "dimensions": {              "width": 0,              "height": 0            },            "carousel": [              {                "id": "string",                "media_type": "string",                "image_url": "string",                "video_url": "string",                "duration": 0,                "dimensions": {                  "width": 0,                  "height": 0                },                "alt_text": "string"              }            ],            "audio": {              "id": "string",              "title": "string",              "artist": "string",              "is_original": true,              "artist_handle": "string"            },            "coauthors": [              {                "id": "string",                "username": "string",                "display_name": "string",                "avatar_url": "string",                "is_verified": true,                "is_private": true              }            ],            "tagged_users": [              {                "id": "string",                "username": "string",                "display_name": "string",                "avatar_url": "string",                "is_verified": true,                "is_private": true              }            ],            "location": {              "id": "string",              "name": "string",              "lat": 0,              "lng": 0            },            "is_paid_partnership": true,            "sponsors": [              {                "id": "string",                "username": "string",                "display_name": "string",                "avatar_url": "string",                "is_verified": true,                "is_private": true              }            ],            "is_comments_disabled": true,            "is_pinned": true,            "story": {              "expires_at": 0,              "link_stickers": [                {                  "url": "string",                  "display_url": "string"                }              ],              "mentions": [                {                  "id": "string",                  "username": "string",                  "display_name": "string",                  "avatar_url": "string",                  "is_verified": true,                  "is_private": true                }              ],              "shared_media": {                "id": "string",                "shortcode": "string"              }            }          },          "engagement_rate_percent": 0,          "is_outlier_high": true,          "is_outlier_low": true,          "skip_reason": "string"        }      ],      "content_segments": [        {          "media_type": "string",          "post_count": 0,          "average_engagement_rate_percent": 0        }      ],      "sample_coverage": {        "total_recent_posts": 0,        "usable_posts": 0,        "skipped_posts": 0,        "skipped_reasons": {          "missing_likes": 0,          "missing_comments": 0,          "missing_both": 0,          "owned_by_another_account": 0        }      },      "formula_description": "string",      "data_freshness_note": "string",      "insight": {        "headline_insight": "string",        "engagement_assessment": "string",        "content_pattern_observations": [          "string"        ],        "risks_and_caveats": [          "string"        ],        "recommended_experiments": [          "string"        ],        "api_use_case_teaser": "string"      }    }  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}