KOLens Activity API
The Activity API from KOLens — 3 operation(s) for activity.
The Activity API from KOLens — 3 operation(s) for activity.
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-activity-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 Activity API
description: KOLens — TikTok KOL Intelligence API. Search keywords, extract KOL profiles, collect contact info, export reports.
version: 1.0.0
tags:
- name: Activity
paths:
/api/activity:
get:
tags:
- Activity
summary: List Activity
description: 'Return the workspace''s activity feed, newest first.
``unseen_count`` in the response is the *workspace-wide* unseen
total — independent of the current filter set — so the sidebar
badge stays accurate even when the user is viewing a filtered slice.'
operationId: list_activity_api_activity_get
security:
- HTTPBearer: []
parameters:
- name: since
in: query
required: false
schema:
anyOf:
- type: string
format: date-time
- type: 'null'
description: Only events created >= this ISO8601 timestamp
title: Since
description: Only events created >= this ISO8601 timestamp
- name: kinds
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: CSV of event kinds to include
title: Kinds
description: CSV of event kinds to include
- name: limit
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 50
title: Limit
- name: unseen_only
in: query
required: false
schema:
type: boolean
default: false
title: Unseen Only
- name: x-kolens-user-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-User-Id
- name: x-kolens-workspace-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-Workspace-Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response List Activity Api Activity Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/activity/mark-seen:
post:
tags:
- Activity
summary: Mark Seen
description: 'Bulk mark events as seen.
Modes:
- ``event_ids`` — exact-match IDs scoped to this workspace.
- ``all_before`` — every workspace row created <= cutoff that''s
still unseen.
Returns the count of rows actually flipped. Already-seen rows are
NOT re-stamped — keeping the original seen_at preserves the audit
story.'
operationId: mark_seen_api_activity_mark_seen_post
security:
- HTTPBearer: []
parameters:
- name: x-kolens-user-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-User-Id
- name: x-kolens-workspace-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-Workspace-Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MarkSeenRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Mark Seen Api Activity Mark Seen Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/activity/unseen-count:
get:
tags:
- Activity
summary: Unseen Count
description: 'Single integer used by the sidebar badge — polled every 30s
while the tab is visible. Keep cheap (indexed COUNT).'
operationId: unseen_count_api_activity_unseen_count_get
security:
- HTTPBearer: []
parameters:
- name: x-kolens-user-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-User-Id
- name: x-kolens-workspace-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Kolens-Workspace-Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Unseen Count Api Activity Unseen Count Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
MarkSeenRequest:
properties:
event_ids:
anyOf:
- items:
type: string
type: array
maxItems: 500
- type: 'null'
title: Event Ids
all_before:
anyOf:
- type: string
format: date-time
- type: 'null'
title: All Before
type: object
title: MarkSeenRequest
description: 'Bulk mark-seen payload. Exactly one of ``event_ids`` /
``all_before`` should be supplied; passing both raises 400.'
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