KOLens Sync API

The Sync API from KOLens — 3 operation(s) for sync.

GitHub OpenAPI

Operations 3

POST /api/sync/feishu/{list_id} Sync To Feishu #
GET /api/lists/{list_id}/export Export List Excel #
POST /api/sync/gsheets/{list_id} Sync To Gsheets #

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-sync-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-sync-api-openapi.yml Raw ↑
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