Contract
input_schema.json
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"description": "页码/Page number"
},
"limit": {
"type": "integer",
"default": 20,
"description": "每页数量/Items per page"
},
"period": {
"type": "integer",
"default": 180,
"description": "时间段/Time period (days)"
},
"keyword": {
"type": "string",
"description": "搜索关键词/Search keyword"
},
"industry": {
"type": "string",
"description": "行业ID/Industry ID"
},
"order_by": {
"type": "string",
"default": "for_you",
"description": "排序方式/Sort by (for_you, likes)"
},
"search_id": {
"type": "string",
"description": "搜索ID（可选）/Search ID (optional)"
},
"country_code": {
"type": "string",
"default": "US",
"description": "国家代码/Country code"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"msg": {
"type": "string",
"description": "'OK' on both real calls observed."
},
"code": {
"type": "number",
"description": "0 on both real calls observed (success)."
},
"data": {
"type": "object",
"properties": {
"materials": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Opaque numeric ad-material ID, e.g. '7218843647072075778'."
},
"ctr": {
"type": "number",
"description": "Click-through rate, observed as a fraction (e.g. 0.8)."
},
"cost": {
"type": "number",
"description": "The ad's own cost/spend-tier score as reported by the ad library."
},
"like": {
"type": "number"
},
"ad_title": {
"type": "string",
"description": "The ad's own headline/caption text."
},
"favorite": {
"type": "boolean"
},
"is_search": {
"type": "boolean"
},
"brand_name": {
"type": "string",
"description": "The advertiser's own self-set brand name. Frequently empty -- observed blank on several real ads in the same search that returned it populated on others (e.g. 'Jorden Shoes')."
},
"video_info": {
"type": "object",
"properties": {
"vid": {
"type": "string",
"description": "Opaque video ID."
},
"cover": {
"type": [
"string",
"null"
],
"description": "Cover image URL. Value withheld (returned as `null` regardless of what the ad has) -- only whether a cover image exists is observable, not the image itself."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"duration": {
"type": "number",
"description": "Seconds."
},
"video_url": {
"type": "object",
"properties": {
"360p": {
"type": [
"string",
"null"
]
},
"480p": {
"type": [
"string",
"null"
]
},
"540p": {
"type": [
"string",
"null"
]
},
"720p": {
"type": [
"string",
"null"
]
}
},
"description": "Which resolution keys are present varies by ad -- observed sets range from a single '720p' entry to all four ('360p'/'480p'/'540p'/'720p'). Every present value is withheld the same way as `cover`.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"industry_key": {
"type": "string",
"description": "Opaque industry-category key, e.g. 'label_22999000000'."
},
"objective_key": {
"type": "string",
"description": "The advertiser's campaign objective, e.g. 'campaign_objective_conversion'."
}
},
"additionalProperties": true
},
"description": "Matching ads. Empty array when no ads match the search -- e.g. a deliberately nonsensical keyword returns `materials: []` with `pagination.total_count: 0` rather than an error."
},
"pagination": {
"type": "object",
"properties": {
"page": {
"type": "number"
},
"size": {
"type": "number"
},
"has_more": {
"type": "boolean"
},
"total_count": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "The search-result document.",
"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