Creator Search Insights Trends by Query ID

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

TikTok

Creator Search Insights Trends by Query ID | TikTok

Paste one query ID from TikTok Creator Search Insights to see how that topic's search popularity trends over time and across regions. The tab path stays TRENDING,TOPICS by default, and query analysis is on unless you turn it off. Pay-per-use, no subscription, max $0.0015 per call.

You receive

Returns the trend series for the query ID you enter: how its search popularity moves over time and across regions, with optional query analysis. It does not browse or list topics, open the TikTok app, return videos, or create a query ID for you. Pay-per-use, no subscription, max $0.0015 per call.

Start with your task

Creator Search Insights Trends by Query ID | TikTok

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
queryParams`queryParams`	`object`	Required	Required fields `query_id_str`
query_id_str`queryParams.query_id_str`	`string`	Required	Query ID returned by fetch_creator_search_insights. Examples `7555720035176562699`
from_tab_path`queryParams.from_tab_path`	`string`	Optional	Tab path. Default `TRENDING,TOPICS` Examples `TRENDING,TOPICS`
query_analysis_required`queryParams.query_analysis_required`	`boolean`	Optional	Whether to include query analysis. Default `true` Examples `true`

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "required": [
        "query_id_str"
      ],
      "properties": {
        "query_id_str": {
          "type": "string",
          "title": "Query Id Str",
          "examples": [
            "7555720035176562699"
          ],
          "description": "Query ID returned by fetch_creator_search_insights."
        },
        "from_tab_path": {
          "type": "string",
          "title": "From Tab Path",
          "default": "TRENDING,TOPICS",
          "examples": [
            "TRENDING,TOPICS"
          ],
          "description": "Tab path."
        },
        "query_analysis_required": {
          "type": "boolean",
          "title": "Query Analysis Required",
          "default": true,
          "examples": [
            true
          ],
          "description": "Whether to include query analysis."
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Bring your agent along.
Copy the note below into your agent’s chat. It reuses an existing connection or helps set one up.
Get connected
Start with your task
Tell your agent what you want to accomplish, including any constraints that matter.
Check before you call
I will inspect this tool, confirm the inputs and current cost, and check your authorization before running it. Then I will explain the result and its limits.

You receive

Start with your task

Inputs & outputs

Input schema

Result schema

Bring your agent along.

Start with your task

Check before you call