Integrations

ViewsBase tracks TikTok and Instagram posts for internal creators and competitor/reference monitoring. Discord is optional and is used for creator self-submission.

Refresh Schedule

Active tracked posts refresh every 6 hours.

Watched accounts are also checked on the 6-hour schedule. Recently finalized and paid posts can continue refreshing for analytics, but finalized payable views remain frozen.

TikTok

TikTok tracking supports internal creator posts, competitor/reference posts, and watched accounts.

What Gets Tracked

ViewsBase fetches:

• Views
• Likes
• Comments
• Shares
• Post URL and platform post ID
• Source author handle and display name when available
• Source avatar, thumbnail, and caption when available

How TikTok Posts Are Added

TikTok posts can enter a campaign through:

• Discord /submit-post for registered internal creators
• Posts -> Track Videos for internal creator URLs
• Intelligence -> Track Video for competitor/reference URLs
• Watch Account for optional account-level discovery

Internal posts must match an active campaign creator. Competitor/reference posts do not require a creator record.

TikTok Watched Accounts

When watching a TikTok account, choose an initial import:

• No recent posts
• Last 5 posts
• Last 10 posts
• Last 15 posts
• Last 30 posts

After that, the account is checked every 6 hours unless paused.

Instagram

Instagram tracking supports internal creator posts, competitor/reference posts, and watched accounts.

What Gets Tracked

ViewsBase fetches:

• Views when available
• Likes
• Comments
• Post URL and shortcode
• Source author handle and display name when available
• Source avatar, thumbnail, and caption when available

Instagram does not provide the same public engagement surface as TikTok, so shares are not tracked.

Reels vs Slideshows

Watched Instagram accounts import Reels only. Slideshows and multi-image posts can lack public view counts, so they are not auto-watched.

If a tracked Instagram post has no public views, admins can enter manual views only when platform views are unavailable. Manual view updates require an audit note.

Discord Bot

The Discord bot lets registered internal creators submit their own posts with /submit-post.

The bot:

• Checks the campaign/server allowlist
• Extracts the platform handle from the post
• Verifies that the creator is active in the campaign
• Rejects submissions from unknown or paused creators
• Creates the post in Posts with fetched stats when available

See Discord Bot for setup and command details.

Internal vs Competitor Tracking

Error Handling

Platform tracking can fail when a post is private, deleted, malformed, rate-limited, or unavailable from the provider.

ViewsBase handles these failures at the affected row or account:

• Other rows in the same bulk tracking request can still succeed
• Failed video stat fetches show retry actions
• Failed watched account syncs show the account error and keep the account saved
• Paused watched accounts are not synced until resumed

Automatic Lifecycle Actions

Internal creator posts follow the Video Lifecycle:

• Active posts refresh during the counting window
• Posts under the auto-reject minimum can be rejected after the window
• Posts with complete terms can finalize
• Posts without complete terms move to Pending CPM
• Finalized payable views are frozen

Competitor/reference posts refresh for intelligence only and do not enter the payment lifecycle.