小红书根据关键词取商品列表 API接口smallredbook.item_search,开放平台

部署运行你感兴趣的模型镜像

小红书的API接口允许开发者根据关键词搜索并获取商品列表。为了使用smallredbook.item_search接口,你需要遵循以下步骤:

请求地址: 注册调用key请求接入 

  1. 注册并获取API密钥
    首先,你需要在开放平台注册账号,并创建一个应用。通过创建应用,你将获得API调用所需的密钥和秘钥(API Key和Secret)。

  2. 理解API接口名称和参数
    在小红书开放平台的文档中,查找smallredbook.item_search接口,并了解它的使用方法和所需参数。通常,搜索接口会要求提供关键词、分页参数、排序选项等。

  3. 构建请求地址
    使用API的基础URL,结合你的API密钥、秘钥以及搜索参数,构建完整的请求地址。这通常涉及将参数编码到URL中,或者使用POST请求将数据作为请求体发送。

  4. 发送请求
    使用你选择的编程语言中的HTTP客户端库(如Python的requests库),向构建好的请求地址发送GET或POST请求。确保在请求中包含正确的认证信息(如API密钥)。

  5. 处理响应
    一旦收到小红书服务器的响应,你需要解析它来获取商品列表数据。响应数据通常以JSON格式返回,包含搜索到的商品信息,如商品标题、图片、价格等。

  6. 展示数据
    将获取到的商品数据展示在你的应用或网站上,供用户浏览和选择。

smallredbook.item_search

公共参数

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:q=女装&page=&sort=&filter=

参数说明:q:关键词, 排序说明:param sort: 新品:new_arrival 综合:default 销量:sales_qty 种草:fav_count 价格降序:price_desc 价格升序:price_asc 
filter:note(搜索笔记)

响应参数

Version: Date:

名称类型必须示例值描述

title

String0中国·创意设计感连衣裙商品标题

desc

String0KUOSE阔色 2020秋季新款女装减龄学院风背带裙毛呢高腰半身裙洋气穿搭 黑色描述

num_iid

String05f50ad1981d4c125e500a2d1宝贝ID

price

Float0205.2价格

orginal_price

Float0912原价格

promotion_price

Float0205.2优惠价格

pic_url

String0https://qimg.xiaohongshu.com/5c925db612b045a350f0f17079ffa2d38f23dd43?itemId=5f50ad1981d4c125e500a2d1&imageView2/1/w/320/h/427/q/90.jpg%7Cwatermark/1/image/aHR0cDovL3FpbWctMTI1MTUyNDMxOS5waWNzaC5teXFjbG91ZC5jb20vb2Rpbi9hZDk3MzQ4ZjgzYzM3OTQ5NWQ2ZmMzM2I2ZjI1ZThlZTg0YWQ0NmFhP3dhdGVybWFyay8yL2R4LzI4L2R5LzUvZ3Jhdml0eS9zb3V0aHdlc3QvZm9udC9VR2x1WjBaaGJtZGlaQzUwZEdZPS9mb250c2l6ZS8yNi9maWxsL0kwWkdSa1pHUmc9PS90ZXh0L01UZzE=/dx/0/dy/0/gravity/southwest宝贝图片

sales

Int014830销量

seller_id

String05b21104303da487381b41ccc卖家ID

seller_nick

String0时沫女装专营店掌柜昵称

detail_url

String0www.xiaohongshu.com/goods/5f50ad1981d4c125e500a2d1宝贝链接

 

响应示例

{
		"items": {
		"q": "女装",
		"page": 1,
		"page_size": 20,
		"real_total_results": 57036,
		"total_results": 57036,
		"pagecount": 2852,
		"data_from": "smallredbook",
		"item": [
			{
				"title": "中国·创意设计感连衣裙",
				"desc": "KUOSE阔色 2020秋季新款女装减龄学院风背带裙毛呢高腰半身裙洋气穿搭 黑色",
				"num_iid": "5f50ad1981d4c125e500a2d1",
				"price": 205.2,
				"orginal_price": 912,
				"promotion_price": 205.2,
				"pic_url": "https://qimg.xiaohongshu.com/5c925db612b045a350f0f17079ffa2d38f23dd43?itemId=5f50ad1981d4c125e500a2d1&imageView2/1/w/320/h/427/q/90.jpg%7Cwatermark/1/image/aHR0cDovL3FpbWctMTI1MTUyNDMxOS5waWNzaC5teXFjbG91ZC5jb20vb2Rpbi9hZDk3MzQ4ZjgzYzM3OTQ5NWQ2ZmMzM2I2ZjI1ZThlZTg0YWQ0NmFhP3dhdGVybWFyay8yL2R4LzI4L2R5LzUvZ3Jhdml0eS9zb3V0aHdlc3QvZm9udC9VR2x1WjBaaGJtZGlaQzUwZEdZPS9mb250c2l6ZS8yNi9maWxsL0kwWkdSa1pHUmc9PS90ZXh0L01UZzE=/dx/0/dy/0/gravity/southwest",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f50ad1981d4c125e500a2d1"
			},
			{
				"title": "中国·简约风百搭半身裙",
				"desc": "KUOSE阔色 2020秋季女装气质显瘦针织半身裙中长款开叉a字裙通勤穿搭 杏色 M",
				"num_iid": "5f65a30978da8501a5373258",
				"price": 139,
				"orginal_price": 556,
				"promotion_price": 139,
				"pic_url": "https://qimg.xiaohongshu.com/f320c1f8c819fc7b13322e1bf729b53d0971a305?itemId=5f65a30978da8501a5373258&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f65a30978da8501a5373258"
			},
			{
				"title": "中国·简约风百搭半身裙",
				"desc": "KUOSE阔色 2020秋季女装气质显瘦针织半身裙中长款开叉a字裙通勤穿搭 黑色 S",
				"num_iid": "5f44be3a5305650e10579815",
				"price": 139,
				"orginal_price": 556,
				"promotion_price": 139,
				"pic_url": "https://qimg.xiaohongshu.com/49312d1fc4837b2b724c8a9c196f5e672e440fcf?itemId=5f44be3a5305650e10579815&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f44be3a5305650e10579815"
			},
			{
				"title": "中国·减龄气质半身裙子",
				"desc": "KUOSE阔色 不规则波点网纱半身裙2020秋新款女装显瘦蓬蓬蛋糕裙气质穿搭 黑色 L",
				"num_iid": "5f50b44881d4c125e500a657",
				"price": 169,
				"orginal_price": 676,
				"promotion_price": 169,
				"pic_url": "https://qimg.xiaohongshu.com/644754c03072384dbe6a139afcb4d44b402d1c56?itemId=5f50b44881d4c125e500a657&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f50b44881d4c125e500a657"
			},
			{
				"title": "中国·胯大腿粗显瘦长裤",
				"desc": "KUOSE阔色 2020秋冬新款女装高腰直筒宽松毛呢长裤休闲萝卜裤简约穿搭 杏色 L",
				"num_iid": "5f50b11ba09141267ee54e6a",
				"price": 168,
				"orginal_price": 672,
				"promotion_price": 168,
				"pic_url": "https://qimg.xiaohongshu.com/ad1142fb826d50e07a70af56ee0cee8e5f7d2dc5?itemId=5f50b11ba09141267ee54e6a&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f50b11ba09141267ee54e6a"
			},
			{
				"title": "中国·时尚个性高街穿搭",
				"desc": "KUOSE阔色 2020夏季新款韩版女装高腰显瘦雪纺休闲裤吊带连体裤度假穿搭 黑色",
				"num_iid": "5ea3ef05a091415b03d9532a",
				"price": 169,
				"orginal_price": 676,
				"promotion_price": 169,
				"pic_url": "https://qimg.xiaohongshu.com/f2abfc7baedb1c2f56c14791873373de22b37f1f?itemId=5ea3ef05a091415b03d9532a&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5ea3ef05a091415b03d9532a"
			},
			{
				"title": "中国·简约风显瘦休闲裤",
				"desc": "KUOSE阔色 2020夏季新款韩版女装高腰直筒裤宽松阔腿西装短裤上班穿搭 黑色",
				"num_iid": "5eb1097ba091410953951d17",
				"price": 99,
				"orginal_price": 396,
				"promotion_price": 99,
				"pic_url": "https://qimg.xiaohongshu.com/be704018220220f0c95d63e42aed5a62d549716e?itemId=5eb1097ba091410953951d17&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5eb1097ba091410953951d17"
			},
			{
				"title": "中国·法式复古风连衣裙",
				"desc": "KUOSE阔色 2020秋季新款女装优雅气质收腰连衣裙修身针织裙温柔风穿搭 杏色",
				"num_iid": "5f50ab9b0cf9a172d9f0ae3e",
				"price": 179.1,
				"orginal_price": 796,
				"promotion_price": 179.1,
				"pic_url": "https://qimg.xiaohongshu.com/494a28fb9e68d12d8f3443cad6e74e6a7563f4a2?itemId=5f50ab9b0cf9a172d9f0ae3e&imageView2/1/w/320/h/427/q/90.jpg%7Cwatermark/1/image/aHR0cDovL3FpbWctMTI1MTUyNDMxOS5waWNzaC5teXFjbG91ZC5jb20vb2Rpbi9hZDk3MzQ4ZjgzYzM3OTQ5NWQ2ZmMzM2I2ZjI1ZThlZTg0YWQ0NmFhP3dhdGVybWFyay8yL2R4LzI4L2R5LzUvZ3Jhdml0eS9zb3V0aHdlc3QvZm9udC9VR2x1WjBaaGJtZGlaQzUwZEdZPS9mb250c2l6ZS8yNi9maWxsL0kwWkdSa1pHUmc9PS90ZXh0L01UWXk=/dx/0/dy/0/gravity/southwest",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f50ab9b0cf9a172d9f0ae3e"
			},
			{
				"title": "中国·轻熟时尚气质穿搭",
				"desc": "KUOSE阔色 2020秋季新款女装法式复古连衣裙甜美泡泡袖波点裙子浪漫穿搭 杏色",
				"num_iid": "5f3208f30cf9a14647c5910b",
				"price": 226,
				"orginal_price": 904,
				"promotion_price": 226,
				"pic_url": "https://qimg.xiaohongshu.com/842f2d45727e654e3679e938e48dcd43787a55a5?itemId=5f3208f30cf9a14647c5910b&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f3208f30cf9a14647c5910b"
			},
			{
				"title": "中国·复古简约甜美穿搭",
				"desc": "KUOSE阔色 2020秋季女装中长款气质裙子泡泡袖复古小众连衣裙法式穿搭 黑色 S",
				"num_iid": "5f3cdabe81d4c1048cbc15b5",
				"price": 199,
				"orginal_price": 796,
				"promotion_price": 199,
				"pic_url": "https://qimg.xiaohongshu.com/3769692aecd1224bb95f0143b6c87921f7782792?itemId=5f3cdabe81d4c1048cbc15b5&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f3cdabe81d4c1048cbc15b5"
			},
			{
				"title": "中国·休闲港风显瘦长裤",
				"desc": "KUOSE阔色 宽松高腰牛仔裤2020秋冬女装小个子休闲哈伦裤萝卜裤甜酷穿搭 黑色 S",
				"num_iid": "5f50bd3e0cf9a172eb37d88c",
				"price": 161.1,
				"orginal_price": 716,
				"promotion_price": 161.1,
				"pic_url": "https://qimg.xiaohongshu.com/26f339d4f446023fde632e0a0e03eabe5824c2a4?itemId=5f50bd3e0cf9a172eb37d88c&imageView2/1/w/320/h/427/q/90.jpg%7Cwatermark/1/image/aHR0cDovL3FpbWctMTI1MTUyNDMxOS5waWNzaC5teXFjbG91ZC5jb20vb2Rpbi9hZDk3MzQ4ZjgzYzM3OTQ5NWQ2ZmMzM2I2ZjI1ZThlZTg0YWQ0NmFhP3dhdGVybWFyay8yL2R4LzI4L2R5LzUvZ3Jhdml0eS9zb3V0aHdlc3QvZm9udC9VR2x1WjBaaGJtZGlaQzUwZEdZPS9mb250c2l6ZS8yNi9maWxsL0kwWkdSa1pHUmc9PS90ZXh0L01UUTE=/dx/0/dy/0/gravity/southwest",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f50bd3e0cf9a172eb37d88c"
			},
			{
				"title": "中国·复古翻领衬衫 ",
				"desc": "URBAN REVIVO 女装复古翻领羊腿袖设计休闲衬衫WG01SBWX2001 正黑 L",
				"num_iid": "5fb36ff201aa66590bafc5e7",
				"price": 339,
				"orginal_price": 369,
				"promotion_price": 339,
				"pic_url": "https://qimg.xiaohongshu.com/cd09e6a8493c0a314b6dcedf97b5d1f6a9e5a04d?itemId=5fb36ff201aa66590bafc5e7&imageView2/1/w/320/h/320/q/90jpeg",
				"sales": 0,
				"seller_id": "591e5d7a31e77640efbc9706",
				"seller_nick": "URBAN REVIVO官方旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5fb36ff201aa66590bafc5e7"
			},
			{
				"title": "中国·缎面手感少女感",
				"desc": "芥末JEMO DRESSING 春季新款气质通勤港风女装奶昔缎包扣灯笼袖衬衫 奶姜黄 L",
				"num_iid": "5e1fdd4a5305654b618c4760",
				"price": 149,
				"orginal_price": 599,
				"promotion_price": 149,
				"pic_url": "https://qimg.xiaohongshu.com/45202b12507a6cee3918d24cbe3a8b3046e298af?itemId=5e1fdd4a5305654b618c4760&imageView2/1/w/320/h/427/q/90.jpg%7Cwatermark/1/image/aHR0cDovL3FpbWctMTI1MTUyNDMxOS5waWNzaC5teXFjbG91ZC5jb20vb2Rpbi9hZDk3MzQ4ZjgzYzM3OTQ5NWQ2ZmMzM2I2ZjI1ZThlZTg0YWQ0NmFhP3dhdGVybWFyay8yL2R4LzI4L2R5LzUvZ3Jhdml0eS9zb3V0aHdlc3QvZm9udC9VR2x1WjBaaGJtZGlaQzUwZEdZPS9mb250c2l6ZS8yNi9maWxsL0kwWkdSa1pHUmc9PS90ZXh0L01UTTE=/dx/0/dy/0/gravity/southwest",
				"sales": 0,
				"seller_id": "57fb3bcd343107624e3ce85c",
				"seller_nick": "JEMO DRESSING旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5e1fdd4a5305654b618c4760"
			},
			{
				"title": "中国·基础款显高牛仔裤",
				"desc": "KUOSE阔色 2020初秋韩版女装简约高腰显瘦弹力铅笔裤修身牛仔裤每日穿搭 黑色",
				"num_iid": "5f068b9ea0914106e0b98547",
				"price": 159,
				"orginal_price": 636,
				"promotion_price": 159,
				"pic_url": "https://qimg.xiaohongshu.com/a6657cfaaab2ffc102301653d6ba7fe08d99358f?itemId=5f068b9ea0914106e0b98547&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f068b9ea0914106e0b98547"
			},
			{
				"title": "中国·甜美温柔气质T恤",
				"desc": "KUOSE阔色 2020早秋新款女装韩版宽松薄款针织衫长袖打底上衣平价穿搭 米白色 L",
				"num_iid": "5f3cc74ea091413c13472008",
				"price": 79,
				"orginal_price": 316,
				"promotion_price": 79,
				"pic_url": "https://qimg.xiaohongshu.com/935450b7407bfde99fef20e1d5be8fc22eb81cbe?itemId=5f3cc74ea091413c13472008&imageView2/1/w/320/h/427/q/90.jpg",
				"sales": 0,
				"seller_id": "5b21104303da487381b41ccc",
				"seller_nick": "KUOSE阔色旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f3cc74ea091413c13472008"
			},
			{
				"title": "中国·缎面手感防晒衣",
				"desc": "芥末JEMO DRESSING 春季新款气质通勤港风女装奶昔缎包扣灯笼袖衬衫 珍珠白 M",
				"num_iid": "5e1fdd4d5305654b618c477d",
				"price": 149,
				"orginal_price": 599,
				"promotion_price": 149,
				"pic_url": "https://qimg.xiaohongshu.com/45edc77282336ce0faa4a70f13d0948be3983711?itemId=5e1fdd4d5305654b618c477d&imageView2/1/w/320/h/427/q/90.jpg%7Cwatermark/1/image/aHR0cDovL3FpbWctMTI1MTUyNDMxOS5waWNzaC5teXFjbG91ZC5jb20vb2Rpbi9hZDk3MzQ4ZjgzYzM3OTQ5NWQ2ZmMzM2I2ZjI1ZThlZTg0YWQ0NmFhP3dhdGVybWFyay8yL2R4LzI4L2R5LzUvZ3Jhdml0eS9zb3V0aHdlc3QvZm9udC9VR2x1WjBaaGJtZGlaQzUwZEdZPS9mb250c2l6ZS8yNi9maWxsL0kwWkdSa1pHUmc9PS90ZXh0L01UTTE=/dx/0/dy/0/gravity/southwest",
				"sales": 0,
				"seller_id": "57fb3bcd343107624e3ce85c",
				"seller_nick": "JEMO DRESSING旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5e1fdd4d5305654b618c477d"
			},
			{
				"title": "中国·网红炸街小西装",
				"desc": "Mrs win赢夫人 2020年秋季新款上衣韩版英伦风西服宽松chic网红炸街格子小西装外套大码女装胖mm显瘦气质减龄 S(80-90斤)",
				"num_iid": "5f9ae191946cd30001cee057",
				"price": 89,
				"orginal_price": 149,
				"promotion_price": 89,
				"pic_url": "https://qimg.xiaohongshu.com/arkgoods/80cd63c0e31d7b25378dc03e37895450871c35a4?itemId=5f9ae191946cd30001cee057&imageView2/1/w/320/h/320/q/90.jpg%7Cwatermark/1/image/aHR0cDovL3FpbWctMTI1MTUyNDMxOS5waWNzaC5teXFjbG91ZC5jb20vb2Rpbi9hZDk3MzQ4ZjgzYzM3OTQ5NWQ2ZmMzM2I2ZjI1ZThlZTg0YWQ0NmFhP3dhdGVybWFyay8yL2R4LzQwL2R5LzUvZ3Jhdml0eS9zb3V0aHdlc3QvZm9udC9VR2x1WjBaaGJtZGlaQzUwZEdZPS9mb250c2l6ZS8yNi9maWxsL0kwWkdSa1pHUmc9PS90ZXh0L09ERT0=/dx/0/dy/0/gravity/southwest",
				"sales": 0,
				"seller_id": "5ea63d642cf8f50001936591",
				"seller_nick": "赢夫人旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f9ae191946cd30001cee057"
			},
			{
				"title": "修身显瘦一条足够",
				"desc": "兰邺 加厚加绒牛仔裤女装冬季穿搭女秋冬2020年新款韩版女生高腰修身百搭显瘦九分铅笔休闲小脚女裤子潮 烟灰色加绒 长裤 25 建议73-84斤",
				"num_iid": "5fd0e056aabcd100018332e5",
				"price": 75,
				"orginal_price": 138,
				"promotion_price": 75,
				"pic_url": "https://qimg.xiaohongshu.com/arkgoods/ef07c4df81d8d7983581b54af4fceb7850da4916?itemId=5fd0e056aabcd100018332e5&imageView2/1/w/320/h/320/q/90.jpg%7Cwatermark/1/image/aHR0cDovL3FpbWctMTI1MTUyNDMxOS5waWNzaC5teXFjbG91ZC5jb20vb2Rpbi9hZDk3MzQ4ZjgzYzM3OTQ5NWQ2ZmMzM2I2ZjI1ZThlZTg0YWQ0NmFhP3dhdGVybWFyay8yL2R4LzQwL2R5LzUvZ3Jhdml0eS9zb3V0aHdlc3QvZm9udC9VR2x1WjBaaGJtZGlaQzUwZEdZPS9mb250c2l6ZS8yNi9maWxsL0kwWkdSa1pHUmc9PS90ZXh0L05qZz0=/dx/0/dy/0/gravity/southwest",
				"sales": 0,
				"seller_id": "5f8812d1aa68a90001596ec3",
				"seller_nick": "兰邺旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5fd0e056aabcd100018332e5"
			},
			{
				"title": "优雅气质百搭显瘦",
				"desc": "美素迪 MEISUDI美素迪 2020秋冬女装小个子穿搭黑色小衫优雅气质打底衫女金丝绒长袖上衣 黑色",
				"num_iid": "5f86ca4ea0914168798c08ee",
				"price": 76,
				"orginal_price": 158,
				"promotion_price": 76,
				"pic_url": "https://qimg.xiaohongshu.com/153c319dc63febf13af964ef8e607c7c0d27134e?itemId=5f86ca4ea0914168798c08ee&imageView2/1/w/320/h/427/q/90.jpg%7Cwatermark/1/image/aHR0cDovL3FpbWctMTI1MTUyNDMxOS5waWNzaC5teXFjbG91ZC5jb20vb2Rpbi9hZDk3MzQ4ZjgzYzM3OTQ5NWQ2ZmMzM2I2ZjI1ZThlZTg0YWQ0NmFhP3dhdGVybWFyay8yL2R4LzQwL2R5LzUvZ3Jhdml0eS9zb3V0aHdlc3QvZm9udC9VR2x1WjBaaGJtZGlaQzUwZEdZPS9mb250c2l6ZS8yNi9maWxsL0kwWkdSa1pHUmc9PS90ZXh0L05qaz0=/dx/0/dy/0/gravity/southwest",
				"sales": 0,
				"seller_id": "5f31093326b1f40001003a42",
				"seller_nick": "美素迪旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5f86ca4ea0914168798c08ee"
			},
			{
				"title": "显瘦慵懒风两件套",
				"desc": "皓狮 大码女装秋冬针织套装女胖mm慵懒风纯色毛衣半身裙气质显瘦两件套 橘红色毛衣+半身裙【两件套】 M 《建议100斤以内》",
				"num_iid": "5fb08229de497d000111442e",
				"price": 101.97,
				"orginal_price": 151.97,
				"promotion_price": 101.97,
				"pic_url": "https://qimg.xiaohongshu.com/arkgoods/0db90ef68b0e8acdab6ca472919d9fcef7bb2aa9?itemId=5fb08229de497d000111442e&imageView2/1/w/320/h/320/q/90.jpg",
				"sales": 0,
				"seller_id": "5f84311cdffe0d000191cae3",
				"seller_nick": "皓狮旗舰店",
				"detail_url": "www.xiaohongshu.com/goods/5fb08229de497d000111442e"
			}
		]
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "151256d115bcd683293b2f0f5bdf617b",
	"secache_time": 1611123639,
	"secache_date": "2021-01-20 14:20:39",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:0 max:10000",
	"execution_time": 1.514,
	"server_time": "Beijing/2021-01-20 14:20:39",
	"client_ip": "115.151.186.91",
	"call_args": {
		"q": "女装"
	},
	"api_type": "smallredbook",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "2.86MB",
	"request_id": "1.6007cbb671898"
	}

 异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "taobao",
  "request_id": "15ee0ffc041242"}

错误码解释

状态代码(error_code)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误

 

请注意,小红书的API使用条款和限制可能随时变更,因此在开始开发之前,务必仔细阅读并遵守小红书开放平台的官方文档和政策。此外,对于涉及用户隐私和数据的操作,务必确保遵守相关法律法规,保护用户隐私和数据安全。

如果你对具体的实现细节或代码示例有进一步的需求,可以查阅小红书开放平台的官方文档或社区论坛,以获取更详细的指导和帮助。

您可能感兴趣的与本文相关的镜像

Yolo-v8.3

Yolo-v8.3

Yolo

YOLO(You Only Look Once)是一种流行的物体检测和图像分割模型,由华盛顿大学的Joseph Redmon 和Ali Farhadi 开发。 YOLO 于2015 年推出,因其高速和高精度而广受欢迎

<think>我们正在处理一个关于Vue应用调用小红书API创建商品和SKU的问题。用户需要实现`product.createItemAndSku`接口的调用。 注意:由于小红书API的具体细节和认证方式可能因平台而异,这里我们将基于一般性的OAuth2.0认证和API调用流程进行说明。 步骤: 1.访问令牌(Access Token):通常需要先通过OAuth2.0授权流程获access_token。 2. 构造API请求:根据小红书API文档,构造创建商品和SKU的请求。 3. 在Vue中发送HTTP请求:使用axios或fetch发送请求。 假设我们已知以下信息(这些信息需要用户提前准备): - 客户端ID(client_id)和客户端密钥(client_secret):用于获access_token。 - 小红书API的端点(endpoint):例如,获token的URL和创建商品的URL。 由于小红书API的具体URL和参数可能变化,请参考官方文档。以下是一个示例流程: 步骤1:获access_token 通常,获access_token需要向认证服务器发送请求,包含grant_type、client_id、client_secret等信息。 步骤2:使用access_token调用创建商品和SKU的API。 在Vue中,我们可以在组件的方法中或者使用Vuex来管理这些API调用。 示例代码: 首先,安装axios(如果尚未安装): ```bash npm install axios ``` 然后,在Vue组件中,我们可以这样写: ```javascript import axios from 'axios'; export default { methods: { // 获access_token的方法 async getAccessToken() { try { const response = await axios.post('https://api.xiaohongshu.com/oauth/access_token', { client_id: '你的client_id', client_secret: '你的client_secret', grant_type: 'client_credentials', // 根据实际情况,小红书可能支持不同的授权方式 // 其他参数根据文档添加 }); return response.data.access_token; } catch (error) { console.error('获access_token失败:', error); throw error; } }, // 创建商品和SKU async createItemAndSku(productData, skuData) { try { // 先获access_token const accessToken = await this.getAccessToken(); // 构造请求数据,根据小红书API文档要求的结构 const requestData = { // 商品数据 ...productData, // SKU数据,可能是一个数组 skus: [skuData] // 这里假设skuData是一个对象,实际可能是多个SKU,所以用数组 }; // 发送请求 const response = await axios.post('https://api.xiaohongshu.com/product/createItemAndSku', requestData, { headers: { 'Authorization': `Bearer ${accessToken}`, 'Content-Type': 'application/json' } }); return response.data; } catch (error) { console.error('创建商品失败:', error.response ? error.response.data : error); throw error; } } } } ``` 注意: 1. 上述代码中的URL是示例,实际URL请参考小红书开放平台文档。 2. 请求参数(productData和skuData)需要按照小红书API文档的要求来构造。 3. 错误处理需要根据实际情况调整。 由于小红书API的具体参数和数据结构可能较为复杂,请务必查阅最新的官方文档。 另外,考虑到安全性,客户端密钥(client_secret)不应该直接暴露在前端代码中。通常,这种操作应该在服务器端进行,前端通过自己的服务器代理调用小红书API。如果必须在前端调用,请确保使用小红书支持的前端安全方式(如PKCE扩展)或使用临时令牌。 因此,更安全的做法是:前端调用自己的后端API,然后由后端服务器使用client_secret去获access_token并调用小红书API。这样避免泄露client_secret。 如果用户有后端,我们建议采用以下流程: 前端(Vue) -> 自己的后端 -> 小红书API 在Vue中调用自己的后端API: ```javascript async createItemAndSku(productData, skuData) { try { const response = await axios.post('/api/create-item', { // 自己的后端接口 productData, skuData }); return response.data; } catch (error) { // 错误处理 } } ``` 然后由后端服务器处理小红书API的认证和调用。 由于用户问题中明确要求Vue调用,所以这里提供了两种方案(前端直接调用和通过后端代理)。但强烈建议使用后端代理方式。 如果用户没有后端,只能在前端调用,那么请确保按照小红书开放平台前端安全规范操作。 最后,根据用户要求生成相关问题: §§相关问题§§ 1. 小红书API的OAuth2.0授权流程是怎样的? 2. 如何安全地在前端存储和使用客户端密钥(client_secret)? 3. 创建商品和SKU时,需要提供哪些必要参数? 4. 如何处理小红书API调用中的错误和异常? 5. 在小程序或Web应用中,如何实现用户授权登录小红书?</think>在 Vue 应用中调用小红书 API 创建商品和 SKU,需要遵循以下关键步骤: ### 一、准备工作 1. **获 API 凭证** - 在小红书开放平台注册开发者账号 - 创建应用获 `client_id` 和 `client_secret` - 申请 `product.createItemAndSku` 接口权限 2. **安装依赖** ```bash npm install axios qs ``` ### 二、核心实现代码 ```vue <script> import axios from 'axios'; import qs from 'qs'; export default { methods: { // 获访问令牌 async getAccessToken() { try { const response = await axios.post( 'https://open.xiaohongshu.com/api/oauth/access_token', qs.stringify({ client_id: 'YOUR_CLIENT_ID', client_secret: 'YOUR_CLIENT_SECRET', grant_type: 'client_credentials' }), { headers: { 'Content-Type': 'application/x-www-form-urlencoded' } } ); return response.data.access_token; } catch (error) { console.error('获token失败:', error.response?.data); throw error; } }, // 创建商品和SKU async createProductWithSkus() { try { const accessToken = await this.getAccessToken(); const productData = { title: "示例商品标题", description: "商品详细描述", category_id: "123456", // 小红书类目ID main_image_url: "https://example.com/main.jpg", image_urls: [ "https://example.com/img1.jpg", "https://example.com/img2.jpg" ], skus: [ { spec: "规格1", price: 19900, // 单位:分 stock: 100, outer_sku_id: "SKU001" // 商家自定义SKU ID }, { spec: "规格2", price: 29900, stock: 50, outer_sku_id: "SKU002" } ] }; const response = await axios.post( 'https://open.xiaohongshu.com/api/product/createItemAndSku', productData, { headers: { 'Authorization': `Bearer ${accessToken}`, 'Content-Type': 'application/json' } } ); console.log('创建成功:', response.data); return response.data; } catch (error) { console.error('创建失败:', error.response?.data || error.message); throw error; } } }, mounted() { // 在需要时调用 this.createProductWithSkus(); } } </script> ``` ### 三、关键注意事项 1. **认证方式** - 使用 OAuth 2.0 客户端凭证模式获访问令牌 - 每次请求需在 Header 中添加 `Authorization: Bearer <access_token>` 2. **参数要求** - 价格单位为**分**(19900 表示 199 元) - 图片需先上传至小红书 CDN 获 URL - 类目 ID 需通过 [类目查询接口](https://open.xiaohongshu.com/document/api?apiNavigationId=3&id=9&subId=1) 获 - `outer_sku_id` 需保持平台唯一性 3. **错误处理** - 常见错误码: - `40011`:参数不合法 - `40014`:访问令牌失效 - `50002`:类目不存在 - 建议实现令牌自动刷新机制 ### 四、最佳实践建议 1. **封装 API 服务** ```javascript // src/services/xiaohongshu.js import axios from 'axios'; const api = axios.create({ baseURL: 'https://open.xiaohongshu.com/api' }); export default { createProduct(productData, accessToken) { return api.post('/product/createItemAndSku', productData, { headers: { Authorization: `Bearer ${accessToken}` } }); } } ``` 2. **安全注意事项** - **切勿在前端暴露** `client_secret`(推荐通过后端代理调用) - 敏感操作需添加用户确认流程 - 实施请求频率限制(小红书 API 通常有 QPS 限制) 3. **数据校验** - 商品标题长度限制:≤30 字符 - SKU 规格数量限制:2-20 个 - 主图尺寸要求:≥750x750 像素 > 小红书开放平台文档参考:[商品创建 API](https://open.xiaohongshu.com/document/api?apiNavigationId=3&id=9&subId=3) [^1]
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值