Supplier: Get Product Detail
get_supplier_product[Supply Product]
[What it does] Reads one supplier product's options, variants, stock, prices, shipping origins, and availability status for a given destination and language context.
[When to use] Use it when the user asks about a specific supplier product's quality, stock, price, or shipping, and when the agent must verify a shortlisted candidate before importing, mapping, or quoting freight. Trigger words: this supplier product, enough stock, ships to, supply cost.
[When not to use] To find candidates, use search_supplier_products. For destination freight costs, use list_supplier_product_shipping_methods_and_cost. For a product already in the store, use get_managed_store_product.
[How to use]
Copy
supplier_platform_idandsupplier_product_idfrom the same search candidate; never useapplications[].app_idor a DSers-managed product ID.supplier_product_urlis the usable product-detail entry; for Agent and 1688 Dropshipping it points to the configured DSers application page.include_supplier_product_descriptiondefaults to false, sosupplier_product_descriptionis omitted unless explicitly requested because descriptions can be large.Statuses such as
NotShipTo,NotLanguage,NotDropShipping, andNotAvailablemean unavailable under the requestedcountryorlanguage, not that the product is missing; retry with another destination before concluding.country,language, andcurrencyare requested context only and may be unsupported upstream; report the returned values, not the requested ones.Only
supplier_product_variant_list[].supplier_product_variant_idis accepted for freight quotes, ordering, and mapping;stockof 0 means that variant is out of stock, not that the product is delisted.Prices are strings and must be read with their currency, which can differ between variant and product level. Quotes exclude shipping, so never treat them as landed cost. [Side effects] None; read-only, and it never imports or maps a product. [Confirmation] Not required.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"supplier_platform_id": "<supplier_platform_id>",
"supplier_product_id": "<supplier_product_id>"
},
"name": "get_supplier_product"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Destination country code for availability context (default US). | US |
| currency | No | Requested supplier currency code. Optional. | |
| language | No | Product content language (default en). | en |
| supplier_product_id | Yes | Copy from the supplier_product_id field in search_supplier_products results. Required. | |
| supplier_platform_id | Yes | Copy the exact supplier platform application ID used for search_supplier_products, or use list_stores supplier_apps[].supplier_platform_id. Never guess it. Required. | |
| include_supplier_product_description | No | Whether to include supplier_product_description in the response. Defaults to false because descriptions can be large. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| supplier_product_id | Yes | Supplier product ID | |
| supplier_platform_id | Yes | Supplier platform application ID as a decimal string | |
| supplier_product_url | No | Supplier product URL | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. | |
| supplier_product_title | Yes | Supplier product title | |
| supplier_product_rating | No | Supplier product rating | |
| supplier_product_weight | No | Supplier product weight | |
| supplier_product_currency | No | Supplier currency | |
| supplier_product_dimensions | No | Supplier product length x width x height and unit | |
| supplier_product_media_list | Yes | Supplier product media URLs | |
| supplier_product_description | No | Product description | |
| supplier_product_option_list | Yes | Supplier product options | |
| supplier_product_order_count | No | Reported order count | |
| supplier_product_weight_unit | No | Supplier product weight unit | |
| supplier_platform_category_id | No | Supplier category ID | |
| supplier_product_country_code | No | Product country context | |
| supplier_product_variant_list | Yes | Supplier product variants | |
| supplier_product_listing_status | Yes | Supplier product listing status | |
| supplier_product_main_image_url | No | Supplier product main image URL | |
| supplier_product_content_language | No | Content language | |
| supplier_product_ship_from_country_code_list | Yes | Supported supplier shipping-origin country codes |