Introducing the Instagram APIRead more →
Sign inStart for freeDashboard

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

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
  • 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
GET /v1/facebook/engagementTry in
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);
200 OK · GET https://socialtap.dev/v1/facebook/engagementLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 6 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

  • 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.

platformstring
Platform ID (tiktok, instagram, …).
idstring
Platform-native account ID (equals profile.id).
urlstring
Canonical profile URL (equals profile.url).
profileobject
The account, as its profile endpoint returns it; its metrics.follower_count divides every engagement_rate.
postsobject[]
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).
metricsobject
Figures over the counted posts (by the account, not pinned); each null when no counted post has its inputs.
oldest_post_atstring
Publish time of the oldest counted post, RFC 3339 UTC: where the sample starts.
newest_post_atstring
Publish time of the newest counted post, RFC 3339 UTC: when the account last posted.

Live data from 33 platforms.

TikTokInstagramFacebookYouTubeRedditThreadsSpotifyAmazonApple MusicPinterestRumbleXBlueskyTwitchLinkedInTelegramTikTok ShopKwaiSnapchatSoundCloudTruth SocialKickKomiLnk.BioLinkmeLinktreePillarTikTok Ad LibraryFacebook Ad LibraryFacebook EventsFacebook MarketplaceGoogle Ads Transparency CenterLinkedIn Ad Library

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 packsHow this endpoint is pricedHow credits work

SourcePrice per successful requestPer 1,000 requests
Any source1 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.

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.

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 Read the docs