本文档仅面向【花卷云生态合作伙伴】，根据合作类型查看并使用相应业务接口，请勿对外扩散接口文档，谢谢！
物料搜索
POST
最后修改时间：2026-01-20 01:14:14
请求参数：https://open.taobao.com/api.htm?docId=64758&docType=2&scopeId=13991
请求参数
Query 参数
Body 参数application/json
示例
{
"auth_id": "xxxx",
"site_id": 255650454,
"adzone_id": 71277550143,
"relation_id": "2126542868",
"session": "",
"has_coupon": true,
"q": "https://uland.taobao.com/item/edetail?id=5nMmwPwTxtpP72xcQM8iMtV-ypDv5OT60Ok7y2Rsy4"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '?api_name=dhcc.taobao.tbk.sc.material.optional.upgrade' \
--header 'Content-Type: application/json' \
--data-raw '{
"auth_id": "xxxx",
"site_id": 255650454,
"adzone_id": 71277550143,
"relation_id": "2126542868",
"session": "",
"has_coupon": true,
"q": "https://uland.taobao.com/item/edetail?id=5nMmwPwTxtpP72xcQM8iMtV-ypDv5OT60Ok7y2Rsy4"
}'返回响应
🟢200成功
application/json
Body
示例
{"code":0,"log_id":"626825ce-f423-4079-9fd7-e0e56c4f4b12","encrypt":0,"msg":"success","data":{"result_list":[{"isv_mktid":"zDDkKY8XcetMNzJKuzW6Hdt4-XZ0b2Wu0b0bnaG0swV","item_basic_info":{"annual_vol":"1万+","brand_name":"","category_id":1512,"category_name":"手机","level_one_category_id":1512,"level_one_category_name":"手机","pict_url":"https://img.alicdn.com/bao/uploaded/i3/668822010/O1CN01FaCXkX1Qid8Mp7WOV_!!668822010.jpg","provcity":"广东 汕头","real_post_fee":"0.00","seller_id":153264243930658491,"shop_title":"蓝光科技","short_title":"","small_images":["https://img.alicdn.com/i3/668822010/O1CN01NSknDX1Qid8Mp6meC_!!668822010.jpg","https://img.alicdn.com/i2/668822010/O1CN01nxFEBW1Qid8FnxRuF_!!668822010.jpg","https://img.alicdn.com/i2/668822010/O1CN01p1c87I1Qid8Mp3EF0_!!668822010.jpg","https://img.alicdn.com/i2/668822010/O1CN01ijHuu01Qid8MMUMW7_!!668822010.jpg"],"sub_title":"","title":"新款正品老年机超长待机大字大声大屏4G5G全网通整点报时老人手机","tk_total_sales":"100","user_type":0,"volume":0,"white_image":""},"item_id":"POQwjp3Nu3t6qeq56DyUxyOFPt6-XZ0b2Wu0b0bnaG0swV","presale_info":{"presale_deposit":""},"price_promotion_info":{"final_promotion_path_list":[{"promotion_desc":"满51.01减51","promotion_end_time":"1762358399000","promotion_fee":"51","promotion_id":"c0c9aef3b5e040a09ed928fcd9be33c4","promotion_start_time":"1759766400000","promotion_title":"商品券"}],"final_promotion_price":"50","more_promotion_list":[{"promotion_desc":"淘金币频道抵扣1%起","promotion_end_time":"1762963200000","promotion_id":"900248421602","promotion_start_time":"1761667200000","promotion_title":"淘金币频道专享","promotion_total_count":10000}],"promotion_tag_list":[{"tag_name":"淘金币频道抵扣1.01元起"},{"tag_name":"51元"},{"tag_name":"包邮"}],"reserve_price":"102","zk_final_price":"101"},"publish_info":{"click_url":"//s.click.taobao.com/t?e=m%3D2%26s%3DCm9Usl9y2Blw4vFB6t2Z2ueEDrYVVa64juWlisr3dOdyINtkUhsv0MKEtvt6F%2FxAQye%2Fk3%2FED%2FZSlv6vMuEOrBvm5%2FREmED%2BbzK5U2zXgs5jW1LAdp2dV2eBscApIBMLZiqtwk9j5QOk7mVwk%2B4lzK%2FzNDBK%2F6L0bV8hGCvTILCe23kV28z7sKGKohUoGY1IqBoD%2BmT6TYwNK0yPJaNSo5mX4hkW5rNlCBdXt2rHfKUs2vn01s8eV%2F43foJhFNIkHA7ZnIu8hgXGDF1NzTQoPw%3D%3D&union_lens=lensId%3AMAPI%401761720980%40213dd2c8_0df7_19a2ec0d45d_2913%4001%40eyJmbG9vcklkIjo4MDMwOX0ie","commission_type":"ZX","coupon_share_url":"//uland.taobao.com/coupon/edetail?e=yZCPltmGUikNfLV8niU3R5TgU2jJNKOfc4SfXBF8mZrfBn%2BjZnzJD3lrB5Tzkm6D7rXnFIQqnfdtNslAX2860LGt7U0WBQdLTAW%2FCkv%2Bq1DLkU4k%2FaBIVWwNk4zGkgDXshYOoWgEYuu44OImYdmZGFWQRLiKYeVknj8%2FkGZpqCM6aQYasYzUZYD13T2Y2QiPauF1CiTIfNPfkj%2F0tuVuBTKjbfXJDtgbNZLTzxT3pnOdIUsHpCDhQdKvU%2BcepHMoiFqjLDjDkY9ZE%2Frq7N6jtg%3D%3D&app_pvid=59590_33.61.210.200_1276_1761720980460&ptl=floorId:80309;app_pvid:59590_33.61.210.200_1276_1761720980460;tpp_pvid:257cf674-c2d8-475b-a389-12270ee8437e&union_lens=lensId%3AMAPI%401761720980%40213dd2c8_0df7_19a2ec0d45d_2913%4001%40eyJmbG9vcklkIjo4MDMwOX0ie","daily_promotion_sales":0,"include_dxjh":"false","income_info":{"commission_amount":"0.25","commission_rate":"50","subsidy_amount":"0","subsidy_rate":"0"},"income_rate":"0.5","two_hour_promotion_sales":0},"scope_info":{"superior_brand":0}},{"isv_mktid":"BAAMp4RXc6tnN6D0idWOirte-8o6G0dt0e6Xzkd0FA","item_basic_info":{"annual_vol":"7000+","brand_name":"纽曼","category_id":1512,"category_name":"手机","level_one_category_id":1512,"level_one_category_name":"手机","pict_url":"https://img.alicdn.com/bao/uploaded/i4/1688913659/O1CN01gaxNZb1ctsFVWakF6_!!4611686018427381499-0-item_pic.jpg","provcity":"广东 深圳","real_post_fee":"0.00","seller_id":4865224743424435369,"shop_title":"纽曼手机旗舰店","short_title":"超长待机全网通4G手机N105纽曼","small_images":["https://img.alicdn.com/i1/1688913659/O1CN01BIZj8t1ctsFVM9dnL_!!1688913659.jpg","https://img.alicdn.com/i2/1688913659/O1CN01rwIKvw1ctsFWhYcCL_!!1688913659.jpg","https://img.alicdn.com/i1/1688913659/O1CN01crIpjG1ctsFOVJK1Z_!!1688913659.jpg","https://img.alicdn.com/i4/1688913659/O1CN01izzS1g1ctsIoGMsOS_!!1688913659.jpg"],"sub_title":"4G全网通 大电池超长待机","title":"[官方旗舰店]纽曼N105正品老人手机超长待机老年机大屏大字大声4G全网通移动联通电信版男女学生非智能按键机","tk_total_sales":"100","user_type":1,"volume":0,"white_image":"https://img.alicdn.com/bao/uploaded/O1CN01m6U9h71TJO9nf5IRZ_!!6000000002361-0-yinhe.jpg"},"item_id":"GK0jMmkxI8tYdDd0YBqU6BnIQtJ-8o6G0dt0e6Xzkd0FA","presale_info":{"presale_deposit":""},"price_promotion_info":{"final_promotion_path_list":[{"promotion_desc":"直降58.65元","promotion_end_time":"1768009893000","promotion_fee":"58.65","promotion_id":"2469655620130","promotion_start_time":"1760320293000","promotion_title":"秒杀直降"}],"final_promotion_price":"90.35","more_promotion_list":[{"promotion_desc":"直降57元","promotion_end_time":"1768009893000","promotion_id":"2469655215617","promotion_start_time":"1760320293000","promotion_title":"秒杀直降"},{"promotion_desc":"淘金币频道抵扣1%起","promotion_end_time":"1762963200000","promotion_id":"866088449690","promotion_start_time":"1761667200000","promotion_title":"淘金币频道专享","promotion_total_count":10000}],"promotion_tag_list":[{"tag_name":"淘金币频道抵扣1.49元起"},{"tag_name":"直降58.65元"},{"tag_name":"包邮"}],"reserve_price":"4修改于 2026-01-20 01:14:14