[← Back to tools]
tiktok.search-users

Search TikTok users: pay per use, no API key

Use TikHub from Claude, Claude Code, Cursor, ChatGPT, and other agents through one Cralo balance.

Search public TikTok users by keyword through TikHub and return the provider's full result data.

Price and execution

Price
$0.001
Pricing model
Fixed price per successful call
Execution class
fast

Limits

No additional limits are published for this tool.

Parameters

Fields tiktok.search-users accepts as JSON input.

  • limitintegerOptional

    Maximum number of records to return.

  • querystringRequired

    Keyword or phrase to search for in public TikTok usernames.

  • cursorintegerOptional

    Pagination cursor from a previous response; use 0 for the first page.

Raw input JSON Schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1,
      "description": "Maximum number of records to return."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Keyword or phrase to search for in public TikTok usernames."
    },
    "cursor": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Pagination cursor from a previous response; use 0 for the first page."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful tiktok.search-users call returns.

  • countintegerRequired
  • resultsanyRequired

    Raw TikHub payload. List endpoints usually nest rows under keys such as `itemList`.

  • retrieved_atstring (date-time)Required
  • provider_request_idstring | nullRequired
Raw output JSON Schema
{
  "type": "object",
  "required": [
    "results",
    "count",
    "provider_request_id",
    "retrieved_at"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0
    },
    "results": {
      "description": "Raw TikHub payload. List endpoints usually nest rows under keys such as `itemList`."
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time"
    },
    "provider_request_id": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": false
}

Run this tool

Copy this instruction to your agent to set up Cralo and call this tool with the example input.

Set up Cralo by following https://cralo.ai/SKILL.md, then call the tiktok.search-users tool with this input: {"query":"tiktok","limit":1}

Safety notes

Side Effect
read_only
Public Sources Only
Yes
Authenticated Content
No

How this compares to using TikHub directly

You do not need a separate TikHub account or subscription for this call. Cralo uses one prepaid balance across all tools and shows the per-call price before you run the command.

Related tools

[Browse all tools]