pmsearch.jd.com APIpmsearch.jd.com ↗
Retrieve judicial auction item details and full bid histories from JD Paimai. Covers pricing, timing, bid counts, and anonymized bidder records via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/79a07681-12da-4ca7-bb65-159b16b09dfd/get_item_detail?item_id=%3Cpaimai_item_id%3E' \ -H 'X-API-Key: $PARSE_API_KEY'
Get details for a specific auction item by its paimai ID. Returns pricing, status, timing, location, and other auction metadata. Combines data from the basic info and real-time data APIs.
| Param | Type | Description |
|---|---|---|
| item_idrequired | string | The unique paimaiId of the auction item (numeric string, e.g. '310131146'). |
{
"type": "object",
"fields": {
"title": "string, auction item title/description",
"end_time": "integer, auction end time as Unix timestamp in milliseconds",
"location": "string, auction round prefix (e.g. '一拍' for first auction)",
"bid_count": "integer, total number of bids placed",
"paimai_id": "string, the auction item ID",
"vendor_id": "integer, the court/vendor organization ID",
"access_num": "integer, number of views/visits",
"start_time": "integer, auction start time as Unix timestamp in milliseconds",
"category_id": "integer, the auction category ID",
"start_price": "number, starting auction price in CNY",
"ensure_price": "number, deposit/guarantee amount required in CNY",
"bid_increment": "number or null, minimum bid increment in CNY",
"building_area": "string or null, building area in square meters if applicable",
"current_price": "number, current highest bid price in CNY",
"auction_status": "integer, numeric auction status code",
"assessment_price": "number, assessed/appraised value in CNY",
"auction_status_text": "string or null, human-readable auction status name"
},
"sample": {
"data": {
"title": "天津市宝坻区广阳路与双站路西南交口处云栖花园4号楼-2-201号不动产",
"end_time": 1771727844000,
"location": "一拍",
"bid_count": 44,
"paimai_id": "310131146",
"vendor_id": 639321,
"access_num": 3652,
"start_time": 1771639200000,
"category_id": 12728,
"start_price": 661755.08,
"ensure_price": 80000,
"bid_increment": null,
"building_area": null,
"current_price": 751755.08,
"auction_status": 2,
"assessment_price": 945364.39,
"auction_status_text": null
},
"status": "success"
}
}About the pmsearch.jd.com API
This API provides access to judicial auction data from JD Paimai (paimai.jd.com) across 2 endpoints. The get_item_detail endpoint returns 10 structured fields per auction item, including start price in CNY, auction start and end timestamps, bid count, view count, and the presiding court's vendor ID. A second endpoint, get_bid_records, returns the complete bid history with per-bid timestamps, prices, and anonymized usernames.
Auction Item Details
The get_item_detail endpoint accepts a item_id — a numeric string matching the auction's paimaiId on JD Paimai — and returns metadata for that listing. Response fields include title (the item description), start_price and bid_count, Unix millisecond timestamps for start_time and end_time, and location which encodes the auction round as a Chinese-language prefix (e.g., 一拍 for first auction, 二拍 for second). The vendor_id field identifies the issuing court or organization, and category_id classifies the asset type. access_num reflects total listing views.
Bid History
The get_bid_records endpoint returns a bids array for the same item_id. Each element in the array contains a bidTime (Unix millisecond timestamp), price (in CNY), and username (an anonymized bidder identifier as displayed on the platform). For auction items that have received no bids yet, the endpoint returns an empty bids array rather than an error, so callers can safely poll active listings without special-casing the zero-bid state.
Coverage and Scope
Both endpoints cover judicial auctions listed on JD Paimai, which handles court-ordered asset liquidations including real estate, vehicles, and other property across mainland China. The location field and vendor_id field together allow callers to segment listings by auction round and originating court, which is useful for tracking assets that have failed to sell and re-entered at a lower starting price.
- Monitor judicial real estate auctions and alert when
start_pricedrops between auction rounds indicated bylocation - Track bid velocity on active auctions by polling
get_bid_recordsand comparingbid_countover time - Aggregate court-specific auction activity by grouping items on
vendor_idto analyze which courts are most active - Build a bid history timeline using
bidTimeandpricefields to visualize price escalation during live auctions - Identify low-competition assets by querying
get_item_detailfor items wherebid_countis zero nearend_time - Calculate auction engagement ratios by comparing
access_num(views) againstbid_countper listing
| 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 JD Paimai have an official developer API?+
What does the `location` field in `get_item_detail` actually represent?+
location field encodes the auction round as a Chinese-language prefix. A value of 一拍 means first auction, 二拍 means second auction (a re-listing after the first failed to sell), and so on. This lets you identify assets that are being re-auctioned, typically at a reduced starting price.Does the API return the evaluated or appraised value of an auction asset?+
start_price (the opening bid in CNY) but do not expose a separate court-appraised or evaluated valuation field. You can fork this API on Parse and revise it to add that field if the source listing exposes an appraisal figure.Are bidder identities fully exposed in `get_bid_records`?+
username field in each bid record is an anonymized identifier as displayed by JD Paimai — it is not a full name or verified identity. The API returns whatever anonymized label the platform assigns to each bidder.Does the API support searching or listing auctions by category, region, or court?+
item_id. It does not provide a search or browse endpoint to discover items by category_id, vendor_id, or geographic region. You can fork this API on Parse and revise it to add a search endpoint covering those filters.