Kolect Creator Search

Search Kolect's database of TikTok, Instagram and YouTube creators. Give a plain-language brief (any language: market, niche, follower range, content style, audience...), or similar_to (a profile link, @handle or creator id) to find lookalike creators, or both. Costs the user's credits: 1 credit per 2 creators returned (count 20 = 10 credits); no results cost nothing. Calling again with the same arguments within 15 minutes returns the same results without charging. Results include each creator's id: use it with check_fake_followers, get_emails and save_creators, and the search_id with load_more_results and get_search_results. Values under ai_estimate are AI estimates; say so when you present them.

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "tiktok",
        "instagram",
        "youtube"
      ]
    },
    "brief": {
      "type": "string",
      "description": "Who to find, in the user's words. Example: 'US beauty creators, 50k-500k followers, skincare reviews, mostly female audience'."
    },
    "similar_to": {
      "type": "string",
      "description": "Find creators similar to this one: profile URL, @handle (on the given platform), or a creator id from earlier results."
    },
    "count": {
      "type": "integer",
      "minimum": 10,
      "maximum": 50,
      "default": 20,
      "description": "How many creators to return now (more can be loaded later)."
    }
  },
  "required": [
    "platform"
  ],
  "additionalProperties": false
}

Get more new creators for one of the user's earlier searches. Costs 1 credit per 2 new creators returned. Calling again right away with the same arguments returns the same page without charging.

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string",
      "description": "search_id from search_creators."
    },
    "count": {
      "type": "integer",
      "minimum": 10,
      "maximum": 50,
      "default": 20
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false
}

Read creators already delivered by one of the user's earlier searches (free). Use next_cursor to page through them. To get new creators beyond those already delivered, use load_more_results.

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string",
      "description": "search_id from search_creators."
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous page."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 50
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false
}

Check whether specific creators are in Kolect's database, by profile link or @handle, and get their creator ids (needed for check_fake_followers, get_emails and save_creators). Free. Limits per call and per day depend on the user's plan (no subscription: 10 per call, 200 a day; Light: 30 and 500; Plus and above: 100 and 3,000); the daily limit counts only creators found for the first time, and creators past it come back in skipped as over_daily_limit. Bare @handles need platform. Supports TikTok, Instagram and YouTube only.

{
  "type": "object",
  "properties": {
    "creators": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 100,
      "description": "Profile URLs (tiktok.com/@x, instagram.com/x, youtube.com/@x) or @handles."
    },
    "platform": {
      "type": "string",
      "enum": [
        "tiktok",
        "instagram",
        "youtube"
      ],
      "description": "Platform for bare @handles."
    }
  },
  "required": [
    "creators"
  ],
  "additionalProperties": false
}

Estimate how real up to 20 creators' followers are, from public views, engagement, likes and following. Creator ids must come from this user's searches (pass search_id), lookups or saved creators. The first checks each day are free (see get_account), then 5 credits each; creators without enough data cost nothing; results from the last 7 days are reused for free unless fresh=true. This is a rule-based estimate, not platform data; present it that way.

{
  "type": "object",
  "properties": {
    "creator_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 20
    },
    "search_id": {
      "type": "string",
      "description": "The search these creators came from, if any."
    },
    "fresh": {
      "type": "boolean",
      "description": "Check again even if checked in the last 7 days."
    }
  },
  "required": [
    "creator_ids"
  ],
  "additionalProperties": false
}

Get public contact emails for up to 20 creators. Free for creators from this user's search results (pass search_id; the search already paid for them) and for ones unlocked before. Creators found by lookup_creators need an unlock: free for paid subscribers during the current promotion (daily cap), otherwise 5 credits per email found; no email, no charge. Only show emails to this user; never publish them.

{
  "type": "object",
  "properties": {
    "creator_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 20
    },
    "search_id": {
      "type": "string",
      "description": "The search these creators came from, if any."
    }
  },
  "required": [
    "creator_ids"
  ],
  "additionalProperties": false
}

Save creators to the user's Kolect favorites, optionally into a collection (an existing collection's name or id; a new name creates it). Free. Creator ids must come from this user's searches (pass search_id), lookups or saved creators. Saved creators appear on the Kolect website, where the user can export them as CSV. Pass quotes to record the rate the user actually got from a creator (shown only to this user as 'my quote').

{
  "type": "object",
  "properties": {
    "creator_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 100
    },
    "search_id": {
      "type": "string",
      "description": "The search these creators came from, if any."
    },
    "collection": {
      "type": "string",
      "maxLength": 40,
      "description": "Collection name or id. Created if it doesn't exist."
    },
    "quotes": {
      "type": "array",
      "maxItems": 100,
      "description": "Rates the user got from these creators, to record as 'my quote'.",
      "items": {
        "type": "object",
        "properties": {
          "creator_id": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "currency": {
            "type": "string",
            "description": "ISO code, default USD"
          },
          "note": {
            "type": "string",
            "maxLength": 120
          }
        },
        "required": [
          "creator_id",
          "amount"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "creator_ids"
  ],
  "additionalProperties": false
}

List the user's saved creators (all, or one collection by name or id) with current follower and view numbers, plus the user's collections. Free. Good for building a shortlist, a report or a spreadsheet.

{
  "type": "object",
  "properties": {
    "collection": {
      "type": "string",
      "description": "Collection name or id. Omit for all saved creators."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 200
    }
  },
  "additionalProperties": false
}

The user's Kolect plan, credit balance, today's free fake-follower checks and email unlocks, lookup limits, this key's daily credit limit, and their collections. Free. Check it before a large paid step.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}