# Instagram Engagement API. Send a handle or profile link.

Engagement rate over an account's latest posts. We handle the proxies, blocks and platform changes.

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dinstagram.engagement)

## Instagram Engagement API at a glance

Returns a public Instagram account's engagement rate over its latest posts, with its profile and those posts, from a username, link or user ID. The rate is per follower and per view, as mean, median and spread. You also get likes and comments per post, views per reel, comment-to-like ratio, posting cadence, the mix of reels, photos and carousels, and each post against the account's typical one.

GET `/v1/instagram/engagement`

[Read the API reference](https://socialtap.dev/docs/reference/instagram/engagement/index.md)

- **1 credit** per request, $0.75–$1.97 per 1,000 requests
- **12 typed fields** null when unknown
- **`handle`** is all it needs, e.g. `natgeo`
- **100 credits** free when you sign up, no card, so you can build before you spend

## Send one request. Get 12 fields back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

`$ npm install socialtap`

`handle = natgeo`

[Open in playground](https://socialtap.dev/playground/?endpoint=instagram.engagement)

cURL:

```shell
curl 'https://socialtap.dev/v1/instagram/engagement?handle=nasa' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.instagram.engagement.get({ handle: "nasa" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  handle: "nasa",
});
const res = await fetch(`https://socialtap.dev/v1/instagram/engagement?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/instagram/engagement",
    params={"handle": "nasa"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("handle", "nasa")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/instagram/engagement?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": {
    "approximate_fields": [],
    "bottom_post_id": "DfCo97ZlL5F",
    "id": "528817151",
    "metrics": {
      "comment_to_like_ratio": 0.002639,
      "comments_per_post": 1530.67,
      "counted_post_count": 6,
      "engagement_rate": 0.00557,
      "engagement_rate_stddev": 0.004258,
      "formats": [
        {
          "counted_post_count": 5,
          "engagement_rate": 0.003876,
          "interactions_per_post": 404732.8,
          "type": "image",
          "views_per_post": null
        },
        {
          "counted_post_count": 1,
          "engagement_rate": 0.014039,
          "interactions_per_post": 1465958,
          "type": "carousel",
          "views_per_post": null
        }
      ],
      "interactions_per_post": 581603.67,
      "likes_per_post": 580073,
      "median_engagement_rate": 0.004124,
      "median_views_per_post": null,
      "posts_per_week": 7.15,
      "quotes_per_post": null,
      "rated_post_count": 6,
      "reposts_per_post": null,
      "sampled_post_count": 12,
      "saves_per_post": null,
      "shares_per_post": null,
      "view_engagement_rate": null,
      "views_per_post": null
    },
    "newest_post_at": "2026-10-30T19:59:43Z",
    "oldest_post_at": "2026-10-25T22:30:00Z",
    "platform": "instagram",
    "platform_specific": {},
    "posts": [
      {
        "engagement_rate": 0.007422,
        "engagement_vs_median": 1.8,
        "is_counted": false,
        "post": {
          "approximate_fields": [],
          "author": {
            "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/29090066_159271188110124_1152068159029641216_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ig_cache_key=GBLhuwEsG5c225AAAAAAAADj9-wPbkULAAAB1501500j-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBE…",
            "display_name": "NASA",
            "id": "528817151",
            "is_verified": true,
            "url": "https://www.instagram.com/nasa/",
            "username": "nasa"
          },
          "coauthors": [
            {
              "avatar_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.2885-19/93880139_247576663101568_4560165171292536832_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=110&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_ss=7b68…",
              "display_name": "NASA Solar System Exploration",
              "id": "1611722079",
              "is_verified": true,
              "url": "https://www.instagram.com/nasasolarsystem/",
              "username": "nasasolarsystem"
            },
            {
              "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-19/670016304_18577283653042671_4689932669633757619_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_gid=S…",
              "display_name": "NASA Artemis",
              "id": "1104426670",
              "is_verified": true,
              "url": "https://www.instagram.com/nasaartemis/",
              "username": "nasaartemis"
            }
          ],
          "duration_ms": 43767,
          "hashtags": [
            "NASA",
            "ArtemisII",
            "Artemis"
          ],
          "id": "DeTUk4sDSp-",
          "is_nsfw": null,
          "is_pinned": true,
          "is_sponsored": false,
          "language": null,
          "media": [
            {
              "alt_text": null,
              "duration_ms": 43767,
              "expires_at": "2026-10-25T18:00:00Z",
              "height": 1908,
              "thumbnail_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-15/842191580_18656578867049152_4200499629839780998_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=111&ig_cache_key=NDAwNDYzNDk4OTM2MjQ4OTk4MjE4NjU2NTc4ODYxMDQ5MTUy.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=…",
              "type": "video",
              "url": "https://scontent-atl3-2.cdninstagram.com/o1/v/t2/f2/m86/AQNUvreb47JFAC3mKM7kF_weYHzhiVF-MfERm99CfyBTok0ezeRdbVW8cH5NXn4mxO8gVi6j1GQ2RU9i4ByvKCLVPHdDruUpsCKYDQI.mp4?_nc_cat=105&_nc_sid=SCRUBBED&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_ohc=SCRUBBED&efg=SCRUBBED&ccb=SCRUBBED&vs=S…",
              "width": 1074
            }
          ],
          "mentions": [
            "nasaartemis",
            "nasasolarsystem"
          ],
          "metrics": {
            "comment_count": 7677,
            "like_count": 767368,
            "quote_count": null,
            "repost_count": null,
            "save_count": null,
            "share_count": null,
            "view_count": 11243231
          },
          "platform": "instagram",
          "platform_specific": {
            "instagram": {
              "is_ai_generated": false,
              "link": null,
              "location": null
            }
          },
          "platform_type": "reel",
          "published_at": "2026-10-10T15:15:02Z",
          "text": "POV: you're watching the Earth set\n\nWe just released hundreds of new images and hours of new audio from our Artemis II mission around the Moon this spring. Check out our link in bio for the Artemis II Preliminary Lunar Science Report.\n\n#NASA #ArtemisII #Artemis",
          "thumbnail_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-15/842191580_18656578867049152_4200499629839780998_n.jpg?stp=c0.417.1074.1074a_dst-jpg_e15_tt6&_nc_cat=111&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-2.cdninstagra…",
          "title": null,
          "type": "video",
          "unknown_fields": [],
          "url": "https://www.instagram.com/reel/DeTUk4sDSp-/"
        },
        "view_engagement_rate": 0.068934,
        "views_vs_median": null
      },
      {
        "engagement_rate": 0.002856,
        "engagement_vs_median": 0.69,
        "is_counted": false,
        "post": {
          "approximate_fields": [],
          "author": {
            "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/432029380_939863124412845_4074172309041694202_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_ss=7b689…",
            "display_name": "NASA Webb Telescope",
            "id": "549313808",
            "is_verified": true,
            "url": "https://www.instagram.com/nasawebb/",
            "username": "nasawebb"
          },
          "coauthors": [
            {
              "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/437785305_1498177207718392_5285428334541669140_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=105&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_ss=7b…",
              "display_name": "NASA Universe",
              "id": "65495240044",
              "is_verified": true,
              "url": "https://www.instagram.com/nasauniverse/",
              "username": "nasauniverse"
            },
            {
              "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/29090066_159271188110124_1152068159029641216_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ig_cache_key=GBLhuwEsG5c225AAAAAAAADj9-wPbkULAAAB1501500j-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBE…",
              "display_name": "NASA",
              "id": "528817151",
              "is_verified": true,
              "url": "https://www.instagram.com/nasa/",
              "username": "nasa"
            }
          ],
          "duration_ms": null,
          "hashtags": [],
          "id": "DeJ28eTxo4s",
          "is_nsfw": null,
          "is_pinned": true,
          "is_sponsored": false,
          "language": null,
          "media": [
            {
              "alt_text": null,
              "duration_ms": null,
              "expires_at": "2026-10-25T18:00:00Z",
              "height": 1872,
              "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/838879752_18633093571001809_7013098794556155636_n.jpg?stp=c64.0.1872.1872a_dst-jpg_e35_s1080x1080_sh2.08_tt6&_nc_cat=109&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-a…",
              "type": "image",
              "url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/838879752_18633093571001809_7013098794556155636_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=109&ig_cache_key=NDAwMTk3MTM5NDExOTYzNDQ3Ng%3D%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=…",
              "width": 2000
            }
          ],
          "mentions": [
            "NASAWebb",
            "nasa",
            "nasauniverse"
          ],
          "metrics": {
            "comment_count": 1066,
            "like_count": 297195,
            "quote_count": null,
            "repost_count": null,
            "save_count": null,
            "share_count": null,
            "view_count": null
          },
          "platform": "instagram",
          "platform_specific": {
            "instagram": {
              "is_ai_generated": false,
              "link": null,
              "location": null
            }
          },
          "platform_type": "post",
          "published_at": "2026-10-06T13:10:11Z",
          "text": "Brewing up new stars 🪄\n \n@NASAWebb’s unique view of the stellar nursery known as NGC 7129 reveals numerous stars formerly hidden in this cosmic cauldron. \n \nStars begin their life in cold, dense regions of dust and gas, hiding from view of most telescopes. Webb’s high degree of i…",
          "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/838879752_18633093571001809_7013098794556155636_n.jpg?stp=c64.0.1872.1872a_dst-jpg_e35_s1080x1080_sh2.08_tt6&_nc_cat=109&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-a…",
          "title": null,
          "type": "image",
          "unknown_fields": [],
          "url": "https://www.instagram.com/p/DeJ28eTxo4s/"
        },
        "view_engagement_rate": null,
        "views_vs_median": null
      },
      {
        "engagement_rate": 0.013192,
        "engagement_vs_median": 3.2,
        "is_counted": false,
        "post": {
          "approximate_fields": [],
          "author": {
            "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/29090066_159271188110124_1152068159029641216_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ig_cache_key=GBLhuwEsG5c225AAAAAAAADj9-wPbkULAAAB1501500j-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBE…",
            "display_name": "NASA",
            "id": "528817151",
            "is_verified": true,
            "url": "https://www.instagram.com/nasa/",
            "username": "nasa"
          },
          "coauthors": [],
          "duration_ms": null,
          "hashtags": [
            "NASA",
            "Space",
            "Stars"
          ],
          "id": "DeAYvsnn4la",
          "is_nsfw": null,
          "is_pinned": true,
          "is_sponsored": false,
          "language": null,
          "media": [
            {
              "alt_text": null,
              "duration_ms": null,
              "expires_at": "2026-10-25T18:00:00Z",
              "height": 1350,
              "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/831222439_18653890615049152_5346150317938845760_n.jpg?stp=c0.135.1080.1080a_dst-jpg_e15_s1080x1080_tt6&_nc_cat=110&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-1.…",
              "type": "image",
              "url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/831222439_18653890615049152_5346150317938845760_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=110&ig_cache_key=Mzk5OTMwNDc1ODAwMTk1MzE5OA%3D%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=…",
              "width": 1080
            },
            {
              "alt_text": null,
              "duration_ms": null,
              "expires_at": "2026-10-25T18:00:00Z",
              "height": 1350,
              "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/830418338_18653890612049152_312587861543217627_n.jpg?stp=c0.135.1080.1080a_dst-jpg_e15_s1080x1080_tt6&_nc_cat=100&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-1.c…",
              "type": "image",
              "url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/830418338_18653890612049152_312587861543217627_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=100&ig_cache_key=Mzk5OTMwNDc1ODM0NjExNzEyOA%3D%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=2…",
              "width": 1080
            },
            {
              "alt_text": null,
              "duration_ms": null,
              "expires_at": "2026-10-25T18:00:00Z",
              "height": 1350,
              "thumbnail_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-15/831354642_18653890627049152_4381034991606753149_n.jpg?stp=c0.135.1080.1080a_dst-jpg_e15_s1080x1080_tt6&_nc_cat=104&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-2.…",
              "type": "image",
              "url": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-15/831354642_18653890627049152_4381034991606753149_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=104&ig_cache_key=Mzk5OTMwNDc2MDcwMzExNzQxOA%3D%3D.3-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=…",
              "width": 1080
            }
          ],
          "mentions": [
            "NASAWebb"
          ],
          "metrics": {
            "comment_count": 5627,
            "like_count": 1371892,
            "quote_count": null,
            "repost_count": null,
            "save_count": null,
            "share_count": null,
            "view_count": null
          },
          "platform": "instagram",
          "platform_specific": {
            "instagram": {
              "is_ai_generated": false,
              "link": null,
              "location": null
            }
          },
          "platform_type": "post",
          "published_at": "2026-10-02T20:52:45Z",
          "text": "Swipe for countless stars\n\nSagittarius B2 is the most massive and most active star-forming region in the Milky Way. It produces half of the stars in our home galaxy’s core.\n\nThis image of Sagittarius B2 was taken by our @NASAWebb telescope.\n\n#NASA #Space #Stars",
          "thumbnail_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-15/831222439_18653890615049152_5346150317938845760_n.jpg?stp=c0.135.1080.1080a_dst-jpg_e15_s1080x1080_tt6&_nc_cat=110&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-1.…",
          "title": null,
          "type": "carousel",
          "unknown_fields": [],
          "url": "https://www.instagram.com/p/DeAYvsnn4la/"
        },
        "view_engagement_rate": null,
        "views_vs_median": null
      }
    ],
    "profile": {
      "approximate_fields": [],
      "avatar_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/29090066_159271188110124_1152068159029641216_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ig_cache_key=GBLhuwEsG5c225AAAAAAAADj9-wPbkULAAAB1501500j-ccb7-5&ccb=SCRUBBED&_nc_sid=SCRUBBED&efg=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBE…",
      "banner_url": null,
      "bio": "Making the seemingly impossible, possible. ✨",
      "category": null,
      "country_code": null,
      "created_at": null,
      "display_name": "NASA",
      "external_links": [
        {
          "title": "NASA.gov Homepage",
          "url": "https://www.nasa.gov"
        },
        {
          "title": "MAX POWER",
          "url": "https://www.nasa.gov/maxpower"
        },
        {
          "title": "Roman Space Telescope Blog",
          "url": "https://science.nasa.gov/blogs/roman/"
        }
      ],
      "id": "528817151",
      "is_private": false,
      "is_verified": true,
      "location": null,
      "metrics": {
        "follower_count": 104419589,
        "following_count": 90,
        "post_count": 4986,
        "total_like_count": null,
        "total_view_count": null
      },
      "platform": "instagram",
      "platform_specific": {
        "instagram": {
          "account_type": null,
          "fbid": "17841401474538262",
          "is_highlights_shown": true,
          "is_memorialized": false,
          "is_story_live": false,
          "pronouns": []
        }
      },
      "type": "unknown",
      "unknown_fields": [],
      "url": "https://www.instagram.com/nasa/",
      "username": "nasa"
    },
    "top_post_id": "DfIY71Lku89",
    "unknown_fields": [],
    "url": "https://www.instagram.com/nasa/"
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "instagram",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 1899,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "profile",
      "id": "528817151",
      "url": "https://www.instagram.com/nasa/"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened here. Real responses are complete.

## One schema on 6 platforms.

The [response reference](https://socialtap.dev/docs/reference/instagram/engagement/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/engagement/index.md).

- ### Null means unknown

  A field Instagram doesn't show is null, never zero or an empty string, so a real zero always means zero.
- ### What it accepts

  Instagram username with or without the @ (natgeo, @natgeo), a numeric user ID (787132), or a profile link (instagram.com/natgeo, with or without a tab such as /reels/ or /tagged/, m.instagram.com, instagr.am, instagram.com/_u/natgeo, with any query such as ?igsh=…).
- ### Write one parser

  Instagram, TikTok, Facebook and 3 more platforms answer in these fields, so the code that reads one reads them all.

- **`platform`string**: Platform ID (tiktok, instagram, …).
- **`id`string**: Platform-native account ID (equals profile.id).
- **`url`string**: Canonical profile URL (equals profile.url).
- **`profile`object**: The account, as its profile endpoint returns it; its metrics.follower_count divides every engagement_rate.
- **`posts`object\[\]**: The sampled recent posts in the profile's order, each with its own figures. \[\] when none; \[\] and in unknown_fields when unreadable (a private account, a failed posts request).
- **`metrics`object**: Figures over the counted posts (by the account, not pinned); each null when no counted post has its inputs.
- **`oldest_post_at`string**: Publish time of the oldest counted post, RFC 3339 UTC: where the sample starts.
- **`newest_post_at`string**: Publish time of the newest counted post, RFC 3339 UTC: when the account last posted.

Live data from 33 platforms.

[TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md)

## What teams build with the Instagram Engagement API.

- ### Audit an influencer's engagement before signing
- ### Compare engagement across a creator shortlist
- ### Track engagement rate and posting cadence
- ### Spot an account's best and worst posts
- ### Find which format works best for an account

## Good to know before you build.

- The figures cover the account's latest posts, the first page of the Instagram Posts API. The profile and each post match what the Instagram Profile API and the Instagram Posts API return.
- Engagement rate counts likes plus comments, per follower and per view, so it compares across platforms. Share and save averages are null because Instagram doesn't show those counts logged out.
- Pinned posts lead a profile whatever their age, so they are flagged (is_pinned) and left out of the figures, as are collabs another account published.
- Only reels and videos have view counts, so views per post and the per-view rate cover those. A post whose owner hides its like count is left out of the rates.
- A private account returns its profile with posts \[\] listed in unknown_fields and every figure null. When the posts list can't be read, the same answer carries a partial_data warning.

## 1 credit per request. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

[Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/instagram/engagement/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| Source | Price per successful request | Per 1,000 requests |
| --- | --- | --- |
| Any source | 1 credit | $0.75–$1.97 |

- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

## Questions about the Instagram Engagement API.

More in the [API reference](https://socialtap.dev/docs/reference/instagram/engagement/index.md).

**How is the engagement rate computed?**

Likes plus comments over the follower count, for each counted post. metrics.engagement_rate is the mean over the posts with both counts, beside its median and spread, and view_engagement_rate is the same over each reel's or video's views.

**How much does the Instagram Engagement API cost?**

A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.

Other platforms

## Engagement stats on 5 more platforms.

- [TikTok Engagement API](https://socialtap.dev/apis/tiktok/engagement/index.md) (1 credit · `GET /v1/tiktok/engagement`)
- [Facebook Engagement API](https://socialtap.dev/apis/facebook/engagement/index.md) (1 credit · `GET /v1/facebook/engagement`)
- [YouTube Engagement API](https://socialtap.dev/apis/youtube/engagement/index.md) (1 credit · `GET /v1/youtube/engagement`)
- [Reddit Engagement API](https://socialtap.dev/apis/reddit/engagement/index.md) (1 credit · `GET /v1/reddit/engagement`)
- [Rumble Engagement API](https://socialtap.dev/apis/rumble/engagement/index.md) (1 credit · `GET /v1/rumble/engagement`)

More Instagram

## Instagram API. 28 endpoints, one key.

- [Instagram Post API](https://socialtap.dev/apis/instagram/post/index.md) (1 credit · `GET /v1/instagram/post`)
- [Instagram Story API](https://socialtap.dev/apis/instagram/story/index.md) (1 credit · `GET /v1/instagram/story`)
- [Instagram Posts API](https://socialtap.dev/apis/instagram/posts/index.md) (1 credit / page · `GET /v1/instagram/posts`)
- [Instagram Reels API](https://socialtap.dev/apis/instagram/reels/index.md) (1 credit / page · `GET /v1/instagram/reels`)
- [Instagram Search API](https://socialtap.dev/apis/instagram/search_posts/index.md) (1 credit / page · `GET /v1/instagram/search_posts`)
- [Instagram Audio Reels API](https://socialtap.dev/apis/instagram/sound_posts/index.md) (1 credit / page · `GET /v1/instagram/sound_posts`)
- [Instagram Hashtag Posts API](https://socialtap.dev/apis/instagram/hashtag_posts/index.md) (1 credit / page · `GET /v1/instagram/hashtag_posts`)
- [Instagram Location Posts API](https://socialtap.dev/apis/instagram/place_posts/index.md) (1 credit / page · `GET /v1/instagram/place_posts`)
- [Instagram Trending Reels API](https://socialtap.dev/apis/instagram/trending_posts/index.md) (1 credit / page · `GET /v1/instagram/trending_posts`)
- [Instagram Highlight Stories API](https://socialtap.dev/apis/instagram/playlist_stories/index.md) (1 credit / page · `GET /v1/instagram/playlist_stories`)
- [Instagram Profile API](https://socialtap.dev/apis/instagram/profile/index.md) (1 credit · `GET /v1/instagram/profile`)
- [Instagram Similar Accounts API](https://socialtap.dev/apis/instagram/similar_profiles/index.md) (1 credit / page · `GET /v1/instagram/similar_profiles`)
- [Instagram Comment API](https://socialtap.dev/apis/instagram/comment/index.md) (1 credit · `GET /v1/instagram/comment`)
- [Instagram Comments API](https://socialtap.dev/apis/instagram/comments/index.md) (1 credit / page · `GET /v1/instagram/comments`)
- [Instagram Reels Transcript API](https://socialtap.dev/apis/instagram/transcript/index.md) (From 1 credit · `GET /v1/instagram/transcript`)
- [Instagram Hashtag API](https://socialtap.dev/apis/instagram/hashtag/index.md) (1 credit · `GET /v1/instagram/hashtag`)
- [Instagram Hashtag Search API](https://socialtap.dev/apis/instagram/search_hashtags/index.md) (1 credit / page · `GET /v1/instagram/search_hashtags`)
- [Instagram User Search API](https://socialtap.dev/apis/instagram/search_profiles/index.md) (From 1 credit / page · `GET /v1/instagram/search_profiles`)
- [Instagram Audio Search API](https://socialtap.dev/apis/instagram/search_sounds/index.md) (From 1 credit / page · `GET /v1/instagram/search_sounds`)
- [Instagram Location Search API](https://socialtap.dev/apis/instagram/search_places/index.md) (From 1 credit / page · `GET /v1/instagram/search_places`)
- [Instagram Highlights API](https://socialtap.dev/apis/instagram/highlights/index.md) (1 credit / page · `GET /v1/instagram/highlights`)
- [Instagram Search Suggestions API](https://socialtap.dev/apis/instagram/search_suggestions/index.md) (1 credit / page · `GET /v1/instagram/search_suggestions`)
- [Instagram Location API](https://socialtap.dev/apis/instagram/place/index.md) (1 credit · `GET /v1/instagram/place`)
- [Instagram Audio API](https://socialtap.dev/apis/instagram/sound/index.md) (1 credit · `GET /v1/instagram/sound`)
- [Instagram Topic API](https://socialtap.dev/apis/instagram/topic/index.md) (1 credit · `GET /v1/instagram/topic`)
- [Instagram Embed API](https://socialtap.dev/apis/instagram/embed/index.md) (1 credit · `GET /v1/instagram/embed`)
- [Instagram Username Availability API](https://socialtap.dev/apis/instagram/username/index.md) (1 credit · `GET /v1/instagram/username`)

## Try it on an account you know.

Paste its handle or link in the playground, or copy the request into your code.

100free credits

- No credit card
- Failed requests are free
- Works on all 218 endpoints

[Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md)

---

[HTML version](https://socialtap.dev/apis/instagram/engagement/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
