Contract
input_schema.json
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"examples": [
1
],
"description": "Page number, start from 1"
},
"source": {
"type": "string",
"default": "explore_feed",
"examples": [
"explore_feed"
],
"description": "Source"
},
"keyword": {
"type": "string",
"examples": [
"手机壳"
],
"description": "Search keyword"
},
"search_id": {
"type": "string",
"description": "Search ID for pagination"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"module": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"content": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The product's own id."
},
"link": {
"type": "null",
"description": "Withheld -- a deep link to this product exists but is not returned by this tool."
},
"image": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "null",
"description": "Withheld -- the image exists (the field is present) but its URL is not returned by this tool."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"aspect_ratio": {
"type": "number"
}
},
"additionalProperties": true
}
},
"title": {
"type": "string"
},
"vendor": {
"type": "object",
"properties": {
"seller_id": {
"type": "string",
"description": "The store's own account id on Xiaohongshu."
},
"vendor_link": {
"type": "null",
"description": "Withheld -- a deep link to the store's page exists but is not returned by this tool."
},
"vendor_name": {
"type": "string",
"description": "The selling store's public display name."
},
"vendor_type": {
"type": "string",
"description": "The store's account tier, e.g. 'INDIVIDUAL_NEW', 'FLAGSHIP_SHOP', 'GENERAL_BUSINESS_SHOP', 'INDIVIDUAL_BUSINESS'."
}
},
"additionalProperties": true
},
"goods_type": {
"type": "string",
"description": "Typically 'normal'."
},
"price_info": {
"type": "object",
"properties": {
"price": {
"type": "number",
"description": "Current selling price, in the store's own currency."
},
"symbol": {
"type": "string",
"description": "Currency symbol, e.g. '$'. Not always present."
},
"rds_price": {
"type": "number",
"description": "A second price figure alongside `foreign_price`; not always present, and its meaning is not documented beyond its numeric closeness to the `foreign_price` conversion."
},
"origin_price": {
"type": "number",
"description": "Pre-discount list price, same currency as `price`."
},
"foreign_price": {
"type": "string",
"description": "An approximate USD-converted price string, e.g. '≈$13.57'."
}
},
"additionalProperties": true
},
"stock_status": {
"type": "number",
"description": "Typically `1` (in stock)."
},
"scene_keywords": {
"type": "array",
"items": {
"type": "object",
"properties": {
"link": {
"type": "null",
"description": "Withheld, same as `content.link`."
},
"scene_keyword": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Related search keyword suggestions. Present only on a card that is a related-search recommendation rather than a product -- not present on ordinary product cards."
},
"tag_strategy_map": {
"type": "object",
"properties": {
"behavior": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"tag_content": {
"type": "object",
"properties": {
"content": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"after_price": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"tag_content": {
"type": "object",
"properties": {
"content": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"before_price": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"tag_content": {
"type": "object",
"properties": {
"content": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"after_shop_name": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"tag_content": {
"type": "object",
"properties": {
"content": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
}
},
"description": "Short promotional/social-proof badge strings shown under a listing, grouped by where they'd render (before the price, after the price, after the shop name, or as a 'behavior' badge). Each entry's `tag_content.content` is the badge's own text, e.g. '11k+ sold', '24 sold', 'Flash sale ¥45 off', '200+ added to cart', 'No 1 in store repurchase', 'Sale price'.",
"additionalProperties": true
},
"has_buyer_explain": {
"type": "boolean",
"description": "Whether the listing has a buyer Q&A/explanation section."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "The result cards for this page. Most cards are products; a card can instead be a related-search-keyword recommendation (seen for a nonsense keyword), which is why `content.scene_keywords` exists as a sibling of the product fields below rather than every card having every field populated."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"page": {
"type": "number",
"description": "The page number this response covers."
},
"success": {
"type": "boolean"
},
"next_page": {
"type": "number",
"description": "The page number to request for more results."
},
"search_id": {
"type": "string",
"description": "Pass this back as `search_id` on the next call to page through results."
}
},
"description": "The product search result.",
"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.020475 |
- 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