- 云端点
- 自述文档 - 中文
- README - English
- 用户信息
- 抖音相关接口
- 微博相关 接口
- 小红书A类接口
- 小红书B类接口
- 小红书C类接口
- 小红书电商接口
- 哔哩哔哩相关接口
- 快手接口
- 淘宝接口
- 拼多多接口
- 推特接口
- 京东接口
- YouTube接口
- TikTok接口
- facebook接口
- wx搜一搜接口
- 蒲公英接口
- ins接口
- 头条接口
- 知乎接口
- 搜狐相关接口
- 百度相关接口
- 汽车之家相关接口
- 懂车帝相关接口
- 抖音直播间
- 抖音星图接口
- 星图_达人概览_内容表现_近15条视频(v17)
- 星图_达人概览_内容表现_播放量(V17)
- 星图_达人概览_内容表现_v2(批量)（v17）
- 星图_连接用户_连接用户画像_粉丝\铁粉画像(v17)
- 星图_连接用户_连接用户画像_观众画像(v17)
- 星图_达人主页基本信息(v17)
- 星图_达人报价(v17)
- 星图_连接用户_连接用户趋势_连接粉丝数(v17)
- 星图_达人_内容表现_数据概览(v17)
- 星图_达人_商业能力_商业能力分析(星图指数)(v17)
- 星图_达人_商业能力_性价比能力分析(v17)
- 达人_商业能力_合作能力分析(v17)
- 星图_达人_概览_代表作品(v17)
- 星图_热词分析_评论热词(v17)
- 星图_热词分析_内容热词(v17)
- 星图_达人内容表现内容类型分析(v17)
- 星图_达人连接用户连接用户分布(v17)
- 星图_转化能力分析(v17)
- 星图_达人_连接用户_连接用户来源(v17)
- 星图_商业能力_转化视频展示(v17)
- 星图_商单经验(v17)
- 星图_连接用户分布(v17)
- 星图_创作能力_全部视频(v17)
- 星图_达人搜索词相关视频数(v17)
- 星图_商业能力_效果预估(v17)
- 星图_达人概览_种草价值(v17)
- 星图_创作能力_视频关键词(v17)
- 星图_达人简介(v17)
- 星图_达人昵称搜索(v17)
- 抖音电商接口
- 1688
- 定制接口
- 速卖通
- 闲鱼接口
- reddit接口
- sephora接口
- ulta相关接口
- 唯品会相关接口
- 微店相关接口
- 苏宁相关接口
- ocr相关接口
- 亚马逊相关接口
- Google相关接口
- 数据模型
- ErrorResponse
- ApiEnvelope
- PgyBloggerListSyncV2
- User
- AnalyzeItemInput
- PgyContentTag
- OrderPayment
- TaskOptions
- PgyKol
- Category
- SingleAnalyzeTaskRequest
- PgyBloggerListData
- Links-Order
- BatchAnalyzeTaskRequest
- PgyBloggerListResponse
- Order
- TaskCreatedData
- ApiResponse
- ApiResponseTaskCreated
- Tag
- AnalyzeResultItem
- TaskStatusData
- ApiResponseTaskStatus
- ErrorBody
唯品会商品搜索(v7)
POST
https://api.yddm.com/weipinhui/item_search
| 状态码 | 说明 |
|---|---|
| -1 | failed |
| 0 | success |
| 400 | 参数错误 |
| 1001 | 账户余额不足 |
| 1002 | 邮箱/手机号或密码错误 |
| 1003 | 请求频率超过上限 |
| 1004 | 邮箱或手机号已注册 |
| 1005 | 无效的 API Key |
| 1006 | 用户不存在 |
| 1007 | 登录凭证无效 |
| 1008 | 缺少 API Key |
| 1009 | 手机或邮箱已存在 |
| 1010 | 需要管理员授权 |
| 1011 | 原密码错误 |
| 1012 | 新密码不能与原密码相同 |
| 1013 | 手机号和uid不能都为空 |
| 1014 | 请填写验证码 |
| 1015 | 验证码错误或已过期 |
| 1016 | 登录失败次数过多，请输入 验证码 |
| 1017 | 请填写手机号 |
| 1018 | 请填写邮箱 |
| 1019 | 接口不存在，请检查 |
| 5000 | 服务暂时不可用，请稍后重试 |
| 5003 | 网络连接失败，请稍后重试 |
| 6001 | 修改密码失败，请稍后重试 |
JSON 关键字段说明#
| 字段路径 | 示例值 | 说明 |
|---|---|---|
data.page | "1" | 当前页码（翻页参数） |
data.total_results | 3200 | 总结果数 |
data.real_total_results | 3200 | 实际总结果数 |
data.page_size | 20 | 每页条数 |
data.page_count | 160 | 总页数 |
data.item[].title | "纪梵希 Givenchy高定香榭粉丝绒口红顺滑显色唇膏" | 商品标题 |
data.item[].num_iid | "1710620522-6921426505444878858" | 商品 ID（含店铺 ID 前缀） |
data.item[].pic_url | "https://a.vpimg3.com/upload/merchandise/..." | 商品图片地址 |
data.item[].promotion_price | "179" | 促销价 |
data.item[].price | "179" | 原价 |
data.item[].detail_url | "https://detail.vip.com/detail-1710620522-.html" | 商品详情页地址 |
data.item[].seller_nick | "纪梵希" | 卖家/品牌名称 |
data.item[].area | "" | 地区（空） |
data.item[].sales | 0 | 销量 |
请求参数
Header 参数
Body 参数application/json必填
示例
{
"q": "口红",
"page": "1"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.yddm.com/weipinhui/item_search' \
--header 'x-api-key: {{X-API-KEY-QE}}' \
--header 'Content-Type: application/json' \
--data '{
"q": "口红",
"page": "1"
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"code": 0,
"msg": "success",
"data": {
"cost": 100,
"balance": 744827,
"page": "1",
"total_results": 3200,
"real_total_results": 3200,
"page_size": 20,
"item": [
{
"title": "纪梵希 Givenchy高定香榭粉丝绒口红顺滑显色唇膏",
"num_iid": "1710620522-6921426505444878858",
"pic_url": "https://a.vpimg3.com/upload/merchandise/pdcvis/2026/09/16/177/6bebdc1e-82cc-4306-8b40-6ae240cf57c4.jpg",
"promotion_price": "179",
"price": "179",
"detail_url": "https://detail.vip.com/detail-1710620522-.html",
"seller_nick": "纪梵希",
"area": "",
"sales": 0
},
{
"title": "YSL 圣罗兰小金条口红 细管丝绒纯口红 314节日礼物",
"num_iid": "1710612924-6921730469017507804",
"pic_url": "https://a.vpimg3.com/upload/merchandise/pdcvis/2025/12/01/23/b198d44a-3aab-4f1a-9531-e634f8288573.jpg",
"promotion_price": "239",
"price": "239",
"detail_url": "https://detail.vip.com/detail-1710612924-.html",
"seller_nick": "YSL",
"area": "",
"sales": 0
},
{
"title": "卡姿兰 甜吻唇釉拍2唇彩不拔干哑光显色丝滑元气不沾杯保湿滋润丰唇口红",
"num_iid": "1710614279-6922014941631625287",
"pic_url": "https://a.vpimg4.com/upload/merchandise/00666859/edde1938-fe87-4a28-afda-c67bdfb842a8.jpg",
"promotion_price": "48",
"price": "48",
"detail_url": "https://detail.vip.com/detail-1710614279-.html",
"seller_nick": "卡姿兰",
"area": "",
"sales": 0
},
{
"title": "兰蔻 菁纯丝绒雾面唇膏3.4g雾面哑光气质显白节日礼物",
"num_iid": "1710612775-6921672851373923335",
"pic_url": "https://a.vpimg2.com/upload/merchandise/pdcvis/2025/11/06/144/3a30d06d-f01b-4a42-af69-bb9dac66f64b.jpg",
"promotion_price": "199",
"price": "199",
"detail_url": "https://detail.vip.com/detail-1710612775-.html",
"seller_nick": "兰蔻",
"area": "",
"sales": 0
},
{
"title": "GUCCI 古驰倾色丝润唇膏 情倾阿根廷 #208 3.5g",
"num_iid": "1710621382-6920778454947503750",
"pic_url": "https://a.vpimg3.com/upload/merchandise/pdcvis/2024/01/24/193/a7c246a4-0ff5-4af9-8048-1ad354ebd942.jpg",
"promotion_price": "146",
"price": "146",
"detail_url": "https://detail.vip.com/detail-1710621382-.html",
"seller_nick": "GUCCI",
"area": "",
"sales": 0
},
{
"title": "DPDP 口红唇霜不易掉色持久雾面哑光裸色系素颜显白唇釉口红",
"num_iid": "1714012129-6921803243540829313",
"pic_url": "https://a.vpimg2.com/upload/merchandise/pdcvis/681483/2026/0127/93/e09d6c03-587d-4a77-9873-2aac6b082518.jpg",
"promotion_price": "60",
"price": "60",
"detail_url": "https://detail.vip.com/detail-1714012129-.html",
"seller_nick": "DPDP",
"area": "",
"sales": 0
},
{
"title": "阿玛尼 经典传奇红管唇釉丝绒哑光口红#214 暧昧奶杏 礼物",
"num_iid": "1710612762-6921936328479516314",
"pic_url": "https://a.vpimg3.com/upload/merchandise/pdcvis/2026/05/07/123/74b809ed-04f4-4c0d-b94f-21753649aff6.jpg",
"promotion_price": "199",
"price": "199",
"detail_url": "https://detail.vip.com/detail-1710612762-.html",
"seller_nick": "阿玛尼",
"area": "",
"sales": 0
},
{
"title": "YSL 圣罗兰黑管镜面唇釉416欲望 5.5ml节日礼物",
"num_iid": "1710619944-6921113480516307848",
"pic_url": "https://a.vpimg3.com/upload/merchandise/pdcvis/2024/09/26/12/6b501895-9a63-48a6-b32c-89f4991e9de4.jpg",
"promotion_price": "179",
"price": "179",
"detail_url": "https://detail.vip.com/detail-1710619944-.html",
"seller_nick": "YSL",
"area": "",
"sales": 0
},
{
"title": "毛戈平 【双11抢先购】空气仓唇釉口红迷你小装红棕显白哑光保湿不拔干",
"num_iid": "1712398450-6921436338909188306",
"pic_url": "https://a.vpimg3.com/upload/merchandise/pdcvis/654265/2026/1009/17/abca34c8-5858-4ee7-8722-b381d907665c.jpg",
"promotion_price": "77",
"price": "77",
"detail_url": "https://detail.vip.com/detail-1712398450-.html",
"seller_nick": "毛戈平",
"area": "",
"sales": 0
},
{
"title": "YSL 圣罗兰黑管镜面唇釉#440野玫瑰 5.5ml 欲感玻璃唇口红节日礼物",
"num_iid": "1710612924-6921325196565916188",
"pic_url": "https://a.vpimg2.com/upload/merchandise/pdcvis/2025/03/05/181/efd39c9c-84e0-4f98-9435-31e478efa84b.jpg",
"promotion_price": "235",
"price": "235",
"detail_url": "https://detail.vip.com/detail-1710612924-.html",
"seller_nick": "YSL",
"area": "",
"sales": 0
},
{
"title": "纪梵希 高定禁忌唇膏N37 禁忌复古红色七夕礼物",
"num_iid": "1710620522-6920143618872567882",
"pic_url": "https://a.vpimg2.com/upload/merchandise/pdcvis/2024/12/20/8/4b1cbf46-051f-4edc-a5cb-952ff54ec51c.jpg",
"promotion_price": "179",
"price": "179",
"detail_url": "https://detail.vip.com/detail-1710620522-.html",
"seller_nick": "纪梵希",
"area": "",
"sales": 0
},
{
"title": "美宝莲 【含眼唇卸】黑魔方口红哑光大牌高级感显白朱砂橘正宫红",
"num_iid": "1710615488-6919999792180528896",
"pic_url": "https://a.vpimg4.com/upload/merchandise/pdcvis/108668/2025/0909/86/d045bffb-bde7-4fab-b828-62c31ef3d335.jpg",
"promotion_price": "69",
"price": "69",
"detail_url": "https://detail.vip.com/detail-1710615488-.html",
"seller_nick": "美宝莲",
"area": "",
"sales": 0
},
{
"title": "美宝莲 【含眼唇卸】接吻棒巨持色哑光唇釉持久不沾杯高级哑光不易掉色",
"num_iid": "1710615488-6921334697091648704",
"pic_url": "https://a.vpimg2.com/upload/merchandise/pdcvis/108668/2026/0807/25/da91011a-705e-4fd7-9de1-7e011019b768.jpg",
"promotion_price": "68",
"price": "68",
"detail_url": "https://detail.vip.com/detail-1710615488-.html",
"seller_nick": "美宝莲",
"area": "",
"sales": 0
},
{
"title": "YSL 圣罗兰黑管镜面唇釉440野玫瑰 5.5ml节日礼物",
"num_iid": "1710619944-6921113480516311944",
"pic_url": "https://a.vpimg2.com/upload/merchandise/pdcvis/2026/09/16/50/d51be9c1-74f4-4764-883d-dbc66cff0021.jpg",
"promotion_price": "199",
"price": "199",
"detail_url": "https://detail.vip.com/detail-1710619944-.html",
"seller_nick": "YSL",
"area": "",
"sales": 0
},
{
"title": "卡姿兰 甜吻唇釉拍2唇彩不拔干哑光显色丝滑元气不沾杯保湿滋润丰唇口红",
"num_iid": "1710614279-6921053973348901383",
"pic_url": "https://a.vpimg2.com/upload/merchandise/00666859/94fa78b0-fed5-45ed-93d8-7eef3a59272d.jpg",
"promotion_price": "48",
"price": "48",
"detail_url": "https://detail.vip.com/detail-1710614279-.html",
"seller_nick": "卡姿兰",
"area": "",
"sales": 0
},
{
"title": "兰蔻 菁纯丝绒雾面唇膏3.4g雾面哑光气质显白节日礼物",
"num_iid": "1710612775-6921672851373902855",
"pic_url": "https://a.vpimg4.com/upload/merchandise/pdcvis/2025/11/06/55/5c9deeca-0e86-4b4f-a30f-685edd2c5d16.jpg",
"promotion_price": "189",
"price": "189",
"detail_url": "https://detail.vip.com/detail-1710612775-.html",
"seller_nick": "兰蔻",
"area": "",
"sales": 0
},
{
"title": "GUCCI 古驰倾色华缎唇膏 金管口红#500/505/506 3.5g",
"num_iid": "1710621382-6918538491661344902",
"pic_url": "https://a.vpimg4.com/upload/merchandise/pdcvis/2022/09/01/156/01e09dc5-d51d-49f9-83fa-7c0843cacf1a.jpg",
"promotion_price": "146",
"price": "146",
"detail_url": "https://detail.vip.com/detail-1710621382-.html",
"seller_nick": "GUCCI",
"area": "",
"sales": 0
},
{
"title": "DPDP 口红唇霜不易掉色持久雾面哑光裸色系素颜显白唇釉口红",
"num_iid": "1714012129-6921803243540825217",
"pic_url": "https://a.vpimg3.com/upload/merchandise/pdcvis/681483/2026/0127/49/4a0cb7ce-e1a4-42d5-ac26-dabe1d79b490.jpg",
"promotion_price": "60",
"price": "60",
"detail_url": "https://detail.vip.com/detail-1714012129-.html",
"seller_nick": "DPDP",
"area": "",
"sales": 0
},
{
"title": "阿玛尼 红管丝绒唇釉 206陶土红棕 6.5ml节日礼物",
"num_iid": "1710612762-6921865311662725338",
"pic_url": "https://a.vpimg3.com/upload/merchandise/pdcvis/2026/03/11/44/823067e1-8047-45ad-8309-3e8dc975abd1.jpg",
"promotion_price": "175",
"price": "175",
"detail_url": "https://detail.vip.com/detail-1710612762-.html",
"seller_nick": "阿玛尼",
"area": "",
"sales": 0
},
{
"title": "YSL 圣罗兰黑管镜面唇釉610冰乌龙 5.5ml节日礼物",
"num_iid": "1710619944-6921113480516324232",
"pic_url": "https://a.vpimg3.com/upload/merchandise/pdcvis/2024/10/14/184/7340c412-ae31-4d9b-935d-feeaab891e10.jpg",
"promotion_price": "219",
"price": "219",
"detail_url": "https://detail.vip.com/detail-1710619944-.html",
"seller_nick": "YSL",
"area": "",
"sales": 0
}
],
"_ddf": "ztk",
"page_count": 160,
"_type": "7"
}
}修改于 2026-10-13 08:06:53