KOLens Search API
The Search API from KOLens — 2 operation(s) for search.
The Search API from KOLens — 2 operation(s) for search.
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-search-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 Search API
description: KOLens — TikTok KOL Intelligence API. Search keywords, extract KOL profiles, collect contact info, export reports.
version: 1.0.0
tags:
- name: Search
paths:
/api/search/intent:
post:
tags:
- Search
summary: Classify Search Intent
description: 'Read a query''s shape and say whether it needs a choice first.
Deterministic and free — regex, no model call, no I/O. Safe to call
on every keystroke if a client wants to; safe to skip entirely.'
operationId: classify_search_intent_api_search_intent_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/IntentRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/IntentResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/search/parse:
post:
tags:
- Search
summary: Parse Query
operationId: parse_query_api_search_parse_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ParseRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ParseResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
components:
schemas:
IntentOption:
properties:
action:
type: string
enum:
- lookup_account
- keyword_search
title: Action
label:
type: string
title: Label
detail:
type: string
title: Detail
endpoint:
type: string
title: Endpoint
type: object
required:
- action
- label
- detail
- endpoint
title: IntentOption
description: 'One branch of the fork, described the way the UI should offer it.
There are two, not three. An earlier draft also offered "find
creators talking about this brand" alongside "search it as a topic"
— but ``POST /api/scrape`` takes no mode flag, so both buttons would
have sent byte-identical requests. Two choices that do the same
thing is not a choice; it is a UI that lies about what the system
can do. If a real mentions-only search ships, it earns a third
option then.'
IntentResponse:
properties:
query:
type: string
title: Query
platform:
type: string
title: Platform
intent:
type: string
title: Intent
needs_disambiguation:
type: boolean
title: Needs Disambiguation
options:
items:
$ref: '#/components/schemas/IntentOption'
type: array
title: Options
default: []
prompt:
anyOf:
- type: string
- type: 'null'
title: Prompt
type: object
required:
- query
- platform
- intent
- needs_disambiguation
title: IntentResponse
IntentRequest:
properties:
query:
type: string
maxLength: 300
minLength: 1
title: Query
platform:
type: string
maxLength: 20
title: Platform
default: tiktok
type: object
required:
- query
title: IntentRequest
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
ParseRequest:
properties:
query:
type: string
maxLength: 500
minLength: 1
title: Query
platform:
anyOf:
- type: string
- type: 'null'
title: Platform
description: tiktok | instagram | x | douyin
type: object
required:
- query
title: ParseRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ParseResponse:
properties:
keyword:
type: string
title: Keyword
description: Short scrapable term to run
filters:
type: object
title: Filters
description: Keys are /api/kols query params — forward as-is
parsed:
type: boolean
title: Parsed
description: False = we could not improve on the input; keyword is unchanged
notes:
type: string
title: Notes
description: What we understood, in the user's language
default: ''
original:
type: string
title: Original
description: The brief exactly as submitted
default: ''
needs_topic:
type: boolean
title: Needs Topic
description: Conditions understood but no topic named — ask the user for one. Running the brief as-is would be a guaranteed zero-result charge.
default: false
type: object
required:
- keyword
- parsed
title: ParseResponse
securitySchemes:
HTTPBearer:
type: http
scheme: bearer