Contract
input_schema.json
{
"type": "object",
"required": [
"tt_uids"
],
"properties": {
"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": "Typically 0 (for both found and not-found creators)."
},
"StatusMessage": {
"type": "string",
"description": "Typically an empty string."
}
},
"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": "Source-suggested sponsored-post rate. All fields typically '0'/empty-string -- a creator with real populated rates has not been observed; treat non-zero values as unconfirmed shape.",
"additionalProperties": true
},
"status": {
"type": "number"
},
"categories": {
"type": "array",
"items": {
"type": "number"
},
"description": "Content-category ids. Present only for a found creator; 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. Present only for a found creator; absent on the not-found shell."
},
"creatorTTInfo": {
"type": "object",
"properties": {
"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 -- every property below is therefore absent, not merely empty, in that case.",
"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` for a found creator.",
"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` for a found creator.",
"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 a populated found-creator record in testing -- 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 with most fields zeroed and `creatorTTInfo` an empty object, rather than an empty array or an error."
}
},
"description": "The creators-card record.",
"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
- Oct 12, 2026