Contract
{
"type": "object",
"required": [
"query_id_str",
"from_tab_path",
"query_analysis_required"
],
"properties": {
"query_id_str": {
"type": "string",
"pattern": "^[1-9]\\d*$",
"description": "The search topic's query ID, as a string of digits: the query_id_str a TikTok Creator Search Insights trending-topics lookup returns for each topic."
},
"from_tab_path": {
"enum": [
"TRENDING,TOPICS"
],
"type": "string",
"description": "The tab the topic is read from. Only TRENDING,TOPICS is offered."
},
"query_analysis_required": {
"enum": [
true
],
"type": "boolean",
"description": "Asks for the topic analysis. Only true is offered."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"status_msg": {
"type": "string"
},
"status_code": {
"type": "number",
"description": "0 when the lookup succeeded."
},
"top_countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code."
},
"country_name": {
"type": "string",
"description": "The country's English name."
}
}
},
"description": "The leading countries searching the topic, as aggregates."
},
"user_inspiration": {
"type": "object",
"properties": {
"textnet": {
"type": "object",
"properties": {
"layer1": {
"type": "string"
},
"layer2": {
"type": "string"
},
"layer3": {
"type": "string"
},
"layer4": {
"type": "string"
}
},
"description": "The topic's subject category, broadest level first; unused levels are empty."
},
"video_num": {
"type": "number",
"description": "Number of videos about the topic."
},
"popularity": {
"type": "number",
"description": "The topic's popularity score."
},
"query_text": {
"type": "string",
"description": "The topic's search text."
},
"query_id_str": {
"type": "string",
"description": "The topic's query ID."
},
"query_labels": {
"type": "array",
"items": {
"type": "string"
},
"description": "TikTok's labels for the topic, such as a content gap."
},
"trending_seq": {
"type": "array",
"items": {
"type": "number"
},
"description": "Seven-point trend series of the popularity score, oldest first."
},
"popularity_v2": {
"type": "number",
"description": "The topic's second popularity figure."
},
"trending_seq_v2": {
"type": "array",
"items": {
"type": "number"
},
"description": "Seven-point trend series of the second popularity figure, oldest first."
},
"inspiration_types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Where the topic idea comes from, such as search."
},
"popularity_updated_at": {
"type": "number",
"description": "When the popularity figures were last updated, as a Unix time in seconds."
}
},
"description": "The search topic and its trend."
}
},
"description": "Response of the lookup, as returned after shaping."
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.0020475 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Oct 11, 2026
