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"
},
"cookie": {
"type": "string",
"description": "自定义Cookie字符串（可选）"
},
"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. Unrelated to this tool's own per-call price."
},
"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 -- confirmed against the `obscure-empty` fixture, a deliberately nonsensical keyword that still billed and returned `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, 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