---
title: "Modash Search"
method: POST
path: "/api/modash/search"
tags: ["Modash"]
---

# Modash Search

`POST /api/modash/search`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/modash/search`
- Auth: HTTP bearer

Search TikTok influencers using Modash Discovery API filters. Cached for 24h.

## Request body

- ModashSearchRequest
  - `keyword` string: Search keyword (used as hashtag relevance filter)
  - `page` integer
  - `page_size` integer
  - `sort_field` string: Sort field: followers, engagementRate, engagements, views
  - `sort_direction` string: asc or desc
  - `followers_min` integer, nullable
  - `followers_max` integer, nullable
  - `engagement_rate_min` number, nullable: Min ER as decimal, e.g. 0.02 = 2%
  - `gender` string, nullable: MALE, FEMALE, KNOWN, UNKNOWN
  - `language` string, nullable: Language code, e.g. en
  - `location_ids` integer[], nullable: Modash location IDs
  - `has_email` boolean, nullable
  - `is_verified` boolean, nullable
  - `last_posted_days` integer, nullable: Max days since last post
  - `audience_location_ids` integer[], nullable
  - `audience_gender` string, nullable
  - `audience_age_range_min` integer, nullable
  - `audience_age_range_max` integer, nullable
  - `refresh` boolean: Bypass cache

## Response `200`

Successful Response

- ModashSearchResponse
  - `total` integer, required
  - `page` integer, required
  - `profiles` ModashKOLResult[], required
    - `username` string, required
    - `display_name` string, required
    - `avatar_url` string, required
    - `follower_count` integer, required
    - `engagement_rate` number, nullable, required
    - `category` string, required
    - `country` string, required
    - `gender` string, required
    - `modash_user_id` string, required
    - `email` string
    - `matched_posts` object[]
  - `data_source` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)