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