KOLens Scheduled Tasks API
The Scheduled Tasks API from KOLens — 5 operation(s) for scheduled tasks.
The Scheduled Tasks API from KOLens — 5 operation(s) for scheduled tasks.
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-scheduled-tasks-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 Scheduled Tasks API
description: KOLens — TikTok KOL Intelligence API. Search keywords, extract KOL profiles, collect contact info, export reports.
version: 1.0.0
tags:
- name: Scheduled Tasks
paths:
/admin/scheduled/daily-snapshot:
post:
tags:
- Scheduled Tasks
summary: Trigger Daily Snapshot
description: 'Fire the daily KOL snapshot task (Fly Scheduled Machine primary trigger).
Returns immediately; the actual work (iterating monitored lists,
creating ``KOLSnapshot`` rows) runs as a ``BackgroundTask`` so a
slow sweep can''t time out the caller''s fetch.'
operationId: trigger_daily_snapshot_admin_scheduled_daily_snapshot_post
parameters:
- name: source
in: query
required: false
schema:
type: string
default: external
title: Source
- name: x-admin-secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Admin-Secret
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Trigger Daily Snapshot Admin Scheduled Daily Snapshot Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/scheduled/daily-activity-summary:
post:
tags:
- Scheduled Tasks
summary: Trigger Daily Activity Summary
description: Fire the daily watchlist activity-summary refresh.
operationId: trigger_daily_activity_summary_admin_scheduled_daily_activity_summary_post
parameters:
- name: source
in: query
required: false
schema:
type: string
default: external
title: Source
- name: x-admin-secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Admin-Secret
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Trigger Daily Activity Summary Admin Scheduled Daily Activity Summary Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/scheduled/refresh-stale-creators:
post:
tags:
- Scheduled Tasks
summary: Trigger Refresh Stale Creators
description: 'Fire the daily recovery sweep — re-scrape TikTok creators whose
media-cache jobs have exhausted MAX_ATTEMPTS (raw URLs already
expired, can''t be fetched by ``avatar_cache`` / ``thumbnail_cache``).
See ``api/services/refresh_stale_creators.py`` for the picker and
cost rationale; the recommended Fly schedule is daily 04:00 UTC.'
operationId: trigger_refresh_stale_creators_admin_scheduled_refresh_stale_creators_post
parameters:
- name: source
in: query
required: false
schema:
type: string
default: external
title: Source
- name: x-admin-secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Admin-Secret
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Trigger Refresh Stale Creators Admin Scheduled Refresh Stale Creators Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/scheduled/refresh-country-rankings:
post:
tags:
- Scheduled Tasks
summary: Trigger Refresh Country Rankings
description: 'Fire the daily country-board sweep behind the public ``/rankings``
pages — rebuilds the stalest few markets, never-built ones first.
Distinct from ``POST /admin/rankings/refresh``, which rebuilds
exactly what an operator names and is the right tool for "rebuild TW
right now". This one is the unattended schedule that stops the
boards going stale in the first place; see
``api/services/rankings_sweep.py`` for the picker and budget, and
``docs/scheduler.md`` for where it sits. Recommended Fly schedule is
daily 05:00 UTC.'
operationId: trigger_refresh_country_rankings_admin_scheduled_refresh_country_rankings_post
parameters:
- name: source
in: query
required: false
schema:
type: string
default: external
title: Source
- name: x-admin-secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Admin-Secret
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Trigger Refresh Country Rankings Admin Scheduled Refresh Country Rankings Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/admin/scheduled/runs:
get:
tags:
- Scheduled Tasks
summary: List Recent Runs
description: 'Operator dashboard support — most-recent run records.
Returns the ``scheduled_task_runs`` rows newest-first. Optional
``task`` query param scopes to a single task name. When
``include_aggregates=true`` the response also embeds a 30-day
spend rollup the admin UI uses to render the "30-day spend" tile —
summing ``summary.credits_spent`` across every task whose summary
carries that key. Computed in-process; the row count is bounded
by ~30 days × ~5 daily tasks so a SELECT scan is fine.'
operationId: list_recent_runs_admin_scheduled_runs_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 20
title: Limit
- name: task
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Task
- name: include_aggregates
in: query
required: false
schema:
type: boolean
default: false
title: Include Aggregates
- name: x-admin-secret
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Admin-Secret
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response List Recent Runs Admin Scheduled Runs Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
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