tubestat

API Reference

YouTube endpoints

Channel, video, comment and community post metrics. Point any public YouTube URL at the matching endpoint and get the counters back as JSON.

All 6 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/youtube/channel
2 credits cache 1m

Channel statistics

Subscriber, video and view counts for a YouTube channel, plus channel ID, title and handle.

Parameters

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

Fields

channelId · title · handle · followers · videos · views

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/youtube/channel?url=https%3A%2F%2Fwww.youtube.com%2F%40channelname"
GET /api/v1/youtube/video
2 credits cache 1m

Video statistics

View, like and comment counts for a YouTube video, plus duration, publish date and privacy state.

Parameters

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

Fields

videoId · channelId · title · publishedAt · durationMs · views · likes · comments · visibility · liveStatus

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/youtube/video?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DVIDEO_ID"
GET /api/v1/youtube/community-post
2 credits cache 1m

Community post

Like and comment counts for a YouTube community post, including poll totals and options when the post contains a poll.

Parameters

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

Fields

postId · channelId · likes · pollTotalVotes · hasPoll · pollOptions · comments

Example request

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

Comment

Like and reply counts for a single YouTube comment.

Parameters

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

Fields

videoId · commentId · authorChannelId · likes · replies

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/youtube/comment?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DVIDEO_ID%26lc%3DCOMMENT_ID"
GET /api/v1/youtube/comment-reply
2 credits cache 1m

Comment reply

Like count for a reply to a YouTube comment.

Parameters

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

Fields

videoId · replyId · parentCommentId · authorChannelId · likes

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/youtube/comment-reply?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DVIDEO_ID%26lc%3DCOMMENT_ID.REPLY_ID"
GET /api/v1/youtube/community-comment
2 credits cache 1m

Community post comment

Like and reply counts for a comment on a YouTube community post.

Parameters

url required
Example: https://www.youtube.com/post/POST_ID?lc=COMMENT_ID
field optional
Return a single value for 1 credit instead of 2.

Fields

postId · commentId · authorChannelId · likes · replies

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/youtube/community-comment?url=https%3A%2F%2Fwww.youtube.com%2Fpost%2FPOST_ID%3Flc%3DCOMMENT_ID"