KOLens Enrichment API
The Enrichment API from KOLens — 9 operation(s) for enrichment.
The Enrichment API from KOLens — 9 operation(s) for enrichment.
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-enrichment-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 Enrichment API
description: KOLens — TikTok KOL Intelligence API. Search keywords, extract KOL profiles, collect contact info, export reports.
version: 1.0.0
tags:
- name: Enrichment
paths:
/api/kols/{username}/enrich-contact:
post:
tags:
- Enrichment
summary: Enrich Contact
description: 'Find + verify a deliverable business email for a creator.
Pay-for-result: a deliverable email costs
``contact_enrichment_cost_credits`` (default 1); a clean miss or a
cached repeat is free. 402 if the caller can''t cover the cost before
we spend an upstream call.'
operationId: enrich_contact_api_kols__username__enrich_contact_post
security:
- HTTPBearer: []
parameters:
- name: username
in: path
required: true
schema:
type: string
title: Username
- 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:
content:
application/json:
schema:
$ref: '#/components/schemas/Body_enrich_contact_api_kols__username__enrich_contact_post'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/EnrichContactResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/kols/{username}/cross-platform/resolve:
post:
tags:
- Enrichment
summary: Cross Platform Reach
description: 'Resolve a creator''s other-platform profiles and merge them into a
single cross-platform reach view.
The paid sibling of the free ``GET /kols/{username}/cross-platform``
dossier aggregation (which only surfaces pointers we already know):
this POST actively fetches each other-platform profile via Apify and
merges real follower counts. Pay-for-result — charges
``cross_platform_cost_credits`` (default 1) per platform actually
resolved; unresolved platforms never debit; a cached repeat within the
freshness window is free.'
operationId: cross_platform_reach_api_kols__username__cross_platform_resolve_post
security:
- HTTPBearer: []
parameters:
- name: username
in: path
required: true
schema:
type: string
title: Username
- 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:
content:
application/json:
schema:
$ref: '#/components/schemas/CrossPlatformRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CrossPlatformResolveResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/enrich/search:
post:
tags:
- Enrichment
summary: Ic Search
description: 'Search TikTok creators via Influencers Club Discovery API. Costs 0.01 credits/result.
Results are cached for 24 hours. Pass refresh=true to bypass cache.'
operationId: ic_search_api_enrich_search_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ICSearchRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/enrich/tiktok:
post:
tags:
- Enrichment
summary: Enrich Tiktok
description: Full TikTok profile enrichment — email, analytics, audience data. Costs 1 credit.
operationId: enrich_tiktok_api_enrich_tiktok_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EnrichRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/enrich/tiktok/raw:
post:
tags:
- Enrichment
summary: Enrich Tiktok Raw
description: Basic TikTok platform data. Costs 0.03 credits.
operationId: enrich_tiktok_raw_api_enrich_tiktok_raw_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EnrichRawRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/enrich/email:
post:
tags:
- Enrichment
summary: Enrich By Email
description: Find creator by email address. Costs 0.05 credits.
operationId: enrich_by_email_api_enrich_email_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EnrichEmailRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/enrich/socials:
post:
tags:
- Enrichment
summary: Enrich Socials
description: Find cross-platform social accounts for a TikTok user. Costs 0.5 credits.
operationId: enrich_socials_api_enrich_socials_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EnrichSocialsRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/enrich/posts:
post:
tags:
- Enrichment
summary: Enrich Posts
description: Get recent TikTok posts with engagement metrics. Costs 0.03 credits.
operationId: enrich_posts_api_enrich_posts_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/EnrichPostsRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/enrich/credits:
get:
tags:
- Enrichment
summary: Enrich Credits
description: Check remaining Influencers Club API credits.
operationId: enrich_credits_api_enrich_credits_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CreditsResponse'
security:
- HTTPBearer: []
components:
schemas:
CrossPlatformResolveResponse:
properties:
platforms:
items:
type: object
type: array
title: Platforms
reach_total:
anyOf:
- type: integer
- type: 'null'
title: Reach Total
native_followers:
anyOf:
- type: integer
- type: 'null'
title: Native Followers
confidence:
type: string
title: Confidence
cost_credits:
type: integer
title: Cost Credits
cached:
type: boolean
title: Cached
summary:
type: string
title: Summary
risk_flags:
items:
type: string
type: array
title: Risk Flags
default: []
next_actions:
items:
type: string
type: array
title: Next Actions
default: []
type: object
required:
- platforms
- confidence
- cost_credits
- cached
- summary
title: CrossPlatformResolveResponse
EnrichSocialsRequest:
properties:
handle:
type: string
maxLength: 200
minLength: 1
title: Handle
type: object
required:
- handle
title: EnrichSocialsRequest
EnrichEmailRequest:
properties:
email:
type: string
maxLength: 200
minLength: 3
title: Email
type: object
required:
- email
title: EnrichEmailRequest
CrossPlatformRequest:
properties:
platforms:
items:
type: string
type: array
title: Platforms
description: Target platforms to resolve + merge (youtube / facebook / instagram).
force:
type: boolean
title: Force
description: Bypass the cache + re-resolve
default: false
type: object
title: CrossPlatformRequest
Body_enrich_contact_api_kols__username__enrich_contact_post:
properties:
force:
type: boolean
title: Force
description: Bypass the cache + re-run upstream
default: false
type: object
title: Body_enrich_contact_api_kols__username__enrich_contact_post
ICSearchRequest:
properties:
keyword:
type: string
title: Keyword
description: Search keyword or query
default: ''
page:
type: integer
minimum: 1.0
title: Page
default: 1
page_size:
type: integer
maximum: 50.0
minimum: 1.0
title: Page Size
default: 20
followers_min:
anyOf:
- type: integer
- type: 'null'
title: Followers Min
followers_max:
anyOf:
- type: integer
- type: 'null'
title: Followers Max
engagement_rate_min:
anyOf:
- type: number
- type: 'null'
title: Engagement Rate Min
description: Min ER as decimal, e.g. 0.02 = 2%
gender:
anyOf:
- type: string
- type: 'null'
title: Gender
language:
anyOf:
- type: string
- type: 'null'
title: Language
has_email:
anyOf:
- type: boolean
- type: 'null'
title: Has Email
location:
anyOf:
- type: string
- type: 'null'
title: Location
refresh:
type: boolean
title: Refresh
description: Force refresh, bypass cache
default: false
audience_gender:
anyOf:
- type: string
- type: 'null'
title: Audience Gender
description: female | male
audience_gender_min_pct:
anyOf:
- type: number
- type: 'null'
title: Audience Gender Min Pct
description: Min % of audience with that gender (0-100)
audience_location:
anyOf:
- type: string
- type: 'null'
title: Audience Location
description: Country name, e.g. 'United States'
audience_location_min_pct:
anyOf:
- type: number
- type: 'null'
title: Audience Location Min Pct
description: Min % audience from that country (0-100)
audience_age_min:
anyOf:
- type: integer
- type: 'null'
title: Audience Age Min
description: Min age of primary audience segment
audience_age_max:
anyOf:
- type: integer
- type: 'null'
title: Audience Age Max
description: Max age of primary audience segment
audience_interests:
anyOf:
- type: string
- type: 'null'
title: Audience Interests
description: Comma-separated interests, e.g. 'beauty,fashion'
type: object
title: ICSearchRequest
EnrichRequest:
properties:
handle:
type: string
maxLength: 200
minLength: 1
title: Handle
description: TikTok username or profile URL
email_required:
type: string
title: Email Required
description: '''must_have'' returns only if email found; ''preferred'' returns data even without email'
default: preferred
include_lookalikes:
type: boolean
title: Include Lookalikes
default: false
include_audience_data:
type: boolean
title: Include Audience Data
default: true
type: object
required:
- handle
title: EnrichRequest
EnrichContactResponse:
properties:
found:
type: boolean
title: Found
email:
anyOf:
- type: string
- type: 'null'
title: Email
verified:
type: boolean
title: Verified
default: false
deliverability_score:
anyOf:
- type: number
- type: 'null'
title: Deliverability Score
source:
anyOf:
- type: string
- type: 'null'
title: Source
cost_credits:
type: integer
title: Cost Credits
cached:
type: boolean
title: Cached
summary:
type: string
title: Summary
next_actions:
items:
type: string
type: array
title: Next Actions
default: []
type: object
required:
- found
- cost_credits
- cached
- summary
title: EnrichContactResponse
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
EnrichPostsRequest:
properties:
handle:
type: string
maxLength: 200
minLength: 1
title: Handle
type: object
required:
- handle
title: EnrichPostsRequest
CreditsResponse:
properties:
credits_available:
type: number
title: Credits Available
credits_used:
type: number
title: Credits Used
type: object
required:
- credits_available
- credits_used
title: CreditsResponse
EnrichRawRequest:
properties:
handle:
type: string
maxLength: 200
minLength: 1
title: Handle
type: object
required:
- handle
title: EnrichRawRequest
securitySchemes:
HTTPBearer:
type: http
scheme: bearer