Contract
input_schema.json
{
"type": "object",
"required": [
"tt_uids"
],
"properties": {
"cookie": {
"type": "string",
"description": "自定义Cookie字符串（可选）/Custom Cookie string (optional)"
},
"tt_uids": {
"type": "array",
"items": {
"type": "string"
},
"description": "创作者ID列表/Creator ID list"
},
"creator_type": {
"type": "integer",
"default": 2,
"description": "创作者类型/Creator type"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"baseResp": {
"type": "object",
"properties": {
"StatusCode": {
"type": "number",
"description": "0 on both fixtures observed (found and not-found)."
},
"StatusMessage": {
"type": "string",
"description": "Empty string on both fixtures observed."
}
},
"additionalProperties": true
},
"creators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ttUID": {
"type": "string",
"description": "Echoes the requested tt_uid."
},
"esData": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"currency": {
"type": "string"
},
"startingRate100k": {
"type": "string"
},
"recommendRate100k": {
"type": "string"
},
"storeRegionCurrency": {
"type": "string"
},
"isLowQuotationCreator": {
"type": "boolean"
},
"storeRegionStartingRate100k": {
"type": "string"
}
},
"description": "Vendor-suggested sponsored-post rate. All fields observed as '0'/empty-string on both fixtures examined -- a creator with real populated rates was not captured; treat non-zero values as unconfirmed shape.",
"additionalProperties": true
},
"status": {
"type": "number"
},
"categories": {
"type": "array",
"items": {
"type": "number"
},
"description": "Content-category ids. Observed only on the found-creator fixture; absent on the not-found shell."
},
"appearOnSearchSetting": {
"type": "boolean"
}
},
"additionalProperties": true
},
"isCarveOut": {
"type": "boolean"
},
"priceIndex": {
"type": "number"
},
"creatorType": {
"type": "number",
"description": "Vendor status code; observed 1 for a found creator, 0 for a not-found lookup."
},
"displayType": {
"type": "number",
"description": "Vendor status code; observed 1 for a found creator, 0 for a not-found lookup."
},
"recentItems": {
"type": "array",
"items": {
"type": "object",
"properties": {
"heart": {
"type": "number"
},
"share": {
"type": "number"
},
"title": {
"type": "string"
},
"views": {
"type": "string",
"description": "Numeric count returned as a string."
},
"itemID": {
"type": "string"
},
"comment": {
"type": "number"
},
"isBoosted": {
"type": "boolean"
},
"createTime": {
"type": "string",
"description": "Unix timestamp, as a string."
},
"isSponsoredVideo": {
"type": "boolean"
}
},
"additionalProperties": true
},
"description": "Recent public videos. Observed only on the found-creator fixture; absent on the not-found shell."
},
"creatorTTInfo": {
"type": "object",
"properties": {
"bio": {
"type": "string",
"description": "The creator's public TikTok bio text, as self-published on their profile; may include a business contact the creator chose to publish."
},
"nickName": {
"type": "string",
"description": "The creator's public TikTok display name."
},
"handleName": {
"type": "string",
"description": "The creator's public TikTok @handle."
},
"followerCnt": {
"type": "number"
},
"storeRegion": {
"type": "string",
"description": "e.g. 'US'."
}
},
"description": "Empty object `{}` when the creator id has no ads-marketplace profile (see unknown-creator-not-found.json) -- every property below is therefore absent, not merely empty, on that shape.",
"additionalProperties": true
},
"statisticData": {
"type": "object",
"properties": {
"algo": {
"type": "object",
"properties": {
"contentLanguage": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true
},
"ttBasicInfo": {
"type": "object",
"properties": {
"appLanguage": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "Empty object `{}` on the not-found shell; carries `appLanguage` on the found-creator fixture.",
"additionalProperties": true
},
"videoPerformance": {
"type": "object",
"properties": {
"recentVideos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"heart": {
"type": "number"
},
"share": {
"type": "number"
},
"title": {
"type": "string"
},
"views": {
"type": "string",
"description": "Numeric count returned as a string."
},
"itemID": {
"type": "string"
},
"comment": {
"type": "number"
},
"isBoosted": {
"type": "boolean"
},
"createTime": {
"type": "string",
"description": "Unix timestamp, as a string."
},
"isSponsoredVideo": {
"type": "boolean"
}
},
"additionalProperties": true
}
},
"popularVideos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"heart": {
"type": "number"
},
"share": {
"type": "number"
},
"title": {
"type": "string"
},
"views": {
"type": "string",
"description": "Numeric count returned as a string."
},
"itemID": {
"type": "string"
},
"comment": {
"type": "number"
},
"isBoosted": {
"type": "boolean"
},
"createTime": {
"type": "string",
"description": "Unix timestamp, as a string."
},
"isSponsoredVideo": {
"type": "boolean"
}
},
"additionalProperties": true
}
}
},
"description": "Empty object `{}` on the not-found shell; carries `popularVideos`/`recentVideos` on the found-creator fixture.",
"additionalProperties": true
},
"followerDistriData": {
"type": "object",
"properties": {
"age": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ratio": {
"type": "number"
},
"ageInterval": {
"type": "string",
"description": "e.g. '18-24'."
}
},
"additionalProperties": true
}
},
"active": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ratio": {
"type": "number"
},
"active": {
"type": "string",
"description": "'active' or 'inactive'."
}
},
"additionalProperties": true
}
},
"gender": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ratio": {
"type": "number"
},
"gender": {
"type": "string"
}
},
"additionalProperties": true
}
},
"region": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ratio": {
"type": "number"
},
"country": {
"type": "string",
"description": "ISO-ish country code, e.g. 'US'."
}
},
"additionalProperties": true
}
},
"deviceBrand": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ratio": {
"type": "number"
},
"deviceBrand": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"description": "Audience breakdowns. Each array is empty `[]` on the not-found shell.",
"additionalProperties": true
},
"latestDSUpdateTime": {
"type": "string",
"description": "Unix timestamp, as a string."
},
"overallPerformance": {
"type": "object",
"properties": {
"medianViews": {
"type": "number"
},
"respondRate": {
"type": "number",
"description": "Observed only on the not-found/zero-value shell (value 0); absent from the populated found-creator fixture examined -- presence and meaning on a genuinely active creator record is unconfirmed."
},
"followerTier": {
"type": "number"
},
"followerCount": {
"type": "number"
},
"engagementRate": {
"type": "number"
},
"medianViewsRank": {
"type": "number"
},
"videoCompleteRate": {
"type": "number"
},
"engagementRateRank": {
"type": "number"
},
"followersGrowthRate": {
"type": "number"
},
"medianBenchMarkViews": {
"type": "number"
},
"videoCompleteRateRank": {
"type": "number"
},
"avgSixSecondsViewsRate": {
"type": "number"
},
"engagementRateBenchMark": {
"type": "number"
},
"followersGrowthRateRank": {
"type": "number"
},
"avgSixSecondsViewsRateRank": {
"type": "number"
},
"avgSixSecondsViewsBenchMarkViews": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "One entry per requested tt_uid. A nonexistent/unresolvable id still returns one entry here (see unknown-creator-not-found.json) with most fields zeroed and `creatorTTInfo` an empty object, rather than an empty array or an error."
}
},
"description": "The creators-card record, as returned at routing.responseResultPath ($.output).",
"additionalProperties": true
}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
- Sep 8, 2026