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

Engagement rate, cadence and top posts. We handle the proxies, blocks and platform changes.

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

## Facebook Engagement API at a glance

Returns a public Facebook Page's or person's engagement rate and post stats, computed over its latest posts in one request. You get engagement rate per follower and per view (mean, median and spread), likes, comments and shares per post, views per video, comment-to-like ratio, posting cadence, the mix of photos, videos and reels, and the top and bottom post. The profile and each post come with it, with exact counts and each post's rate against the account's typical post. Send a name, ID or link.

GET `/v1/facebook/engagement`

[Read the API reference](https://socialtap.dev/docs/reference/facebook/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. `NASA`
- **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 = NASA`

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

cURL:

```shell
curl 'https://socialtap.dev/v1/facebook/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.facebook.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/facebook/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/facebook/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/facebook/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": "1676179567210746",
    "id": "100044561550831",
    "metrics": {
      "comment_to_like_ratio": 0.017837,
      "comments_per_post": 54,
      "counted_post_count": 3,
      "engagement_rate": 0.000107,
      "engagement_rate_stddev": 0.00014,
      "formats": [
        {
          "counted_post_count": 2,
          "engagement_rate": 0.000158,
          "interactions_per_post": 4527.5,
          "type": "image",
          "views_per_post": null
        },
        {
          "counted_post_count": 1,
          "engagement_rate": 0.000007,
          "interactions_per_post": 189,
          "type": "text",
          "views_per_post": null
        }
      ],
      "interactions_per_post": 3081.33,
      "likes_per_post": 3027.33,
      "median_engagement_rate": 0.00001,
      "median_views_per_post": null,
      "posts_per_week": 16.03,
      "quotes_per_post": null,
      "rated_post_count": 3,
      "reposts_per_post": null,
      "sampled_post_count": 3,
      "saves_per_post": null,
      "shares_per_post": 214.33,
      "view_engagement_rate": null,
      "views_per_post": null
    },
    "newest_post_at": "2026-11-03T19:27:52Z",
    "oldest_post_at": "2026-11-02T22:30:00Z",
    "platform": "facebook",
    "platform_specific": {},
    "posts": [
      {
        "engagement_rate": 0.000007,
        "engagement_vs_median": 0.66,
        "is_counted": true,
        "post": {
          "approximate_fields": [],
          "author": {
            "avatar_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=cp0_dst-png&cstp=mx800x800&ctp=s80x80&_nc_cat=108&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&_nc_ss=…",
            "display_name": "NASA - National Aeronautics and Space Administration",
            "id": "100044561550831",
            "is_verified": true,
            "url": "https://www.facebook.com/NASA",
            "username": "NASA"
          },
          "coauthors": [],
          "duration_ms": null,
          "hashtags": [],
          "id": "1676179567210746",
          "is_nsfw": null,
          "is_pinned": null,
          "is_sponsored": null,
          "language": null,
          "media": [],
          "mentions": [],
          "metrics": {
            "comment_count": 10,
            "like_count": 179,
            "quote_count": null,
            "repost_count": null,
            "save_count": null,
            "share_count": 6,
            "view_count": null
          },
          "platform": "facebook",
          "platform_specific": {
            "facebook": {
              "feedback_id": "ZmVlZGJhY2s6cGZiaWQwMmlSQkFpeENQd1R1Zml6aUFWTXZRdWEzTEJuZHk2dGYzUHl2NDE1UWtaZjdGdjdneTM1U2VpRVltN3Z0UGNMcGps",
              "group": null,
              "is_attachment_unavailable": false,
              "link": null,
              "listing": null,
              "music": null,
              "reactions": [
                {
                  "count": 155,
                  "type": "like"
                },
                {
                  "count": 22,
                  "type": "love"
                },
                {
                  "count": 1,
                  "type": "care"
                }
              ],
              "shared_post": {
                "author": {
                  "avatar_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/516872204_1189959146491994_4245240435554141606_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx2048x2047&ctp=s80x80&_nc_cat=103&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&…",
                  "display_name": "Learn With NASA",
                  "id": "100064337605401",
                  "is_verified": true,
                  "url": "https://www.facebook.com/LearnWithNASA",
                  "username": "LearnWithNASA"
                },
                "id": "1615866537234584",
                "url": "https://www.facebook.com/LearnWithNASA/posts/pfbid0qRf3ZGacva8hj6xVFVrBA29EF3mMnZGmcG6zYUaeLRB1yHARL2KHoPFaqH5jM72yl"
              },
              "video_id": null
            }
          },
          "platform_type": "post",
          "published_at": "2026-11-03T19:27:52Z",
          "text": null,
          "thumbnail_url": null,
          "title": null,
          "type": "text",
          "unknown_fields": [],
          "url": "https://www.facebook.com/NASA/posts/pfbid02iRBAixCPwTufiziAVMvQua3LBndy6tf3Pyv415QkZf7Fv7gy35SeiEYm7vtPcLpjl"
        },
        "view_engagement_rate": null,
        "views_vs_median": null
      },
      {
        "engagement_rate": 0.000305,
        "engagement_vs_median": 30.55,
        "is_counted": true,
        "post": {
          "approximate_fields": [],
          "author": {
            "avatar_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=cp0_dst-png&cstp=mx800x800&ctp=s80x80&_nc_cat=108&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&_nc_ss=…",
            "display_name": "NASA - National Aeronautics and Space Administration",
            "id": "100044561550831",
            "is_verified": true,
            "url": "https://www.facebook.com/NASA",
            "username": "NASA"
          },
          "coauthors": [],
          "duration_ms": null,
          "hashtags": [],
          "id": "1675983783896991",
          "is_nsfw": null,
          "is_pinned": null,
          "is_sponsored": null,
          "language": null,
          "media": [
            {
              "alt_text": "An intricate cloud of white dust takes center stage in this photo, rising in a windy pillar. The background features rust-colored dust with dots of distant stars and galaxies shining through.",
              "duration_ms": null,
              "expires_at": "2026-10-25T18:00:00Z",
              "height": 1385,
              "thumbnail_url": null,
              "type": "image",
              "url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.99422-6/871223884_1487536193225483_3660942795677810580_n.png?stp=dst-jpg_tt6&cstp=mx2000x1385&ctp=s2000x1385&_nc_cat=101&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&…",
              "width": 2000
            }
          ],
          "mentions": [
            "NASAWebb"
          ],
          "metrics": {
            "comment_count": 134,
            "like_count": 8634,
            "quote_count": null,
            "repost_count": null,
            "save_count": null,
            "share_count": 606,
            "view_count": null
          },
          "platform": "facebook",
          "platform_specific": {
            "facebook": {
              "feedback_id": "ZmVlZGJhY2s6cGZiaWQwZDJ3bUtXZm9Lc1Q5d0s5bndvV1c1SHpzRWd2MjhjSno5UTZuUDVBMjZCTGNrdVFlQWJCWnNQM0RuSm1pU2s3Q2w=",
              "group": null,
              "is_attachment_unavailable": false,
              "link": null,
              "listing": null,
              "music": null,
              "reactions": [
                {
                  "count": 4819,
                  "type": "like"
                },
                {
                  "count": 3553,
                  "type": "love"
                },
                {
                  "count": 148,
                  "type": "care"
                }
              ],
              "shared_post": null,
              "video_id": null
            }
          },
          "platform_type": "post",
          "published_at": "2026-11-03T15:00:35Z",
          "text": "Pspsps 🐈‍⬛\n\nThis smoky specter is the Cat’s Head Nebula, captured in intricate detail by NASA's James Webb Space Telescope. Its name comes from its shape, which resembles a cosmic kitty sitting with its back toward the viewer. What do you see?",
          "thumbnail_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.99422-6/871223884_1487536193225483_3660942795677810580_n.png?stp=dst-jpg_tt6&cstp=mx2000x1385&ctp=s2000x1385&_nc_cat=101&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&…",
          "title": null,
          "type": "image",
          "unknown_fields": [],
          "url": "https://www.facebook.com/NASA/posts/pfbid0d2wmKWfoKsT9wK9nwoWW5HzsEgv28cJz9Q6nP5A26BLckuQeAbBZsP3DnJmiSk7Cl"
        },
        "view_engagement_rate": null,
        "views_vs_median": null
      },
      {
        "engagement_rate": 0.00001,
        "engagement_vs_median": 1,
        "is_counted": true,
        "post": {
          "approximate_fields": [],
          "author": {
            "avatar_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=cp0_dst-png&cstp=mx800x800&ctp=s80x80&_nc_cat=108&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&_nc_ss=…",
            "display_name": "NASA - National Aeronautics and Space Administration",
            "id": "100044561550831",
            "is_verified": true,
            "url": "https://www.facebook.com/NASA",
            "username": "NASA"
          },
          "coauthors": [],
          "duration_ms": null,
          "hashtags": [],
          "id": "1675279183967451",
          "is_nsfw": null,
          "is_pinned": null,
          "is_sponsored": null,
          "language": null,
          "media": [
            {
              "alt_text": "An image that shows the \"MAX POWER Kennedy Space Center\" app as it appears in the iOS App Store.",
              "duration_ms": null,
              "expires_at": "2026-10-25T18:00:00Z",
              "height": 1294,
              "thumbnail_url": null,
              "type": "image",
              "url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.99422-6/864280748_2020097565352172_6759494451320615303_n.png?stp=dst-jpg_tt6&cstp=mx2048x1294&ctp=s2048x1294&_nc_cat=111&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&…",
              "width": 2048
            }
          ],
          "mentions": [],
          "metrics": {
            "comment_count": 18,
            "like_count": 269,
            "quote_count": null,
            "repost_count": null,
            "save_count": null,
            "share_count": 31,
            "view_count": null
          },
          "platform": "facebook",
          "platform_specific": {
            "facebook": {
              "feedback_id": "ZmVlZGJhY2s6cGZiaWQwMnBqYUxiZmhBbkZtckRvb254eDdHeWVwVDFIN3BGYmk5d3JwcXF1TDZvTTVnVFVKYmZCRTJCVDJYY2h0RzkzcjJs",
              "group": null,
              "is_attachment_unavailable": false,
              "link": null,
              "listing": null,
              "music": null,
              "reactions": [
                {
                  "count": 231,
                  "type": "like"
                },
                {
                  "count": 30,
                  "type": "love"
                },
                {
                  "count": 5,
                  "type": "care"
                }
              ],
              "shared_post": null,
              "video_id": null
            }
          },
          "platform_type": "post",
          "published_at": "2026-11-02T22:30:00Z",
          "text": "Planning your trip to MAX POWER? We've got a tool for that.\n\nEvent schedules, maps, and FAQs are at your fingertips with the MAX POWER app. It's free and available to download from official app stores on iOS and Android devices: https://go.nasa.gov/3V2iiWX",
          "thumbnail_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.99422-6/864280748_2020097565352172_6759494451320615303_n.png?stp=dst-jpg_tt6&cstp=mx2048x1294&ctp=s2048x1294&_nc_cat=111&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&…",
          "title": null,
          "type": "image",
          "unknown_fields": [],
          "url": "https://www.facebook.com/NASA/posts/pfbid02pjaLbfhAnFmrDoonxx7GyepT1H7pFbi9wrpqquL6oM5gTUJbfBE2BT2XchtG93r2l"
        },
        "view_engagement_rate": null,
        "views_vs_median": null
      }
    ],
    "profile": {
      "approximate_fields": [],
      "avatar_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s800x800&_nc_cat=108&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&_nc_ss=7b…",
      "banner_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.99422-6/809146614_4484013928506139_3181913787670602881_n.png?stp=dst-jpg_tt6&cstp=mx2047x1487&ctp=s2047x1487&_nc_cat=110&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&…",
      "bio": "Explore the universe and discover our home planet. \nThere's space for everybody. ✨",
      "category": "Government organization",
      "country_code": null,
      "created_at": "2009-03-04T21:45:25Z",
      "display_name": "NASA - National Aeronautics and Space Administration",
      "external_links": [
        {
          "title": "nasa.gov/nasa-app",
          "url": "https://www.nasa.gov/nasa-app/"
        },
        {
          "title": "nasa.gov",
          "url": "https://www.nasa.gov/"
        }
      ],
      "id": "100044561550831",
      "is_private": null,
      "is_verified": true,
      "location": null,
      "metrics": {
        "follower_count": 28732202,
        "following_count": 52,
        "post_count": null,
        "total_like_count": null,
        "total_view_count": null
      },
      "platform": "facebook",
      "platform_specific": {
        "facebook": {
          "ad_library_entity_type": null,
          "admin_countries": [
            {
              "count": 15,
              "country": "United States"
            }
          ],
          "alternate_name": null,
          "business_hours": [],
          "education": [],
          "email": "public-inquiries@hq.nasa.gov",
          "gender": null,
          "hometown": null,
          "hours_status": null,
          "instagram_follower_count": null,
          "instagram_username": null,
          "is_deleted": null,
          "is_instagram_verified": null,
          "is_memorialized": false,
          "is_political_advertiser": false,
          "is_running_ads": false,
          "name_changes": [
            {
              "changed_at": "2014-04-07T19:49:21Z",
              "name": "NASA - National Aeronautics and Space Administration"
            }
          ],
          "owner_location": "WASHINGTON DC, 20024 United States of America",
          "owner_name": "NATIONAL AERONAUTICS AND SPACE ADMINISTRATION",
          "page_id": "54971236771",
          "phone": null,
          "price_range": null,
          "rating": null,
          "recommend_percent": null,
          "relationship": null,
          "review_count": null,
          "services": [],
          "talking_about_count": null,
          "were_here_count": null,
          "work": []
        }
      },
      "type": "organization",
      "unknown_fields": [],
      "url": "https://www.facebook.com/NASA",
      "username": "NASA"
    },
    "top_post_id": "1675983783896991",
    "unknown_fields": [],
    "url": "https://www.facebook.com/NASA"
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "facebook",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 2283,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "profile",
      "id": "100044561550831",
      "url": "https://www.facebook.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/facebook/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 Facebook doesn't show is null, never zero or an empty string, so a real zero always means zero.
- ### What it accepts

  The Facebook profile (a Page's or a person's): its vanity name (NASA, case-insensitive), its numeric profile ID or Page ID, or any link to it: facebook.com/\<name> with any tab after it, profile.php?id=…, /people/\<name>/\<id>, /p/\<name>-\<id>, /pages/category/…, fb.me/\<name>.
- ### Write one parser

  Facebook, TikTok, Instagram 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 Facebook Engagement API.

- ### Vet a Page before a campaign
- ### Compare engagement across a shortlist of Pages
- ### Track a Page's engagement rate and posting cadence
- ### Find a Page's best and worst recent posts

## Good to know before you build.

- The figures cover the few latest posts Facebook's logged-out timeline serves, the first page of the Facebook Profile Posts API: a small sample, counted in metrics.sampled_post_count.
- The profile and each post are exactly what the Facebook Profile API and the Facebook Profile Posts API return.
- Engagement rate counts likes (every reaction) plus comments, per follower and per view, so it means the same on every platform. Shares are exact on Facebook and averaged on their own, in shares_per_post.
- A plain person's profile shows no follower count logged out, so the per-follower rates are null there while the per-post averages remain.
- The pinned post is left out unless its date brings it into the timeline, and so is a post another account published on the profile.
- View counts exist for videos and reels only, so views per post and the per-view rate cover only those posts.
- A profile Facebook shows nothing of logged out (not public, deactivated, age-restricted like an alcohol brand's Page, or an unknown name) returns private_or_unavailable, because Facebook answers them all the same way.
- If the posts can't be read, the profile still answers, with a partial_data warning naming the figures left null.

## 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/facebook/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 Facebook Engagement API.

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

**How is the engagement rate computed?**

For each counted post, likes (every reaction) plus comments over the profile's follower count. metrics.engagement_rate is the mean over the posts with both counts, beside its median and spread. view_engagement_rate is the same interactions over the post's views, for videos and reels.

**How much does the Facebook 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`)
- [Instagram Engagement API](https://socialtap.dev/apis/instagram/engagement/index.md) (1 credit · `GET /v1/instagram/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 Facebook

## Facebook API. 14 endpoints, one key.

- [Facebook Post API](https://socialtap.dev/apis/facebook/post/index.md) (1 credit · `GET /v1/facebook/post`)
- [Facebook Reels API](https://socialtap.dev/apis/facebook/reels/index.md) (1 credit / page · `GET /v1/facebook/reels`)
- [Facebook Group Posts API](https://socialtap.dev/apis/facebook/group_posts/index.md) (1 credit / page · `GET /v1/facebook/group_posts`)
- [Facebook Profile Posts API](https://socialtap.dev/apis/facebook/posts/index.md) (1 credit / page · `GET /v1/facebook/posts`)
- [Facebook Profile Photos API](https://socialtap.dev/apis/facebook/photos/index.md) (1 credit / page · `GET /v1/facebook/photos`)
- [Facebook Profile API](https://socialtap.dev/apis/facebook/profile/index.md) (1 credit · `GET /v1/facebook/profile`)
- [Facebook Comments API](https://socialtap.dev/apis/facebook/comments/index.md) (1 credit / page · `GET /v1/facebook/comments`)
- [Facebook Comment Replies API](https://socialtap.dev/apis/facebook/replies/index.md) (1 credit / page · `GET /v1/facebook/replies`)
- [Facebook Video Transcript API](https://socialtap.dev/apis/facebook/transcript/index.md) (From 1 credit · `GET /v1/facebook/transcript`)
- [Facebook Post Search API](https://socialtap.dev/apis/facebook/search_posts/index.md) (From 1 credit / page · `GET /v1/facebook/search_posts`)
- [Facebook Group Search API](https://socialtap.dev/apis/facebook/search_groups/index.md) (From 1 credit / page · `GET /v1/facebook/search_groups`)
- [Facebook Page and People Search API](https://socialtap.dev/apis/facebook/search_profiles/index.md) (From 1 credit / page · `GET /v1/facebook/search_profiles`)
- [Facebook Group API](https://socialtap.dev/apis/facebook/group/index.md) (1 credit · `GET /v1/facebook/group`)

## 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/facebook/engagement/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
