引言

孔夫子旧书网作为国内知名的二手书交易平台，提供了丰富的API接口，允许开发者通过编程方式获取在售商品及已售商品的信息。本文将详细介绍如何使用孔夫子旧书网的API接口，通过关键字获取已售商品的详细信息。

API接口概述

孔夫子旧书网的API接口包括多个功能模块，其中 item_search用于获取在售商品，而 item_search_sold则专门用于获取已售商品的信息。以下是关于获取已售商品的接口的详细说明。

公共参数

• key：调用key，必须以GET方式拼接在URL中。
• secret：调用密钥。
• api_name：API接口名称（包括在请求地址中），如 item_search、 item_get、 item_search_sold等。
• cache：默认为 yes，将调用缓存的数据，速度比较快。
• result_type：返回数据格式，默认为 json，可选 jsonu、 xml、 serialize、 var_export。
• lang：翻译语言，默认为 cn简体中文。
• version：API版本  。

请求参数

• q：搜索关键字。
• page：页数。
• sort：排序方式，可选 normal（综合）、 publish（最早出版）、 _publish（最新出版）、 up（最新上架）、 price_fee（价格从低到高）、 _price_fee（价格从高到低）、 price（价格从低到高，不含运费）、 _price（价格从高到低，不含运费）  。

响应参数

孔夫子旧书网API接口返回的数据结构通常包含以下字段：

• items：按关键字搜索的商品列表。
• page：页码。
• real_total_results：商品数量。
• total_results：商品数量。
• page_size：接口返回数量。
• pagecount：总页数。
• item：商品详情数组  。

示例返回值结构

json{
  "items": [
    {
      "item": {
        "title": "商品标题",
        "price": "商品价格",
        "stock": "库存数量"
      }
    }
  ],
  "page": 1,
  "real_total_results": 289,
  "total_results": 289,
  "page_size": 50,
  "pagecount": 6}

请注意，以上信息是基于提供的搜索结果整理的，实际的API接口和返回值可能会有所不同，具体请参考孔夫子旧书网的官方API文档 。