search.kongfz.com APIsearch.kongfz.com ↗
Search China's largest used-book marketplace by ISBN or keyword. Get listings with price (RMB), condition, seller, and direct URLs from Kongfz (孔夫子旧书网).
curl -X GET 'https://api.parse.bot/scraper/09fd851c-4cb5-4831-992c-b905461c7f44/search_books' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for used book listings by keyword or ISBN. Returns all matching product listings with title, author, publisher, ISBN, price in RMB, condition/品相, seller/shop name, and direct listing URL. Results are paginated.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| keywordrequired | string | Search keyword — can be a book title, author name, or ISBN (e.g. '9787540418250' or '三体'). |
| page_size | integer | Number of results per page, between 1 and 50. |
{
"type": "object",
"fields": {
"page": "integer",
"keyword": "string",
"listings": "array of listing objects",
"page_size": "integer",
"total_found": "integer",
"total_pages": "integer"
},
"sample": {
"page": 1,
"keyword": "9787540418250",
"listings": [
{
"isbn": "9787540418250",
"price": 8,
"title": "国际商务英语常用词用法双解词典（私藏品好）",
"author": "翁凤翔 编著",
"item_id": 1203064268,
"shop_id": 196891,
"condition": "九品",
"image_url": "https://www0.kfzimg.com/G07/M00/5B/AC/q4YBAFyhhneAULqAAAJQ8Kiii_M458_n.jpg",
"publisher": "湖南文艺出版社",
"shop_area": "湖北省武汉市",
"shop_name": "闲情书屋",
"price_text": "8.00",
"description": "包正版，自然旧，内页无字无章无划痕",
"is_sold_out": false,
"listed_date": "2019-03-31 上书",
"listing_url": "https://book.kongfz.com/196891/1203064268",
"publish_date": "1998-12",
"condition_score": 90
}
],
"page_size": 50,
"total_found": 11,
"total_pages": 1
}
}About the search.kongfz.com API
The Kongfz search API covers the full product-listing surface of 孔夫子旧书网, China's largest secondhand book marketplace, through a single search_books endpoint that returns up to 8 fields per listing — including price in RMB, condition/品相, seller name, and direct listing URL. Queries accept a book title, author name, or bare ISBN-13, and results are paginated with total_found and total_pages so you can walk the full result set.
What the API returns
The search_books endpoint accepts a keyword string — this can be a Chinese title like 三体, an author name, or a numeric ISBN such as 9787540418250 — and returns a paginated list of active seller listings from Kongfz. Each listing object carries the book's title, author, publisher, ISBN, the listed price in Chinese Yuan (RMB), a condition rating (品相), the seller/shop name, and a direct URL to the individual listing page.
Pagination and filtering
Pagination is controlled by page (integer, defaults to 1) and page_size (1–50 results per page). The response envelope includes total_found and total_pages so you can calculate how many requests are needed to exhaust a result set. There is no server-side filter for price range or condition — those fields are returned in each listing object for you to filter client-side after retrieval.
Coverage and scope
Kongfz aggregates inventory from thousands of independent secondhand booksellers across China. ISBN-based searches are precise and useful for price-comparison workflows; keyword searches cast a broader net and may return editions, reprints, or works by different publishers sharing similar titles. All prices are denominated in RMB; currency conversion is not performed by the API.
- Compare asking prices across sellers for a specific ISBN before purchasing a used textbook.
- Track price fluctuations over time for a rare out-of-print Chinese title by polling the API periodically.
- Build a browser extension that shows Kongfz listings alongside new-book prices on other Chinese retail sites.
- Aggregate seller inventory counts per title to estimate secondhand supply depth for a reading list.
- Cross-reference returned ISBNs and publisher fields to identify edition variants of a given work.
- Alert collectors when a specific book appears at or below a target condition rating (品相) and price threshold.
- Populate a library catalog tool with real-time market valuations for used Chinese-language books.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Kongfz (孔夫子旧书网) have an official developer API?+
What exactly does each listing object in the search_books response contain?+
keyword, page, page_size, total_found, and total_pages.Can I filter results by price range or condition rating directly in the request?+
search_books endpoint does not accept price or condition as input parameters — those fields are returned per listing and must be filtered client-side. You can fork this API on Parse and revise it to add server-side filtering parameters if you need pre-filtered result sets.