KOLens · Schema

ICSearchRequest

InfluencerTikTokInstagramAnalyticsArtificial Intelligence

Properties

Name Type Description
keyword string Search keyword or query
page integer
page_size integer
followers_min object
followers_max object
engagement_rate_min object Min ER as decimal, e.g. 0.02 = 2%
gender object
language object
has_email object
location object
refresh boolean Force refresh, bypass cache
audience_gender object female | male
audience_gender_min_pct object Min % of audience with that gender (0-100)
audience_location object Country name, e.g. 'United States'
audience_location_min_pct object Min % audience from that country (0-100)
audience_age_min object Min age of primary audience segment
audience_age_max object Max age of primary audience segment
audience_interests object Comma-separated interests, e.g. 'beauty,fashion'
View JSON Schema on GitHub

JSON Schema

kolens-ai-icsearch-request-schema.json Raw ↑
{
  "$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"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/kolens-ai-icsearch-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API 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.