KOLens Modash API
The Modash API from KOLens — 4 operation(s) for modash.
The Modash API from KOLens — 4 operation(s) for modash.
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-modash-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 Modash API
description: KOLens — TikTok KOL Intelligence API. Search keywords, extract KOL profiles, collect contact info, export reports.
version: 1.0.0
tags:
- name: Modash
paths:
/api/modash/search:
post:
tags:
- Modash
summary: Modash Search
description: Search TikTok influencers using Modash Discovery API filters. Cached for 24h.
operationId: modash_search_api_modash_search_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ModashSearchRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ModashSearchResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/modash/ai-search:
post:
tags:
- Modash
summary: Modash Ai Search
description: AI-powered text-based TikTok influencer search via Modash. Cached for 24h.
operationId: modash_ai_search_api_modash_ai_search_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ModashAISearchRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ModashSearchResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/modash/profile/{user_id}:
get:
tags:
- Modash
summary: Modash Profile
description: Get a full Modash profile report for a TikTok user. Costs 1 credit.
operationId: modash_profile_api_modash_profile__user_id__get
security:
- HTTPBearer: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
title: User Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/modash/credits:
get:
tags:
- Modash
summary: Modash Credits
description: Check remaining Modash API credits and rate limits.
operationId: modash_credits_api_modash_credits_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ModashCreditsResponse'
security:
- HTTPBearer: []
components:
schemas:
ModashSearchResponse:
properties:
total:
type: integer
title: Total
page:
type: integer
title: Page
profiles:
items:
$ref: '#/components/schemas/ModashKOLResult'
type: array
title: Profiles
data_source:
type: string
title: Data Source
default: modash
type: object
required:
- total
- page
- profiles
title: ModashSearchResponse
ModashSearchRequest:
properties:
keyword:
type: string
title: Keyword
description: Search keyword (used as hashtag relevance filter)
default: ''
page:
type: integer
minimum: 0.0
title: Page
default: 0
page_size:
type: integer
maximum: 50.0
minimum: 1.0
title: Page Size
default: 15
sort_field:
type: string
title: Sort Field
description: 'Sort field: followers, engagementRate, engagements, views'
default: followers
sort_direction:
type: string
title: Sort Direction
description: asc or desc
default: desc
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
description: MALE, FEMALE, KNOWN, UNKNOWN
language:
anyOf:
- type: string
- type: 'null'
title: Language
description: Language code, e.g. en
location_ids:
anyOf:
- items:
type: integer
type: array
- type: 'null'
title: Location Ids
description: Modash location IDs
has_email:
anyOf:
- type: boolean
- type: 'null'
title: Has Email
is_verified:
anyOf:
- type: boolean
- type: 'null'
title: Is Verified
last_posted_days:
anyOf:
- type: integer
minimum: 30.0
- type: 'null'
title: Last Posted Days
description: Max days since last post
audience_location_ids:
anyOf:
- items:
type: integer
type: array
- type: 'null'
title: Audience Location Ids
audience_gender:
anyOf:
- type: string
- type: 'null'
title: Audience Gender
audience_age_range_min:
anyOf:
- type: integer
- type: 'null'
title: Audience Age Range Min
audience_age_range_max:
anyOf:
- type: integer
- type: 'null'
title: Audience Age Range Max
refresh:
type: boolean
title: Refresh
description: Bypass cache
default: false
type: object
title: ModashSearchRequest
ModashKOLResult:
properties:
username:
type: string
title: Username
display_name:
type: string
title: Display Name
avatar_url:
type: string
title: Avatar Url
follower_count:
type: integer
title: Follower Count
engagement_rate:
anyOf:
- type: number
- type: 'null'
title: Engagement Rate
category:
type: string
title: Category
country:
type: string
title: Country
gender:
type: string
title: Gender
modash_user_id:
type: string
title: Modash User Id
email:
type: string
title: Email
default: ''
matched_posts:
items:
type: object
type: array
title: Matched Posts
default: []
type: object
required:
- username
- display_name
- avatar_url
- follower_count
- engagement_rate
- category
- country
- gender
- modash_user_id
title: ModashKOLResult
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
ModashAISearchRequest:
properties:
query:
type: string
maxLength: 8192
minLength: 1
title: Query
description: Natural language query
page:
type: integer
minimum: 1.0
title: Page
default: 1
page_size:
type: integer
maximum: 50.0
minimum: 1.0
title: Page Size
default: 10
followers_min:
anyOf:
- type: integer
- type: 'null'
title: Followers Min
followers_max:
anyOf:
- type: integer
- type: 'null'
title: Followers Max
gender:
anyOf:
- type: string
- type: 'null'
title: Gender
language:
anyOf:
- type: string
- type: 'null'
title: Language
engagement_rate_min:
anyOf:
- type: number
- type: 'null'
title: Engagement Rate Min
has_email:
anyOf:
- type: boolean
- type: 'null'
title: Has Email
last_posted_days:
anyOf:
- type: integer
- type: 'null'
title: Last Posted Days
account_type:
anyOf:
- type: string
- type: 'null'
title: Account Type
description: creator or brand
refresh:
type: boolean
title: Refresh
description: Bypass cache
default: false
type: object
required:
- query
title: ModashAISearchRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ModashCreditsResponse:
properties:
credits:
type: number
title: Credits
raw_requests:
type: integer
title: Raw Requests
discovery_ratelimit:
type: integer
title: Discovery Ratelimit
raw_ratelimit:
type: integer
title: Raw Ratelimit
type: object
required:
- credits
- raw_requests
- discovery_ratelimit
- raw_ratelimit
title: ModashCreditsResponse
securitySchemes:
HTTPBearer:
type: http
scheme: bearer