KOLens Monitoring API

The Monitoring API from KOLens — 3 operation(s) for monitoring.

GitHub OpenAPI

Operations 4

POST /api/lists/{list_id}/monitoring Toggle List Monitoring #
GET /api/lists/{list_id}/monitoring Get List Monitoring Status #
POST /api/kols/{username}/snapshot Create Manual Snapshot #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kolens-ai:kolens-ai-monitoring-api"
All apis
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.

Get an API 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 Specification

kolens-ai-monitoring-api-openapi.yml Raw ↑
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