拼多多根据关键词取商品列表 API 返回值说明

​

拼多多提供了根据关键词搜索商品列表的API接口，允许开发者通过关键词来获取相关的商品信息。以下是对该API返回值以及代码示例的详细说明：

返回值说明

拼多多根据关键词取商品列表的API返回值通常包含以下信息：

1. 关键词（keyword） ：用户搜索的关键词。

2. 页码（page） ：当前返回的商品列表页码。

3. 总结果数（total_results 或 real_total_results） ：根据关键词搜索到的商品总数。

4. 每页数量（list_count 或 page_size） ：每页返回的商品数量。

5. 商品列表（item） ：包含多个商品信息的数组，每个商品信息通常包括：

   • 商品标题（title） ：商品的名称。
   • 商品图片URL（pic_url 或 image_url） ：商品的图片地址。
   • 商品价格（price 或 original_price、promotion_price） ：商品的售价，可能包括原价和促销价。
   • 商品销量（sales） ：商品的销售数量。
   • 商品ID（num_iid） ：商品的唯一标识符。
   • 店铺昵称（seller_nick） ：出售该商品的店铺名称。
   • 商品详情页URL（detail_url） ：商品的详情页地址。

代码示例

以下是一个使用PHP调用拼多多根据关键词取商品列表API的代码示例：

php复制代码

	<?php
	// 请求参数设置
	$params = [
	'q' => '女装', // 关键词
	'start_price' => 0, // 起始价格
	'end_price' => 0, // 结束价格
	'page' => 1, // 页码
	'cat' => 0, // 分类ID（0表示不限制）
	'discount_only' => '', // 是否仅显示优惠商品（空字符串表示不限制）
	'sort' => '', // 排序方式（空字符串表示不排序）
	'page_size' => 20, // 每页数量
	];
	// API接口地址
	$apiUrl = "https://api-gw.onebound.cn/pinduoduo/item_search/?key=<您的API_KEY>&secret=<您的API_SECRET>";
	// 将请求参数拼接到URL中
	$url = $apiUrl . '&' . http_build_query($params);
	// 初始化cURL会话
	$ch = curl_init();
	// 设置cURL选项
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 忽略SSL证书验证（仅用于测试环境，生产环境请开启）
	curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); // 忽略主机名验证（仅用于测试环境，生产环境请开启）
	// 执行cURL请求并获取响应
	$response = curl_exec($ch);
	// 检查是否有错误发生
	if(curl_errno($ch)) {
	echo 'cURL Error: ' . curl_error($ch);
	} else {
	// 解析返回的JSON数据
	$data = json_decode($response, true);
	// 打印返回的数据
	print_r($data);
	}
	// 关闭cURL会话
	curl_close($ch);
	?>

注意：

1. 在实际使用时，请将<您的API_KEY>和<您的API_SECRET>替换为您在拼多多开放平台注册的开发者账号获取API密钥和密钥。
2. API接口的具体地址和参数可能会随着拼多多平台的更新而有所变化，请查阅拼多多开放平台的最新文档以获取准确信息。
3. 拼多多API有调用频率限制和权限限制，请确保您的请求符合拼多多的使用规范和政策。
4. 示例代码中的SSL证书验证被设置为忽略（CURLOPT_SSL_VERIFYPEER和CURLOPT_SSL_VERIFYHOST设置为false），这仅用于测试环境。在生产环境中，为了安全起见，请开启SSL证书验证。

通过以上代码和返回值说明，您可以根据关键词搜索到相关的商品列表，并根据需要进行处理和展示。

​