Skip to content
Eden Engine

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, description, 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 callv1
Provider
Web & Business Data Network
Category
xiaohongshu
Provider price
$0.020475 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

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.json
{
  "type": "object",
  "properties": {
    "msg": {
      "type": "string",
      "description": "A short status message. Observed in Chinese (\"成功\", \"success\") on the found fixture and in English (\"item not found\") on the not-found fixture -- 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 on the not-found fixture -- see this schema's own description.",
      "additionalProperties": true
    },
    "success": {
      "type": "boolean"
    }
  },
  "description": "The product record, as returned at routing.responseResultPath ($.output). On an invalid or unknown sku_id, `data` is absent entirely (confirmed against the not-found fixture) -- only `code`/`success`/`msg` are present in that case.",
  "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.

ChargeRate
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
Sep 23, 2026