TikTok Creator Ad Profile & Stats Lookup
omnial/tiktok-ads-get-creators-card
Given one or more TikTok creator IDs, returns each creator's ads-marketplace card: TikTok handle, display name, follower count and growth rate, audience demographics (age, gender, device, and country breakdown), engagement and video-completion rates, recent and top-performing video stats (views, likes, comments, shares), and a sponsored-post pricing block (rates typically come back zero). A creator id with no ads-marketplace record returns a mostly zero-value shell rather than an error.
activeper callv4
Price
Up to $0.00205 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.
Data source
Data from TikTok.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/tiktok-ads-get-creators-card" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/tiktok-ads-get-creators-card" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/tiktok-ads-get-creators-card", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/tiktok-ads-get-creators-card", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.00205 |
- Updated
- Oct 25, 2026
Input and output schemas
Input schema
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
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
}