tubestat

API Reference

Instagram endpoints

Profile and media metrics, plus content listing and follow graph endpoints. These endpoints depend on an authenticated source pool and can be slower than the rest of the catalogue.

All 4 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/instagram/profile
2 credits cache 1m

Instagram profile

Follower, following and post counts for an Instagram account.

Parameters

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

Fields

userId · username · followers · following · posts · private

Example request

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

Instagram post

Like, comment and view counts for an Instagram post, reel or TV item.

Parameters

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

Fields

mediaId · shortcode · authorUsername · authorId · likes · comments · views · mediaType · reposts

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/instagram/media?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FSHORTCODE%2F"
GET /api/v1/instagram/content-list
2 credits cache 1m

Instagram content list

Recent posts and reels for an account with per-item status. Returns a list, not a counter - responses are slower than the counter endpoints.

Parameters

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

Fields

username · userId · items · status · postStatus · reelsStatus · skipped · retried · enriched

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/instagram/content-list?url=https%3A%2F%2Fwww.instagram.com%2Fusername"
GET /api/v1/instagram/follow-graph
2 credits cache 1m

Instagram follow graph

Follower and following lists for an account, plus who does not follow back. Slowest endpoint in the catalogue - allow a long client timeout.

Parameters

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

Fields

username · followersList · followingList · followersStatus · followingStatus · notFollowingBack · notFollowedBack · followers · following

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/instagram/follow-graph?url=https%3A%2F%2Fwww.instagram.com%2Fusername"