Introducing the Instagram APIRead more →
Sign inStart for freeDashboard

YouTube Engagement API. Send a handle or channel link.

Views per upload, cadence and outlier videos. We handle the proxies, blocks and platform changes.

Get API key

YouTube Engagement API at a glance

Returns a YouTube channel's views per upload, median views and posting cadence, computed over its latest videos or shorts, in one request. You also get the channel's profile, each upload with its counts and how its views compare with the channel's typical upload, likes per upload where YouTube shows them, and the newest and oldest upload in the sample. Accepts a handle, any channel link or a channel ID.

GET /v1/youtube/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/youtube/engagementTry in
const params = new URLSearchParams({
  handle: "@MrBeast",
  tab: "shorts",
});
const res = await fetch(`https://socialtap.dev/v1/youtube/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/youtube/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 YouTube doesn't show is null, never zero or an empty string, so a real zero always means zero.

  • What it accepts

    YouTube channel: a handle with or without the @ (NASA, @NASA), any channel link (youtube.com/@NASA, youtube.com/channel/UC…, the legacy youtube.com/c/<name>, youtube.com/user/<name> and youtube.com/<name> links, with any tab or view after them, and m. or music. hosts), a bare UC… channel ID, or c/<name>, user/<name> or vanity/<name>.

  • Write one parser

    YouTube, 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 YouTube Engagement API.

  • Vet a creator's typical views before a deal

  • Compare channels on median views

  • Track posting cadence and view trends

  • Spot a channel's outlier videos or shorts

Good to know before you build.

  • The figures cover the channel's latest uploads, the first page of its videos or shorts tab. The profile and each upload are exactly what the YouTube Channel API and the YouTube Channel Videos API return.
  • YouTube's channel lists show no comment counts, so the engagement rates (likes plus comments, per subscriber and per view), interactions, the comment-to-like ratio and the top and bottom post are null on YouTube. Comment counts per video come from the YouTube Video API.
  • Likes and exact upload times come from YouTube's uploads feed, which lists the newest uploads only, and likes_per_post averages those. Beyond them views are rounded and upload times are relative ("3 weeks ago") or, on the shorts tab, absent, so figures computed from them are listed in approximate_fields and cadence covers the uploads with a time.
  • When the uploads feed does not answer, a partial_data warning names the fields left null.
  • A channel that hides its subscriber count has profile.metrics.follower_count null.
  • A channel without uploads in the tab returns its profile with posts [] and every figure 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 YouTube Engagement API.

More in the API reference.

How much does the YouTube 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