Java 实战：调用 item_search_tmall 按关键词搜索天猫商品

<!-- HTTP --><dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.12.0</version></dependency><!-- JSON --><dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.43</version></dependency>

@Datapublic class TmallSearchReq {
    private String key;
    private String secret;
    private String q;           // 关键词
    private int page = 1;
    private int pageSize = 20;  // 最大 40
    private String sort;        // sale_desc | price_asc | price_desc
    private String filter;      // tmall
    private String startPrice;
    private String endPrice;}

public class TmallSearchService {

    private static final String API = "https://api-gw.onebound.cn/taobao/item_search_tmall";

    public static JSONObject search(TmallSearchReq req) throws IOException {
        HttpUrl.Builder ub = HttpUrl.parse(API).newBuilder();
        ub.addQueryParameter("key", req.getKey());
        ub.addQueryParameter("secret", req.getSecret());
        ub.addQueryParameter("q", req.getQ());
        ub.addQueryParameter("page", String.valueOf(req.getPage()));
        ub.addQueryParameter("page_size", String.valueOf(req.getPageSize()));
        if (req.getSort() != null) ub.addQueryParameter("sort", req.getSort());
        if (req.getFilter() != null) ub.addQueryParameter("filter", req.getFilter());
        if (req.getStartPrice() != null) ub.addQueryParameter("start_price", req.getStartPrice());
        if (req.getEndPrice() != null) ub.addQueryParameter("end_price", req.getEndPrice());

        Request httpReq = new Request.Builder()
                .url(ub.build())
                .get()
                .header("Accept-Encoding", "gzip")
                .build();

        try (Response resp = new OkHttpClient().newCall(httpReq).execute()) {
            String json = resp.body().string();
            JSONObject root = JSON.parseObject(json);
            if (!"200".equals(root.getString("code"))) {
                throw new RuntimeException("API 错误：" + root.getString("msg"));
            }
            return root.getJSONObject("items");
        }
    }}

{
  "code": 200,
  "items": {
    "page": "1",
    "page_size": 20,
    "total_results": 842,
    "item": [
      {
        "num_iid": "723971306902",
        "title": "iPhone15 液态硅胶手机壳",
        "pic_url": "//g-search3.alicdn.com/img/imgextra/...jpg",
        "price": "28.8",
        "orginal_price": "88.0",
        "sales": 3200,
        "shop_type": "天猫",
        "detail_url": "https://detail.tmall.com/item.htm?id=723971306902"
      }
      // ... 19 more
    ]
  }}

public class Demo {
    public static void main(String[] args) throws Exception {
        TmallSearchReq req = new TmallSearchReq();
        req.setKey("你的key");
        req.setSecret("你的secret");
        req.setQ("空气净化器");
        req.setPage(1);
        req.setPageSize(20);
        req.setSort("sale_desc");   // 销量降序
        req.setFilter("tmall");     // 仅天猫

        JSONObject result = TmallSearchService.search(req);
        JSONArray list = result.getJSONArray("item");
        list.forEach(o -> {
            JSONObject l = (JSONObject) o;
            System.out.println(
                l.getString("num_iid") + "\t" +
                l.getString("title") + "\t" +
                l.getBigDecimal("price") + "\t" +
                l.getInteger("sales"));
        });
    }}

723971306902	iPhone15 液态硅胶手机壳	28.8	3200
...