tiktok.search-places

Search TikTok locations by keyword: $0.001 per call, no API key

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

Get location search results through TikHub.

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-places accepts as JSON input.

limitintegerOptional
Number
querystringRequired
Keyword
cursorintegerOptional
Offset

Raw input JSON Schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Number"
    },
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Keyword"
    },
    "cursor": {
      "type": "integer",
      "minimum": 0,
      "description": "Offset"
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful tiktok.search-places 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-places tool with this input: {"query":"Shanghai","cursor":0,"limit":20}

Start with $1 free See pricing

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]