{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kolens-ai/json-schema/kolens-ai-modash-search-request-schema.json",
  "title": "ModashSearchRequest",
  "x-generated": "2026-11-14",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kolens-ai-openapi.json#/components/schemas/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"
}