KOLens Monitoring API
The Monitoring API from KOLens — 3 operation(s) for monitoring.
The Monitoring API from KOLens — 3 operation(s) for monitoring.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/kolens-ai:kolens-ai-monitoring-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: KOLens Monitoring API
description: KOLens — TikTok KOL Intelligence API. Search keywords, extract KOL profiles, collect contact info, export reports.
version: 1.0.0
tags:
- name: Monitoring
paths:
/api/lists/{list_id}/monitoring:
post:
tags:
- Monitoring
summary: Toggle List Monitoring
description: 'Enable or disable daily monitoring for a KOL list.
When enabled, all KOLs in this list will have daily snapshots created
automatically at 2 AM UTC via Celery beat scheduler.'
operationId: toggle_list_monitoring_api_lists__list_id__monitoring_post
security:
- HTTPBearer: []
parameters:
- name: list_id
in: path
required: true
schema:
type: string
title: List Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EnableMonitoringRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringStatusResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- Monitoring
summary: Get List Monitoring Status
description: Get monitoring status for a KOL list.
operationId: get_list_monitoring_status_api_lists__list_id__monitoring_get
security:
- HTTPBearer: []
parameters:
- name: list_id
in: path
required: true
schema:
type: string
title: List Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringStatusResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/kols/{username}/snapshot:
post:
tags:
- Monitoring
summary: Create Manual Snapshot
description: 'Manually create a snapshot for a KOL.
This is useful for testing or creating snapshots on-demand
outside of the daily automated schedule.'
operationId: create_manual_snapshot_api_kols__username__snapshot_post
security:
- HTTPBearer: []
parameters:
- name: username
in: path
required: true
schema:
type: string
title: Username
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SnapshotResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/kols/{username}/trends:
get:
tags:
- Monitoring
summary: Get Kol Growth Trends
description: 'Get growth trends for a KOL over the specified period.
Args:
username: KOL username
days: Number of days to analyze (30, 90, or 365)
Returns:
Growth metrics including follower growth rate, views growth, and ER change'
operationId: get_kol_growth_trends_api_kols__username__trends_get
security:
- HTTPBearer: []
parameters:
- name: username
in: path
required: true
schema:
type: string
title: Username
- name: days
in: query
required: false
schema:
type: integer
default: 30
title: Days
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GrowthTrendsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
MonitoringStatusResponse:
properties:
list_id:
type: string
title: List Id
list_name:
type: string
title: List Name
enable_daily_monitoring:
type: boolean
title: Enable Daily Monitoring
last_snapshot_at:
anyOf:
- type: string
- type: 'null'
title: Last Snapshot At
type: object
required:
- list_id
- list_name
- enable_daily_monitoring
- last_snapshot_at
title: MonitoringStatusResponse
GrowthTrendsResponse:
properties:
username:
type: string
title: Username
days:
type: integer
title: Days
follower_growth_rate:
type: number
title: Follower Growth Rate
avg_views_growth_rate:
type: number
title: Avg Views Growth Rate
engagement_rate_change:
type: number
title: Engagement Rate Change
snapshots_count:
type: integer
title: Snapshots Count
type: object
required:
- username
- days
- follower_growth_rate
- avg_views_growth_rate
- engagement_rate_change
- snapshots_count
title: GrowthTrendsResponse
SnapshotResponse:
properties:
username:
type: string
title: Username
snapshot_created:
type: boolean
title: Snapshot Created
type: object
required:
- username
- snapshot_created
title: SnapshotResponse
EnableMonitoringRequest:
properties:
enable:
type: boolean
title: Enable
type: object
required:
- enable
title: EnableMonitoringRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer