KOLens documentation — user manual & developer hub
KOLens is a multi-platform influencer intelligence tool: keyword discovery on TikTok, Instagram, X and Douyin, engagement metrics computed from real videos, automatic contact extraction, fit-ranked lists, change-digest monitoring, campaign video tracking and AI-drafted outreach — usable from the web app, the REST API, or directly from Claude via MCP. This manual covers every feature: what it does, how to use it, typical scenarios and advanced workflows.
Getting started
From sign-up to your first contactable shortlist in 5 minutes.
Core features
Every surface of the product: what it does, how to use it, where it pays off.
Discovery
How KOLens keyword discovery works: live TikTok, Instagram, X and Douyin search, automatic email extraction, engagement metrics from real videos, Excel export.
Discovery plans
Set up KOLens discovery plans: schedule recurring keyword searches on TikTok, Instagram, X or Douyin and auto-feed new creators into a KOL list.
Creator profiles
Inside a KOLens creator dossier: engagement metrics from real videos, authenticity (fake-follower) score, audience snapshot, price estimate and contacts.
KOL lists
KOLens KOL lists: fit scores, red flags, triage states, price rollups and CRM status in one payload — how to build and triage an influencer shortlist.
Watchlist & alerts
KOLens watchlist and growth alerts: significance-ranked change digest, 7d/30d deltas, rising-creator and trending-video detection with tunable thresholds.
Video tracking
Track sponsored TikTok videos and Instagram reels with KOLens: scheduled metric snapshots, growth velocity, comment sentiment, and own-vs-competitor comparison.
Outreach & CRM
KOLens outreach & CRM: auto-harvested creator emails, AI-drafted personalized outreach, conversation pipeline stages, event timelines and follow-up tasks.
Workspaces
KOLens team workspaces: member roles and invitations, personal/team data scope, shared brand profile for AI, pooled credits and workspace billing.
Credits & billing
KOLens pricing explained: credit packs from $0.99, what costs credits vs what's free, pre-charge and auto-refund mechanics, workspace pools and usage reports.
Developers & AI agents
REST API, the hosted MCP server for Claude, and the Cowork plugin with skills.
REST API
KOLens influencer marketing API: REST endpoints for TikTok creator search, profile data, lists, watchlist, video tracking and CRM. Bearer auth, pay-as-you-go.
MCP for AI agents
Connect Claude and AI agents to KOLens via MCP: hosted server at kolens.ai/mcp, OAuth 2.1 or API-key auth, 26 tools for influencer discovery, vetting, monitoring and outreach.
Cowork plugin & skills
Install the KOLens plugin for Claude Cowork: stdio MCP server, the kol-research skill and /kol-search command — natural-language creator research with your API key.
Frequently asked questions
What is KOLens?
KOLens is an influencer intelligence platform for brands, agencies and cross-border e-commerce teams. It discovers creators by keyword on TikTok, Instagram, X and Douyin, computes engagement metrics from their actual videos, extracts contact emails from bio links, and manages shortlists, monitoring, outreach and campaign tracking — with the same workflow exposed to AI agents over MCP.
How much does KOLens cost?
Pay-as-you-go credits with no subscription: 1 credit ≈ 10 scraped results, packs from $0.99 (Trial, 5 credits) to $400 (Pro, 500 credits) at $0.80/credit, and credits never expire. Reading collected data — profiles, lists, watchlist digests, alerts — is always free.
Can I use KOLens from Claude?
Yes — add https://kolens.ai/mcp as a custom connector in Claude.ai (or via `claude mcp add` in Claude Code) and Claude gets 26 tools covering discovery, vetting, lists, monitoring, tracking and outreach drafting. Cowork users can install the bundled plugin instead.
Which platforms does KOLens support?
TikTok (keyword + region targeting, dossiers, audience snapshots, video tracking), Instagram (hashtag discovery, reel tracking), X/Twitter (keyword discovery) and Douyin (native Chinese keyword search).
Ready to try it on real data?
Everything in this manual works on a free account — the homepage demo search doesn't even need one. Your first search takes about 5 minutes.
Get started