Xiaohongshu Product Detail (by SKU ID)
omnial/xiaohongshu-app-get-product-detail
Given a Xiaohongshu (Little Red Book) mall product SKU ID, returns the product's title, price, stock status, category, a seller/shop summary (name, rating, follower and sales counts), a review score summary, product image presence (not the raw image URL), and its size/color variant list. An invalid or unknown SKU ID returns a not-found result rather than throwing an error.
activeper callv2
Price
Up to $0.0205 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 $5.00.
Data source
Data from Xiaohongshu.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/xiaohongshu-app-get-product-detail" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/xiaohongshu-app-get-product-detail" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/xiaohongshu-app-get-product-detail", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/xiaohongshu-app-get-product-detail", 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.0205 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"sku_id"
],
"properties": {
"sku_id": {
"type": "string",
"examples": [
"669ddd44e05f3700011067ed"
],
"description": "Product SKU ID"
},
"source": {
"type": "string",
"default": "mall_search",
"examples": [
"mall_search"
],
"description": "Source"
},
"pre_page": {
"type": "string",
"default": "mall_search",
"examples": [
"mall_search"
],
"description": "Previous page"
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"msg": {
"type": "string",
"description": "A short status message. Observed in Chinese (\"成功\", \"success\") on a found product and in English (\"item not found\") on a not-found one -- language is not consistent across outcomes."
},
"code": {
"type": "number",
"description": "Provider status code. 0 observed when the SKU is found, 602 when it is not."
},
"data": {
"type": "object",
"properties": {
"module": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"content": {
"type": "object",
"properties": {
"score": {
"type": "string",
"description": "e.g. '4.7', out of 5."
},
"title": {
"type": "string",
"description": "A generic card heading -- observed carrying either the review section's own label (e.g. 'Reviews (1430)') or an unrelated info section header (e.g. 'Product Details'), depending on which sub-card produced it."
},
"total": {
"type": "number",
"description": "Total review count, when this is the reviews card."
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Image URL, withheld to null."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Additional product-detail images."
},
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"review_info": {
"type": "object",
"properties": {
"content": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "A small sample of buyer review text. Reviewer identity is not included."
},
"user_info": {
"type": "object",
"properties": {
"avatar": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Shop avatar image URL, withheld to null."
}
},
"additionalProperties": true
},
"user_id": {
"type": "string"
},
"fans_cnt": {
"type": "number",
"description": "Shop follower count."
}
},
"description": "The same shop's public content/social account.",
"additionalProperties": true
},
"extra_info": {
"type": "object",
"properties": {
"shop_score_info_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"desc": {
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Short shop-quality highlights, e.g. 'Ships in 12 hours'."
}
},
"additionalProperties": true
},
"properties": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Product attribute pairs, e.g. country of origin. Chinese-language labels observed."
},
"score_desc": {
"type": "string",
"description": "e.g. 'Excellent'."
},
"description": {
"type": "string",
"description": "The merchant's own product description. Empty string observed on the one real product."
},
"base_seller_info": {
"type": "object",
"properties": {
"new_shop": {
"type": "boolean"
},
"seller_id": {
"type": "string"
},
"shop_score": {
"type": "number",
"description": "0-5 shop rating."
},
"seller_name": {
"type": "string",
"description": "The shop's own public storefront name."
},
"seller_type": {
"type": "string",
"description": "e.g. 'FLAGSHIP_SHOP'."
},
"sales_quantity": {
"type": "number",
"description": "Cumulative units sold by the shop."
}
},
"description": "The queried product's own shop -- the entity a buyer would purchase from.",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Present on cards that nest sub-cards (shop summary, product-info, and reviews cards all live one level down here, NOT directly under this card's own `content` above) -- each sub-card has its own optional `content` object, populated only for the specific sub-card that actually carries a given field."
},
"content": {
"type": "object",
"properties": {
"asset": {
"type": "array",
"items": {
"type": "object",
"properties": {
"asset_type": {
"type": "string"
},
"asset_content": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"image": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Photo URL. Value withheld (stripped to null) -- only whether a photo exists is observable."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"thumbnail": {
"type": [
"string",
"null"
],
"description": "Same withholding as `url`."
}
},
"additionalProperties": true
},
"sku_id": {
"type": "string",
"description": "The specific variant sku this photo belongs to."
}
},
"additionalProperties": true
}
},
"tab_name": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Photo/style galleries, grouped by tab (e.g. 'Images', 'Styles')."
},
"style": {
"type": "object",
"properties": {
"sku_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "Short variant label, e.g. 'H01'."
},
"sku_id": {
"type": "string"
},
"sale_tag": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "A merchandising tag, e.g. '热销' (best seller)."
}
},
"additionalProperties": true
},
"variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "e.g. {name: 'Size', value: 'm'}, {name: 'Color', value: 'H01'}."
},
"header_image": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Variant thumbnail URL, withheld to null."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"thumbnail": {
"type": [
"string",
"null"
],
"description": "Same withholding."
}
},
"additionalProperties": true
},
"stock_status": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "One entry per purchasable size/color variant."
},
"spec_total_title": {
"type": "string",
"description": "e.g. 'All 3 styles'."
}
},
"additionalProperties": true
},
"spu_id": {
"type": "string",
"description": "The product's parent style-group id."
}
},
"description": "Present on cards that carry data directly (e.g. the photo/variant gallery card).",
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "The raw response renders this product page as a tree of UI 'cards' -- each entry here is one card, and only the specific card that actually carries a given field will populate it (most entries leave most of these properties absent). A card may carry its fields directly under `content`, or nest a further `cards` array of the same shape -- both are optional and neither is guaranteed present on any given entry."
}
},
"additionalProperties": true
},
"biz_info": {
"type": "object",
"properties": {
"common": {
"type": "object",
"properties": {
"common": {
"type": "object",
"properties": {
"region": {
"type": "string",
"description": "Buyer-region code, e.g. 'US' on the one real product observed."
},
"sku_id": {
"type": "string"
},
"seller_id": {
"type": "string",
"description": "The shop's own account id."
},
"deal_price": {
"type": "number",
"description": "The current selling price, in the SMALLEST unit of Chinese yuan (fen/cents) -- 599 observed means ¥5.99, NOT $599 or ¥599. Divide by 100 for the yuan amount; this endpoint does not return a pre-converted customer-currency price."
},
"goods_type": {
"type": "string",
"description": "Chinese-language product category label."
},
"origin_price": {
"type": "number",
"description": "The listed/reference price before any discount, same fen unit as deal_price."
},
"stock_status": {
"type": "number",
"description": "Numeric code; 1 observed meaning in stock. Other values unconfirmed."
}
},
"description": "Flat product-level fields.",
"additionalProperties": true
},
"nav_bar": {
"type": "object",
"properties": {
"share_info": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "The product's own full display title, including any variant suffix."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"bottom_bar": {
"type": "object",
"properties": {
"delivery_info": {
"type": "object",
"properties": {
"able_to_delivery": {
"type": "boolean",
"description": "Whether this product can ship to the resolved buyer region."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "Absent entirely when the product is not found -- see this schema's own description.",
"additionalProperties": true
},
"success": {
"type": "boolean"
}
},
"description": "The product record. On an invalid or unknown sku_id, `data` is absent entirely -- only `code`/`success`/`msg` are present in that case.",
"additionalProperties": true
}