KOLens Sync API
The Sync API from KOLens — 3 operation(s) for sync.
The Sync API from KOLens — 3 operation(s) for sync.
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-sync-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 Sync API
description: KOLens — TikTok KOL Intelligence API. Search keywords, extract KOL profiles, collect contact info, export reports.
version: 1.0.0
tags:
- name: Sync
paths:
/api/sync/feishu/{list_id}:
post:
tags:
- Sync
summary: Sync To Feishu
description: 'Export a KOL list to Feishu Bitable.
Behaviour:
- If no ``app_token`` is provided a brand-new Bitable is created and its
URL is returned so you can open it directly.
- If ``app_token`` (and optionally ``table_id``) are provided the records
are appended to that existing Bitable / table.
- Each KOL becomes one row: username, stats, tier, price estimate,
outreach status, contact info (email / IG / YouTube / website), and
growth trend.
Requires ``FEISHU_APP_ID`` and ``FEISHU_APP_SECRET`` to be set in the
KOLens API environment (obtain from https://open.feishu.cn/app — enable
scopes ``bitable:app:create`` and ``bitable:record:write``).'
operationId: sync_to_feishu_api_sync_feishu__list_id__post
security:
- HTTPBearer: []
parameters:
- name: list_id
in: path
required: true
schema:
type: string
title: List Id
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/FeishuSyncBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/FeishuSyncResult'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/lists/{list_id}/export:
get:
tags:
- Sync
summary: Export List Excel
description: 'Download a KOL list as an Excel (.xlsx) file.
No external services required — generated server-side with openpyxl.
The file can be opened directly in Excel or imported into Google Sheets.'
operationId: export_list_excel_api_lists__list_id__export_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: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/sync/gsheets/{list_id}:
post:
tags:
- Sync
summary: Sync To Gsheets
description: 'Export a KOL list to a new Google Sheet.
Creates a spreadsheet in the service account''s Drive, writes all KOL
members as rows with headers, freezes the header row, and optionally
shares the sheet with the caller''s email.
Requires ``GOOGLE_SA_JSON`` to be set in the KOLens API environment
(the full JSON contents of a Google service account key file).
The service account must have the Google Sheets API and Google Drive
API enabled in its project.'
operationId: sync_to_gsheets_api_sync_gsheets__list_id__post
security:
- HTTPBearer: []
parameters:
- name: list_id
in: path
required: true
schema:
type: string
title: List Id
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GSheetsSyncBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GSheetsSyncResult'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
FeishuSyncResult:
properties:
list_id:
type: string
title: List Id
list_name:
type: string
title: List Name
bitable_url:
type: string
title: Bitable Url
app_token:
type: string
title: App Token
table_id:
type: string
title: Table Id
synced:
type: integer
title: Synced
type: object
required:
- list_id
- list_name
- bitable_url
- app_token
- table_id
- synced
title: FeishuSyncResult
GSheetsSyncBody:
properties:
title:
anyOf:
- type: string
- type: 'null'
title: Title
share_with:
anyOf:
- type: string
- type: 'null'
title: Share With
type: object
title: GSheetsSyncBody
description: Optional body for Google Sheets sync.
FeishuSyncBody:
properties:
bitable_name:
anyOf:
- type: string
- type: 'null'
title: Bitable Name
app_token:
anyOf:
- type: string
- type: 'null'
title: App Token
table_id:
anyOf:
- type: string
- type: 'null'
title: Table Id
type: object
title: FeishuSyncBody
description: Optional body for Feishu sync — omit to auto-create a fresh Bitable.
GSheetsSyncResult:
properties:
list_id:
type: string
title: List Id
list_name:
type: string
title: List Name
spreadsheet_url:
type: string
title: Spreadsheet Url
spreadsheet_id:
type: string
title: Spreadsheet Id
synced:
type: integer
title: Synced
type: object
required:
- list_id
- list_name
- spreadsheet_url
- spreadsheet_id
- synced
title: GSheetsSyncResult
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