孔夫子旧书网 item_search_sold 接口开发应用指南

最新推荐文章于 2025-05-01 23:24:04 发布

Jelena15779585792

最新推荐文章于 2025-05-01 23:24:04 发布

阅读量594

点赞数 11

分类专栏：孔夫子API 文章标签：前端数据库 python

本文链接：https://blog.csdn.net/J15779585792/article/details/145910029

版权

孔夫子API 专栏收录该内容

2 篇文章

订阅专栏

在二手书交易领域，孔夫子旧书网作为国内知名的平台，提供了丰富的API接口，允许开发者通过关键字搜索已售商品的详细信息。这些接口为市场分析、商品研究以及数据挖掘提供了强大的支持。本文将详细介绍如何使用孔夫子旧书网的 item_search_sold 接口，通过关键字获取已售商品的信息，并提供开发指南和代码示例。

一、接口概述

item_search_sold 是孔夫子旧书网提供的一个API接口，专门用于搜索已售商品的详细信息。通过该接口，开发者可以获取商品的标题、价格、库存、销量等数据，这些信息对于市场分析、价格研究以及库存管理具有重要价值。

二、接口参数

以下是 item_search_sold 接口常用的请求参数：

参数名称	类型	是否必填	描述
`key`	String	是	调用密钥，必须以GET方式拼接在URL中
`secret`	String	是	注册账户获取密钥
`q`	String	是	搜索关键字
`page`	Int	否	页码，默认为1
`sort`	String	否	排序方式，如`normal`（综合）、`publish`（最早出版）、`_publish`（最新出版）等

三、响应参数

接口返回的数据结构通常包含以下字段：

字段名称	类型	描述
`items`	Array	按关键字搜索的已售商品列表
`page`	Int	当前页码
`real_total_results`	Int	实际搜索结果的总数
`total_results`	Int	返回结果的总数
`page_size`	Int	每页显示的结果数量
`pagecount`	Int	总页数

每个商品的详情信息包括标题、价格、库存等。

四、开发步骤

（一）注册与授权

注册开发者账号：访问孔夫子旧书网的开发者平台，注册一个账号。
创建应用：登录后，创建一个新的应用以获取API密钥（key）和调用密钥（secret）。

（二）构建请求

以下是使用Python调用 item_search_sold 接口的示例代码：

Python

import requests

def fetch_sold_books(keyword, page=1):
    """
    通过关键字获取孔夫子旧书网已售商品信息
    :param keyword: 搜索的关键字
    :param page: 页码，默认为1
    :return: 返回的JSON数据
    """
    api_key = 'YOUR_API_KEY'
    api_secret = 'YOUR_API_SECRET'
    url = f"https://api-gw.onebound.cn/kfz/item_search_sold?key={api_key}&secret={api_secret}&q={keyword}&page={page}"

    response = requests.get(url)
    if response.status_code == 200:
        data = response.json()
        return data
    else:
        print(f"请求失败，状态码：{response.status_code}")
        return None

# 示例：搜索关键字为"鲁迅"的已售书籍
keyword = '鲁迅'
sold_books = fetch_sold_books(keyword)
if sold_books:
    for book in sold_books['items']:
        print(f"书名：{book['title']}, 价格：{book['price']}, 库存：{book['stock']}")
else:
    print("未找到相关已售书籍")

代码说明：