API Reference

Facebook endpoints

Page, post and video metrics from public Facebook URLs.

All 3 endpoints below take a single url parameter and return the same field vocabulary used across every platform. A full object costs 2 credits; a single field costs 1.
GET /api/v1/facebook/page
2 credits cache 1m

Facebook page

Follower and page like counts for a Facebook page.

Parameters

url required
Example: https://www.facebook.com/pagename
field optional
Return a single value for 1 credit instead of 2.

Fields

pageId · legacyPageId · username · displayName · followers · likes

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/facebook/page?url=https%3A%2F%2Fwww.facebook.com%2Fpagename"
GET /api/v1/facebook/post
2 credits cache 1m

Facebook post

Reaction, comment and share counts for a Facebook post.

Parameters

url required
Example: https://www.facebook.com/pagename/posts/POST_ID
field optional
Return a single value for 1 credit instead of 2.

Fields

postId · pfbid · authorId · legacyPageId · authorUsername · authorName · reactions · likes · reactionBreakdown · comments · shares

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Fpagename%2Fposts%2FPOST_ID"
GET /api/v1/facebook/video
2 credits cache 1m

Facebook video

View, reaction and comment counts for a Facebook video.

Parameters

url required
Example: https://www.facebook.com/watch/?v=VIDEO_ID
field optional
Return a single value for 1 credit instead of 2.

Fields

videoId · authorId · legacyPageId · authorUsername · authorName · views · viewsAlt · reactions · comments · shares

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/facebook/video?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3DVIDEO_ID"