project creatortrack social multiplatform expansion 20260715T152519
name: CreatorTrack social data: TikTok/IG/FB expansion plan (Phase 2, not yet connected) description: Decision on sequencing + technical constraints for adding TikTok/Instagram/Facebook to CreatorTrack's social data layer (currently YouTube-only) type: project
Justin asked about pulling TikTok/Instagram/Facebook data (reach/retention) for cross-posted videos (starting with Gus the Bass channel), to complement the YouTube-only social data layer already shipped.
Current state (as of 2026-07-15): connect flows, token refresh, and paginated fetchers for all three platforms already exist in code (from Tasks 2/7 of the social-data-layer branch), but are untested against live tokens because no account has ever been connected. The credentials file the code expects, ~/.forge-secrets/creatortrack-social.env, does not exist yet.
Setup path decided: - Facebook + Instagram: one Meta app at developers.facebook.com under Justin's Meta Business account covers both (IG must be Creator/Business, linked to the FB Page). Because Justin would be the app's own admin connecting his own accounts, no Meta app review is required — review only applies when other CreatorTrack users connect their own accounts. - TikTok: app at developers.tiktok.com, Login Kit, sandbox mode with Gus as test user. Gets video list/views/likes/comments/shares, but TikTok's basic API has no retention/watch-time data — that requires TikTok's Business API tier with a real audit.
Cross-platform linking: schema already reserves social_videos.script_id for grouping one canonical piece of content across N platform posts (cross-posts on different days was always an assumed case, not a gap). Planned matching approach: auto-match on duration+title similarity+publish-date proximity for the easy majority, embedding-based cosine match (via the Task 15 YouTube embeddings) for the rest, small human review queue for ambiguous ties.
Sequencing decision: this multiplatform work is explicitly deferred to a Phase 2 after the current in-flight branch (feat/social-data-layer-and-scripts) ships. Justin's only two required human steps when that phase starts: create the Meta app and the TikTok app (~20 min walkthrough each).
Why: avoids scope creep on a branch that's mid-flight and converging; keeps the multiplatform build from blocking the YouTube pipeline ship.
How to apply: when this Phase 2 work resumes, check whether ~/.forge-secrets/creatortrack-social.env now exists before assuming platforms are still disconnected; don't re-litigate the Meta-review-not-needed or TikTok-retention-gap facts, they were already researched.
[auto-memory session 60d132de-4659-485c-8044-427af0ccce7f, confidence 0.72, mode staged]