Architecture & APIs
CreatorHub is a data platform first. This is how creator data flows from messy sources to client-ready insights — and the APIs that expose it.
Data flow
Every box is an independently scalable service
- CSV / Excel importsLegacy agency sheets
- Instagram Graph APIBusiness discovery
- YouTube Data APIChannels & videos
- Data vendorsAudience, authenticity
- Column mappingSynonym + ML matching
- NormalisationPhones, cities, handles
- Dedupe engineFuzzy entity resolution
- PostgreSQLMaster creator records
- Time-series metricsDaily snapshots
- OpenSearchFaceted search index
- Enrichment workersQueue + rate limiting
- Scoring serviceConfigurable weights
- LLM layerNL search, summaries
- REST APIVersioned, documented
- RBAC + field rulesPer-role redaction
- Agency app & portalNext.js
1M+
Creator profiles supported
< 300ms
p95 search latency
Nightly
Re-enrichment of active creators
Field-level
Client data redaction
Core data model
One creator, many platform accounts, full metric history
Creator
- id
- name, gender, city, tier
- languages[], niches[]
- authenticity, reliability
has many PlatformAccounts
PlatformAccount
- creator_id
- platform, handle
- followers, avg_views
- engagement_rate
has many MetricSnapshots
MetricSnapshot
- account_id, date
- followers, views
- engagement, source
time-series
Campaign
- client_id, name
- budget, dates
- objective, status
has many CampaignCreators
CampaignCreator
- campaign_id, creator_id
- stage, fee
- approval
has many Deliverables
Deliverable
- type, due
- status, post_url
- views, likes, shares
→ performance
Client
- name, industry
- branding
- visibility_rules
has many Users
ImportJob
- file, mapping
- stats, decisions
- audit log
→ Creator lineage
API reference
REST, versioned, OAuth2 + API keys. Click an endpoint for sample payloads.
Creators
Imports
Campaigns
Client portal
Delivery roadmap
Phased so the agency gets value from week one
Data foundation
- Import, clean & dedupe
- Master creator database
- Search, filters, shortlists
Intelligence
- Instagram / YouTube enrichment
- Scoring & ranking
- Creator history & rates
Activation & clients
- Campaign management
- Reporting & exports
- Client portal + privacy controls