当前位置：首页 > ds >正文

Java 获取淘宝关键词搜索（item_search）API 接口实战指南

ds 2025/8/30 11:14:40

在电商领域，通过关键词搜索商品是常见的需求。淘宝开放平台提供了 taobao.items.search 接口，允许开发者根据关键词搜索商品，并获取商品列表。本文将详细介绍如何使用 Java 调用该接口，并解析返回的数据。

一、准备工作

1. 注册淘宝开放平台账号

在使用淘宝 API 之前，需要在淘宝开放平台注册成为开发者。注册过程中，你需要提供一些基本信息，如联系方式、公司名称等。

2. 创建应用并获取 API 密钥

登录开发者账号后，创建一个新的应用，并为其申请调用 taobao.items.search 接口的权限。在申请时，你需要提供关于你的应用的详细信息，包括应用名称、应用描述、使用场景等。同时，确保你了解并遵守阿里巴巴的使用协议和规定。申请通过后，你将获得 App Key 和 App Secret，这两个凭证后续会用于身份验证。

3. 安装必要的 Java 库

在开始编写代码之前，确保你的开发环境已安装以下库：

HttpClient：用于发送 HTTP 请求。
Jackson 或 Gson：用于解析 JSON 数据。

如果还未安装，可以通过以下命令安装：

mvn install:install-file -Dfile=commons-httpclient-3.1.jar -DgroupId=commons-httpclient -DartifactId=commons-httpclient -Dversion=3.1 -Dpackaging=jar
mvn install:install-file -Dfile=gson-2.8.6.jar -DgroupId=com.google.code.gson -DartifactId=gson -Dversion=2.8.6 -Dpackaging=jar

二、调用 API 接口

1. 构建请求

一旦你获得了 API 密钥，就可以开始构建请求来获取搜索结果。以下是一个示例代码，展示了如何使用 HttpClient 库来调用 taobao.items.search API 接口。

java

import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.List;
import java.util.Map;public class TaobaoAPI {private static final String API_URL = "https://gw.api.taobao.com/router/rest";public static void main(String[] args) {String appKey = "YOUR_APP_KEY";String appSecret = "YOUR_APP_SECRET";String keyword = "女装";String response = getItemSearchResults(keyword, appKey, appSecret);if (response != null) {parseSearchResults(response);}}public static String getItemSearchResults(String keyword, String appKey, String appSecret) {try (CloseableHttpClient client = HttpClients.createDefault()) {String timestamp = java.time.LocalDateTime.now().toString();String sign = generateSign(appSecret, keyword, timestamp);HttpGet request = new HttpGet(API_URL + "?method=taobao.items.search&app_key=" + appKey +"&timestamp=" + timestamp + "&v=2.0&format=json&sign_method=md5&q=" + keyword +"&fields=num_iid,title,pict_url,price,nick,seller_id&sign=" + sign);String responseBody = EntityUtils.toString(client.execute(request).getEntity());return responseBody;} catch (Exception e) {e.printStackTrace();return null;}}public static String generateSign(String appSecret, String keyword, String timestamp) {String paramStr = "app_keyYOUR_APP_KEYformatjsontimestamp" + timestamp + "v2.0methodtaobao.items.searchq" + keyword +"fields=num_iid,title,pict_url,price,nick,seller_id";String signStr = appSecret + paramStr + appSecret;return md5(signStr).toUpperCase();}public static String md5(String input) {try {java.security.MessageDigest md = java.security.MessageDigest.getInstance("MD5");byte[] messageDigest = md.digest(input.getBytes());BigInteger no = new BigInteger(1, messageDigest);return no.toString(16);} catch (Exception e) {throw new RuntimeException(e);}}public static void parseSearchResults(String jsonResponse) {try {Gson gson = new Gson();Type type = new TypeToken<Map<String, Object>>(){}.getType();Map<String, Object> result = gson.fromJson(jsonResponse, type);if (result.containsKey("items_search_response")) {List<Map<String, Object>> items = (List<Map<String, Object>>) ((Map<String, Object>) result.get("items_search_response")).get("items");for (Map<String, Object> item : items) {System.out.println("商品标题: " + item.get("title"));System.out.println("价格: " + item.get("price"));System.out.println("图片 URL: " + item.get("pict_url"));}} else {System.out.println("请求失败，错误信息: " + result.get("error_response"));}} catch (Exception e) {e.printStackTrace();}}
}