# JD.com Auction Scraper 京东拍卖 - Judicial & Asset Auctions (`zen-studio/jd-com-auction-scraper`) Actor

Scrape JD.com 京东拍卖 judicial and asset auctions: court real-estate disposals, appraisal price, deposit, hammer price 成交价, and bid results on ended lots. Filter by vertical, category, region, court, price, and time. Export JSON, CSV, Excel.

- **URL**: https://apify.com/zen-studio/jd-com-auction-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.79 / 1,000 listing results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## JD.com Auction Scraper 京东拍卖 | Judicial Real Estate, 成交价 and Asset Data (2026)

<blockquote style="border-left:4px solid #4C945E;background:#F0FDF4;padding:12px 16px;margin:12px 0">
<span style="font-size:16px;font-weight:700;color:#1C1917">60+ fields per lot:</span> <span style="font-size:15px;color:#57534E">appraisal 评估价, deposit 保证金, the hammer price 成交价 on ended lots, the full bid ladder, court contact, and the complete 竞买须知 notice. The most complete 京东拍卖 auction data on Apify.</span>
</blockquote>

<a href="https://console.apify.com/actors/XePvxjJMvAiWJyODY/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/jd-com-auction-scraper-hero.png" alt="JD.com (京东拍卖) judicial auction scraper: appraisal, deposit, hammer price 成交价, bid ladder, and court contact as structured JSON" style="max-width:100%"></a>

<table>
<tr>
<td colspan="4" style="padding:10px 14px;background:#4C945E;border:none;border-radius:4px 4px 0 0">
<span style="color:#FAFAF9;font-size:14px;font-weight:700;letter-spacing:0.5px">Zen Studio China Auctions</span>
<span style="color:#E8F5E9;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Judicial auctions and marketplace data from JD and Taobao</span>
</td>
</tr>
<tr>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;background:#D3EDD9;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/jd-com-auction-scraper" style="color:#4C945E;text-decoration:none;font-weight:700;font-size:14px">JD Auction 京东拍卖</a><br>
<span style="color:#4C945E;font-size:12px;font-weight:600">&#10148; You are here</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#E8F5E9;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-8iQPEMryER2Nldfen-vgv7NeG1LN-____-scraper-logo.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/taobao-judicial-auction-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Ali Auction 阿里拍卖</a><br>
<span style="color:#78716C;font-size:12px">Taobao judicial auctions</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#E8F5E9;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/jd-com-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">JD Search 京东</a><br>
<span style="color:#78716C;font-size:12px">Products, prices, reviews</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;background:#E8F5E9;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/taobao-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Taobao 淘宝</a><br>
<span style="color:#78716C;font-size:12px">Products, SKUs, reviews</span>
</td>
</tr>
</table>

Scrape **JD.com 京东拍卖** (JD Auction) judicial and asset auctions at scale: court real-estate disposals, bankruptcy and financial asset sales, vehicles, equity, and more. Get the appraisal price, deposit, starting price, live bid ladder, and the final hammer price 成交价 on ended lots, plus the court or disposal agency, contact phones, location, images, and the official 竞买须知 notice. Built for auction analysts, real-estate researchers, distressed-asset investors, and legal-tech teams who need structured 京东拍卖 data instead of clicking through listings by hand.

#### Copy to your AI assistant

```text
zen-studio/jd-com-auction-scraper on Apify. Scrapes JD.com 京东拍卖 judicial and asset auctions with appraisal, deposit, hammer price 成交价, bid ladder, and the 竞买须知 notice. Call ApifyClient("TOKEN").actor("zen-studio/jd-com-auction-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. city takes a numeric cityId from the enum, not a name. Full spec: GET https://api.apify.com/v2/acts/zen-studio~jd-com-auction-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations
````

### Key Features

- **60+ fields per lot**: appraisal 评估价, deposit 保证金, starting price 起拍价, the hammer price 成交价, full bid ladder, court contact, coordinates, all images, and the 竞买须知 notice.
- **成交价 on ended lots**: capture the final result and pass-in 流拍 rate next to the appraisal, so you can measure discount and premium across thousands of closed lots.
- **Filter without Chinese**: pick the auction round 拍次 (second auction 二拍 is where the discounts are), a searchable city (457 cities, type the pinyin), and a court by name.
- **Lossless output**: curated fields get clean names; every remaining source field is preserved under `_raw` and `detailRaw`, so nothing is dropped.
- **Free tier**: 5 runs, 20 lots per run.

### How to Scrape JD.com 京东拍卖 Auctions

Set the auction vertical and category, then narrow with the filters below. Leave the defaults to get judicial real-estate auctions.

#### Basic: judicial real estate, ended lots with 成交价

```json
{
    "source": "judicial",
    "status": "ended",
    "maxItems": 100
}
```

#### Second-auction bargains in one city

```json
{
    "source": "judicial",
    "status": "ended",
    "auctionRound": "second",
    "city": "1607",
    "maxItems": 200
}
```

#### Lots from one specific court

```json
{
    "source": "judicial",
    "court": "北京市朝阳区人民法院",
    "status": "all",
    "maxItems": 200
}
```

The `city` value is picked from the dropdown (type a pinyin name such as `Shenzhen` or `Chaoyang`). The `court` value is a name or a fragment; it resolves to the closest matching organization. Turn `enrichDetail` off for cheaper list-only rows.

### Input Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `searchKeyword` | string | *(blank)* | Narrow lots by term (`住宅`, `别墅`, `厂房`, `写字楼`). Blank returns the full set. |
| `source` | string | `judicial` | Auction vertical: judicial 司法, criminal-case, bankruptcy, financial, commercial, state-owned, government, customs, rural, featured, self-disposal, or all. |
| `category` | string | `real_estate` | Real estate 房产 (default), a single property type, vehicles, equity, land, and more, or all. |
| `status` | string | `all` | All, upcoming 预告, ongoing 进行中, or ended 已结束 (where the 成交价 lives). |
| `sort` | string | `default` | Default, price ascending / descending, most bids, or recently ended. |
| `auctionRound` | string | `all` | First 一拍, **second 二拍** (deepest discounts), third 三拍, or negotiated sale 变卖. |
| `city` | string | *(blank)* | Searchable city or district (457 options, type the pinyin name). |
| `province` / `district` | string | *(blank)* | Optional coarser or finer location. |
| `court` | string | *(blank)* | Court or agency by name (`北京市朝阳区人民法院` or just `朝阳`). |
| `priceMin` / `priceMax` | integer | *(blank)* | Current-price band in CNY (¥). |
| `endingWithin` / `startingWithin` | integer | *(blank)* | Only lots ending or starting within N days. |
| `financingAvailable` / `noPurchaseRestriction` / `reAuctionOnly` | boolean | `false` | Toggle 贷款, 不限购, and 流拍再拍 filters. |
| `enrichDetail` | boolean | `true` | Add per-lot detail (start price, bid ladder, contact, notice, images). |
| `includeDescription` | boolean | `false` | Also fetch the attribute table 标的物属性 as HTML. |
| `maxItems` | integer | `20` | How many lots to return. |

### What Data Can You Extract from JD.com 京东拍卖?

Each row combines the list result with optional per-lot detail:

- **Result and pricing**: `currentPrice` and the hammer price 成交价 (`trxPrice`) on ended lots, `startPrice` 起拍价, `assessmentPrice` 评估价, `ensurePrice` 保证金, `minPrice`, `auctionOutcome` (`sold` / `passed_in` 流拍), `bidCount`, `bidList` bid ladder, `paimaiTimes` (auction round).
- **Views and applicants**: `accessNum` 围观, `accessEnsureNum` 报名, `uvCount`, `currentBidUserNumber`.
- **Lot and location**: `title`, `auctionStatus`, `startTime`, `endTime`, `province`, `city`, `productAddress`, `lat`, `lng`.
- **Court and contact**: `shopName` (the court or disposal agency), `consultName`, `consultTel` (the contact phone), `resolutionAgency` (the disposal agency and its other lots), `albumName`.
- **Documents and media**: `noticeHtml` the full 竞买须知, `descriptionHtml` the attribute table, `images` (thumbnail and full-size URLs), `detailUrl`.
- **Lossless**: every remaining source field under `_raw` and `detailRaw`.

#### Output Example

```json
{
  "paimaiId": 304712000,
  "title": "江苏省常熟市东南大道138号湖畔现代城S4幢房产及其土地使用权",
  "auctionStatus": 2,
  "displayStatus": 1,
  "auctionOutcome": "sold",
  "paimaiTimes": 2,
  "startPrice": 37540000,
  "currentPrice": 48015000,
  "trxPrice": 48015000,
  "currentPriceCN": "4801.5万",
  "currentPriceStr": "48,015,000",
  "assessmentPrice": 67024100,
  "assessmentPriceCN": "6702.41万",
  "ensurePrice": 7508000,
  "minPrice": 37540000,
  "marketPriceCN": "",
  "jdPrice": 0,
  "bidCount": 1416,
  "bidPersonCount": 0,
  "currentBidUserNumber": "226213463",
  "accessNum": 6264,
  "accessEnsureNum": 4,
  "uvCount": 3733,
  "stockNum": 1,
  "remainTime": 0,
  "province": "江苏",
  "city": "苏州市",
  "productAddress": "常熟市东南大道138号湖畔现代城S4幢房产及其土地使用权",
  "lat": "31.603029182361764",
  "lng": "120.77678144059715",
  "startTime": 1708135200000,
  "endTime": 1708244130000,
  "shopName": "肇庆市端州区人民法院",
  "consultName": "京东拍卖小组",
  "consultTel": "0758-2721931",
  "resolutionAgency": [{ "orgName": "...", "paimaiId": 304712001 }],
  "albumName": "肇庆市端州区人民法院司法拍卖",
  "noticeHtml": "<p style=\"text-align:center;line-height:35px\">竞买须知 ...</p>",
  "descriptionHtml": null,
  "labelSet": [1058, 1027, 1052],
  "loan": 0,
  "purchaseRestriction": 0,
  "customs": 0,
  "publishSource": 7,
  "publishSourceName": "court",
  "auctionType": 5,
  "platType": 0,
  "albumId": 3716604,
  "categoryId": 13809,
  "commission": null,
  "specialNotice": "",
  "productId": 10025299657147,
  "skuId": 10096147372968,
  "shopId": 637271,
  "vendorId": 641561,
  "detailUrl": "https://paimai.jd.com/304712000",
  "images": [
    { "path": "jfs/t1/176189/30/41455/...", "thumbUrl": "https://img30.360buyimg.com/n1/...", "fullUrl": "https://img30.360buyimg.com/popWareDetail/..." }
  ],
  "bidList": [
    { "bidTime": 1708243830000, "price": 48015000, "username": "226213463", "isPrior": 0 }
  ],
  "searchRank": 1,
  "scrapedAt": "2026-07-23T14:33:55.716928Z",
  "_detailEnriched": true,
  "pvCount": 8016,
  "ipCount": 5241,
  "moneyRecordCount": 0,
  "detailRaw": { "basic": {}, "realtime": {}, "vendor": {}, "notice": "...", "album": {}, "imageVideoArea": {}, "floorAreaResultList": [] }
}
```

This 苏州 court property closed at ¥48.0M against a ¥67.0M appraisal (a 28% discount) after 1,416 bids, a second-auction 二拍 lot. Every top-level field above appears in each row; empty fields stay present for a stable schema.

### Advanced Usage

Ready-made configurations for judicial monitoring, valuation comps, distressed-asset sourcing, and second-auction bargain hunting.

#### Daily judicial monitor for one province

```json
{
    "source": "judicial",
    "province": "广东",
    "endingWithin": 3,
    "sort": "recently_ended"
}
```

#### Valuation comps: 起拍价 to 成交价 across ended lots

```json
{
    "source": "judicial",
    "category": "residential",
    "status": "ended",
    "sort": "most_bids",
    "maxItems": 1000
}
```

#### Distressed assets ending soon

```json
{
    "source": "bankruptcy",
    "status": "ongoing",
    "endingWithin": 7
}
```

#### Financing-eligible second auctions

```json
{
    "source": "judicial",
    "auctionRound": "second",
    "financingAvailable": true,
    "noPurchaseRestriction": true
}
```

### Pricing

Pay per result. You are billed for each auction row returned, and separately for each detail enrichment when it is enabled.

| Event | Price |
|---|---|
| Auction listing | **$4.99 / 1,000 lots** |
| Detail enrichment (add-on) | **$2.99 / 1,000 lots** |

Volume discounts apply automatically at higher tiers. Turn `enrichDetail` off for listing-only rows at the lower rate. **Free tier: 5 runs, 20 lots per run.**

### FAQ

**What is JD.com 京东拍卖 (JD Auction)?**
京东拍卖 is JD.com's auction platform (paimai.jd.com), best known for judicial 司法拍卖 sales run by the People's Courts 人民法院, alongside bankruptcy, financial, government, and other asset disposals. This actor turns those public listings into structured rows, including the final hammer price on lots that have closed.

**What is the 成交价 (hammer price)?**
The 成交价 is the winning price a lot actually sold for, available once the auction has ended. Placed next to the 起拍价 (starting price) and 评估价 (appraisal), it lets you measure the discount or premium. About 93% of lots on the platform are already ended, so this is a strong source for historical price research as well as live tracking.

**How do I find second-auction 二拍 bargains?**
Set `auctionRound` to `second`. A second auction is a lot relisted after a first-round pass-in, usually at a lower starting price, so it is where the deepest discounts appear. Combine it with a `city` and a `priceMax` to target a specific market.

**Can I filter by city or court without reading Chinese?**
Yes. The city field is a searchable dropdown of 457 cities and districts labeled in pinyin, type `Shenzhen` or `Chaoyang`. The court field takes a name or fragment (`朝阳`) and resolves to the closest matching organization; the run log shows which court matched.

**How complete is the bid ladder?**
The `bidList` field holds the most recent bids for a lot (roughly the last ten), not the entire bidding history. The total `bidCount` is always exact.

**How do I export the data?**
Export JSON, CSV, Excel, XML, or HTML from the run's Storage tab, or via the Apify API. JSON preserves the nested `bidList`, `images`, `resolutionAgency`, and `detailRaw` fields best.

**What is the free tier?**
5 runs with up to 20 lots each. Paid plans remove both caps.

**Is it legal to scrape JD.com auction data?**
This actor collects only publicly available auction listings; it does not access private, personal, or authentication-protected information. You are responsible for complying with JD.com's terms and applicable data-protection law, including China's PIPL and, where relevant, the GDPR or CCPA. Court notices and contact fields may contain personal data, handle them accordingly.

**Do you also scrape JD.com products or Taobao auctions?**
Yes, JD.com products, prices, and reviews are in the [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper), and Taobao (Ali) judicial auctions are in the [Taobao Judicial Auction Scraper](https://apify.com/zen-studio/taobao-judicial-auction-scraper).

### More Zen Studio scrapers for Chinese platforms

**🛒 E-commerce & auctions**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **JD 京东**
  - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-8iQPEMryER2Nldfen-vgv7NeG1LN-____-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Ali 阿里拍卖 (judicial auctions)**
  - [Taobao Judicial Auction Scraper](https://apify.com/zen-studio/taobao-judicial-auction-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Taobao 淘宝**
  - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper)
  - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper)
  - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **1688 阿里巴巴**
  - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Goofish 闲鱼**
  - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper)
  - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper)

**🏠 Real estate & autos**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Anjuke 安居客**
  - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper)
  - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper)
  - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper)
  - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-32OkWqsiUywoq2ci3-7JhFlW1qg3-58__-real-estate-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **58.com 58同城**
  - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ytaE4YpSmjXDmibPv-L1UMPHa2bO-che168-autohome-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Autohome 汽车之家**
  - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-car-scraper)

**🎬 Short-video & social**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Douyin 抖音**
  - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper)
  - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper)
  - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper)
  - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper)
  - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper)
  - [Douyin Creator Rankings Scraper](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper)
  - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder)
  - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-mHKEEgoDqr6btQQer-fUs5ZquIeN-xiaohongshu-search-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **RedNote 小红书**
  - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper)
  - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper)
  - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-dexCSKEZtKS8hg4fT-lD4weyiYga-shigua-____-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Xigua 西瓜视频**
  - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper)
  - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper)

### Support

- **Bugs**: Issues tab
- **Features**: Issues tab

### Legal Compliance

Extracts publicly available auction listings only. Users must comply with JD.com's terms and applicable data-protection law, including China's PIPL and, where relevant, the GDPR and CCPA. Court notices and contact fields may contain personal data.

***

*JD.com 京东拍卖 auction scraper: judicial and asset auctions with appraisal, deposit, 成交价, bid ladder, court contact, and the full 竞买须知 notice.*

# Actor input Schema

## `searchKeyword` (type: `string`):

Optional keyword to narrow the auctions.<br><br>Examples:<br>• <code>住宅</code> residential<br>• <code>别墅</code> villa<br>• <code>厂房</code> factory / industrial<br>• <code>写字楼</code> office<br><br>Leave blank to return all auctions in the selected vertical and category.

## `source` (type: `string`):

Choose the disposal vertical. <b>Judicial 司法/诉讼资产</b> (court disposals, the default) matches sales run by the People's Courts 人民法院. Widen to bankruptcy, financial, government, and other asset verticals, or pick <b>All</b> for every vertical.

## `category` (type: `string`):

Asset category. <b>Real estate 房产</b> (residential, commercial, industrial, and other property) is the default. Pick a single property type, a non-property category such as vehicles or equity, or <b>All categories</b>.

## `status` (type: `string`):

Filter by auction stage. <b>All</b> returns every stage. <b>Ended 已结束</b> is where the hammer price 成交价 and final bid result are available.

## `sort` (type: `string`):

Order the results. Most bids surfaces the most contested lots; recently ended surfaces the newest results.

## `auctionRound` (type: `string`):

Filter by auction round. <b>Second auction 二拍</b> is where the deepest discounts appear (a lot relisted after a first-round pass-in). <b>Negotiated sale 变卖</b> is a fixed-price listing.

## `priceMin` (type: `integer`):

Optional minimum current price in Chinese yuan (¥). Leave blank for no lower bound.

## `priceMax` (type: `integer`):

Optional maximum current price in Chinese yuan (¥). Leave blank for no upper bound.

## `endingWithin` (type: `integer`):

Return only auctions ending within this many days from today. Useful for a daily incremental of lots about to close. Leave blank to ignore.

## `startingWithin` (type: `integer`):

Return only upcoming auctions starting within this many days from today. Leave blank to ignore. Set only one of ending or starting within.

## `financingAvailable` (type: `boolean`):

Only lots that offer buyer financing 贷款.

## `noPurchaseRestriction` (type: `boolean`):

Only lots with no purchase restriction 不限购, buy without a local purchase qualification.

## `reAuctionOnly` (type: `boolean`):

Only lots relisted for re-auction after a previous pass-in 流拍.

## `province` (type: `string`):

Optional province to narrow by location, for example <code>广东</code>, <code>山东</code>, <code>浙江</code>. Combine with city and district to narrow further.

## `city` (type: `string`):

Pick a city (or a district for the municipalities 北京/上海/天津/重庆). Type the pinyin name to filter, for example <code>Shenzhen</code> or <code>Chaoyang</code>. When set, this narrows past Province on its own.

## `district` (type: `string`):

Optional district or county name within the selected city, for example <code>朝阳区</code>. Requires a city.

## `court` (type: `string`):

Optional court or disposal-agency <b>name</b> to return only that organization's lots, for example <code>北京市朝阳区人民法院</code> or just a fragment like <code>朝阳</code>. Leave blank for all organizations.

## `enrichDetail` (type: `boolean`):

Keep enabled to add per-lot 详情: starting price 起拍价, appraisal 评估价, deposit 保证金, full bid ladder, applicant and view counts, the court contact phone, the disposal agency, the court bidding notice 竞买须知, coordinates, and all images. Turn off for cheaper list-only rows.

## `includeDescription` (type: `boolean`):

Also fetch the rich attribute table (area, floor, layout, orientation, deed, tenancy, transfer notes) as HTML. Off by default to keep enrichment lean.

## `maxItems` (type: `integer`):

Maximum number of auction rows to return. Default <code>20</code>. Test runs are capped at <code>5</code>. Free-tier runs are capped at <code>20</code>.

## `maxPages` (type: `integer`):

Optional hard cap on how many result pages to scan. Leave <code>0</code> for no page cap (bounded by Max auctions).

## Actor input object example

```json
{
  "source": "judicial",
  "category": "real_estate",
  "status": "all",
  "sort": "default",
  "auctionRound": "all",
  "financingAvailable": false,
  "noPurchaseRestriction": false,
  "reAuctionOnly": false,
  "province": "",
  "city": "",
  "enrichDetail": true,
  "includeDescription": false,
  "maxItems": 20,
  "maxPages": 0
}
```

# Actor output Schema

## `results` (type: `string`):

Link to the dataset containing all scraped JD.com auction rows.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchKeyword": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/jd-com-auction-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchKeyword": "" }

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/jd-com-auction-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchKeyword": ""
}' |
apify call zen-studio/jd-com-auction-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zen-studio/jd-com-auction-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "JD.com Auction Scraper 京东拍卖 - Judicial & Asset Auctions",
        "description": "Scrape JD.com 京东拍卖 judicial and asset auctions: court real-estate disposals, appraisal price, deposit, hammer price 成交价, and bid results on ended lots. Filter by vertical, category, region, court, price, and time. Export JSON, CSV, Excel.",
        "version": "0.0",
        "x-build-id": "v6TH6sCN7AJ0Mw6z7"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/zen-studio~jd-com-auction-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-zen-studio-jd-com-auction-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/zen-studio~jd-com-auction-scraper/runs": {
            "post": {
                "operationId": "runs-sync-zen-studio-jd-com-auction-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/zen-studio~jd-com-auction-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-zen-studio-jd-com-auction-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchKeyword": {
                        "title": "关键词 Keyword",
                        "type": "string",
                        "description": "Optional keyword to narrow the auctions.<br><br>Examples:<br>• <code>住宅</code> residential<br>• <code>别墅</code> villa<br>• <code>厂房</code> factory / industrial<br>• <code>写字楼</code> office<br><br>Leave blank to return all auctions in the selected vertical and category."
                    },
                    "source": {
                        "title": "处置类型 Auction vertical",
                        "enum": [
                            "judicial",
                            "criminal_case",
                            "bankruptcy",
                            "financial",
                            "commercial",
                            "state_owned",
                            "government",
                            "customs",
                            "rural",
                            "featured",
                            "self_disposal",
                            "all"
                        ],
                        "type": "string",
                        "description": "Choose the disposal vertical. <b>Judicial 司法/诉讼资产</b> (court disposals, the default) matches sales run by the People's Courts 人民法院. Widen to bankruptcy, financial, government, and other asset verticals, or pick <b>All</b> for every vertical.",
                        "default": "judicial"
                    },
                    "category": {
                        "title": "标的分类 Category",
                        "enum": [
                            "real_estate",
                            "residential",
                            "commercial_property",
                            "industrial_property",
                            "other_property",
                            "vehicles",
                            "vessels",
                            "equity",
                            "debt",
                            "mineral_rights",
                            "land",
                            "machinery",
                            "intangible_assets",
                            "intellectual_property",
                            "luxury",
                            "jewelry",
                            "electronics",
                            "all"
                        ],
                        "type": "string",
                        "description": "Asset category. <b>Real estate 房产</b> (residential, commercial, industrial, and other property) is the default. Pick a single property type, a non-property category such as vehicles or equity, or <b>All categories</b>.",
                        "default": "real_estate"
                    },
                    "status": {
                        "title": "拍卖状态 Status",
                        "enum": [
                            "all",
                            "upcoming",
                            "ongoing",
                            "ended"
                        ],
                        "type": "string",
                        "description": "Filter by auction stage. <b>All</b> returns every stage. <b>Ended 已结束</b> is where the hammer price 成交价 and final bid result are available.",
                        "default": "all"
                    },
                    "sort": {
                        "title": "排序 Sort",
                        "enum": [
                            "default",
                            "price_asc",
                            "price_desc",
                            "most_bids",
                            "recently_ended"
                        ],
                        "type": "string",
                        "description": "Order the results. Most bids surfaces the most contested lots; recently ended surfaces the newest results.",
                        "default": "default"
                    },
                    "auctionRound": {
                        "title": "拍次 Auction round",
                        "enum": [
                            "all",
                            "first",
                            "second",
                            "third",
                            "negotiated_sale"
                        ],
                        "type": "string",
                        "description": "Filter by auction round. <b>Second auction 二拍</b> is where the deepest discounts appear (a lot relisted after a first-round pass-in). <b>Negotiated sale 变卖</b> is a fixed-price listing.",
                        "default": "all"
                    },
                    "priceMin": {
                        "title": "最低价 Min price (CNY ¥)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Optional minimum current price in Chinese yuan (¥). Leave blank for no lower bound."
                    },
                    "priceMax": {
                        "title": "最高价 Max price (CNY ¥)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Optional maximum current price in Chinese yuan (¥). Leave blank for no upper bound."
                    },
                    "endingWithin": {
                        "title": "结束于 N 天内 Ending within (days)",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Return only auctions ending within this many days from today. Useful for a daily incremental of lots about to close. Leave blank to ignore."
                    },
                    "startingWithin": {
                        "title": "开始于 N 天内 Starting within (days)",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Return only upcoming auctions starting within this many days from today. Leave blank to ignore. Set only one of ending or starting within."
                    },
                    "financingAvailable": {
                        "title": "可贷款 Financing available",
                        "type": "boolean",
                        "description": "Only lots that offer buyer financing 贷款.",
                        "default": false
                    },
                    "noPurchaseRestriction": {
                        "title": "不限购 No purchase restriction",
                        "type": "boolean",
                        "description": "Only lots with no purchase restriction 不限购, buy without a local purchase qualification.",
                        "default": false
                    },
                    "reAuctionOnly": {
                        "title": "流拍再拍 Re-auction only",
                        "type": "boolean",
                        "description": "Only lots relisted for re-auction after a previous pass-in 流拍.",
                        "default": false
                    },
                    "province": {
                        "title": "省份 Province",
                        "enum": [
                            "",
                            "北京",
                            "上海",
                            "天津",
                            "重庆",
                            "河北",
                            "山西",
                            "河南",
                            "辽宁",
                            "吉林",
                            "黑龙江",
                            "内蒙古",
                            "江苏",
                            "山东",
                            "安徽",
                            "浙江",
                            "福建",
                            "湖北",
                            "湖南",
                            "广东",
                            "广西",
                            "江西",
                            "四川",
                            "海南",
                            "贵州",
                            "云南",
                            "西藏",
                            "陕西",
                            "甘肃",
                            "青海",
                            "宁夏",
                            "新疆",
                            "台湾",
                            "港澳"
                        ],
                        "type": "string",
                        "description": "Optional province to narrow by location, for example <code>广东</code>, <code>山东</code>, <code>浙江</code>. Combine with city and district to narrow further.",
                        "default": ""
                    },
                    "city": {
                        "title": "城市 City",
                        "enum": [
                            "",
                            "72",
                            "2800",
                            "2801",
                            "2802",
                            "2805",
                            "2806",
                            "2807",
                            "2808",
                            "2809",
                            "2810",
                            "2812",
                            "2814",
                            "2816",
                            "2901",
                            "2953",
                            "3065",
                            "78",
                            "2813",
                            "2815",
                            "2817",
                            "2822",
                            "2823",
                            "2824",
                            "2825",
                            "2826",
                            "2830",
                            "2833",
                            "2834",
                            "2835",
                            "2837",
                            "2841",
                            "2919",
                            "51035",
                            "51036",
                            "51037",
                            "51038",
                            "51039",
                            "51040",
                            "51041",
                            "51042",
                            "51043",
                            "51044",
                            "51045",
                            "51046",
                            "51047",
                            "51048",
                            "51049",
                            "51050",
                            "51051",
                            "51052",
                            "113",
                            "114",
                            "115",
                            "119",
                            "123",
                            "126",
                            "128",
                            "129",
                            "130",
                            "131",
                            "132",
                            "133",
                            "134",
                            "135",
                            "136",
                            "137",
                            "138",
                            "139",
                            "140",
                            "141",
                            "4164",
                            "48131",
                            "48132",
                            "48133",
                            "48201",
                            "48202",
                            "48203",
                            "48204",
                            "48205",
                            "48206",
                            "48207",
                            "50950",
                            "50951",
                            "50952",
                            "50953",
                            "50954",
                            "50995",
                            "51026",
                            "629403",
                            "142",
                            "148",
                            "164",
                            "199",
                            "224",
                            "239",
                            "248",
                            "258",
                            "264",
                            "274",
                            "275",
                            "146760",
                            "303",
                            "309",
                            "318",
                            "325",
                            "330",
                            "336",
                            "350",
                            "368",
                            "379",
                            "398",
                            "3074",
                            "412",
                            "420",
                            "427",
                            "438",
                            "446",
                            "454",
                            "458",
                            "468",
                            "475",
                            "482",
                            "489",
                            "495",
                            "502",
                            "517",
                            "527",
                            "538",
                            "549",
                            "2780",
                            "560",
                            "573",
                            "579",
                            "584",
                            "589",
                            "593",
                            "598",
                            "604",
                            "609",
                            "613",
                            "617",
                            "621",
                            "632",
                            "6858",
                            "639",
                            "644",
                            "651",
                            "657",
                            "664",
                            "674",
                            "681",
                            "687",
                            "2992",
                            "698",
                            "712",
                            "727",
                            "731",
                            "737",
                            "742",
                            "753",
                            "757",
                            "765",
                            "773",
                            "776",
                            "782",
                            "793",
                            "799",
                            "805",
                            "810",
                            "812",
                            "823",
                            "835",
                            "848",
                            "870",
                            "880",
                            "891",
                            "895",
                            "902",
                            "904",
                            "911",
                            "919",
                            "925",
                            "933",
                            "939",
                            "951",
                            "959",
                            "965",
                            "972",
                            "978",
                            "984",
                            "988",
                            "1000",
                            "1007",
                            "1016",
                            "1022",
                            "1025",
                            "1032",
                            "1042",
                            "1053",
                            "1060",
                            "1072",
                            "1081",
                            "1090",
                            "1099",
                            "1108",
                            "1112",
                            "2900",
                            "1114",
                            "1116",
                            "1121",
                            "1124",
                            "1127",
                            "1132",
                            "1137",
                            "1140",
                            "1151",
                            "1159",
                            "1167",
                            "1174",
                            "1180",
                            "1201",
                            "1206",
                            "2971",
                            "1158",
                            "1213",
                            "1233",
                            "1243",
                            "1250",
                            "1255",
                            "1262",
                            "1273",
                            "1280",
                            "1290",
                            "1298",
                            "1303",
                            "1315",
                            "1317",
                            "1329",
                            "1332",
                            "1341",
                            "1352",
                            "1362",
                            "1370",
                            "1381",
                            "1387",
                            "1396",
                            "1405",
                            "1413",
                            "1421",
                            "1432",
                            "1441",
                            "1458",
                            "1466",
                            "1475",
                            "1477",
                            "1479",
                            "2922",
                            "2980",
                            "2983",
                            "3154",
                            "1482",
                            "1488",
                            "1495",
                            "1501",
                            "1511",
                            "1522",
                            "1530",
                            "1540",
                            "1544",
                            "1555",
                            "1560",
                            "1574",
                            "1586",
                            "1592",
                            "1601",
                            "1607",
                            "1609",
                            "1611",
                            "1617",
                            "1627",
                            "1634",
                            "1643",
                            "1650",
                            "1655",
                            "1657",
                            "1659",
                            "1666",
                            "1672",
                            "1677",
                            "1684",
                            "1690",
                            "1698",
                            "1704",
                            "1705",
                            "1709",
                            "1715",
                            "1720",
                            "1726",
                            "1740",
                            "1746",
                            "1749",
                            "1753",
                            "1757",
                            "1761",
                            "1792",
                            "1806",
                            "1818",
                            "3044",
                            "3168",
                            "1827",
                            "1832",
                            "1836",
                            "1842",
                            "1845",
                            "1857",
                            "1861",
                            "1874",
                            "1885",
                            "1898",
                            "1911",
                            "1930",
                            "1946",
                            "1950",
                            "1954",
                            "1960",
                            "1962",
                            "1977",
                            "1983",
                            "1988",
                            "1993",
                            "2005",
                            "2016",
                            "2022",
                            "2033",
                            "2042",
                            "2047",
                            "2058",
                            "2065",
                            "2070",
                            "2084",
                            "2103",
                            "2121",
                            "3034",
                            "3115",
                            "3137",
                            "3173",
                            "3690",
                            "3698",
                            "3699",
                            "3701",
                            "3702",
                            "3703",
                            "3704",
                            "3705",
                            "3706",
                            "3707",
                            "3708",
                            "3709",
                            "3710",
                            "3711",
                            "2144",
                            "2150",
                            "2155",
                            "2169",
                            "2180",
                            "2189",
                            "2196",
                            "2205",
                            "2222",
                            "2235",
                            "2247",
                            "2258",
                            "2270",
                            "2281",
                            "2291",
                            "2298",
                            "2304",
                            "2309",
                            "2318",
                            "2332",
                            "2336",
                            "2347",
                            "2360",
                            "2366",
                            "4108",
                            "2951",
                            "3107",
                            "3129",
                            "3138",
                            "3144",
                            "3970",
                            "3971",
                            "2376",
                            "2386",
                            "2390",
                            "2402",
                            "2416",
                            "2428",
                            "2442",
                            "2454",
                            "2468",
                            "2476",
                            "2487",
                            "2492",
                            "2495",
                            "2501",
                            "2509",
                            "2518",
                            "2525",
                            "2534",
                            "2544",
                            "2549",
                            "2556",
                            "2564",
                            "2573",
                            "3080",
                            "2580",
                            "2585",
                            "2592",
                            "2597",
                            "2603",
                            "2605",
                            "2612",
                            "2620",
                            "2628",
                            "2632",
                            "2637",
                            "2644",
                            "3071",
                            "2652",
                            "2654",
                            "2656",
                            "2658",
                            "2662",
                            "2666",
                            "2675",
                            "2686",
                            "2699",
                            "2704",
                            "2714",
                            "2723",
                            "2727",
                            "2736",
                            "2744",
                            "4110",
                            "15945",
                            "15946",
                            "53090",
                            "53668",
                            "129142",
                            "145492",
                            "146206",
                            "629552",
                            "629554",
                            "2768",
                            "52994",
                            "52995"
                        ],
                        "type": "string",
                        "description": "Pick a city (or a district for the municipalities 北京/上海/天津/重庆). Type the pinyin name to filter, for example <code>Shenzhen</code> or <code>Chaoyang</code>. When set, this narrows past Province on its own.",
                        "default": ""
                    },
                    "district": {
                        "title": "区县 District",
                        "type": "string",
                        "description": "Optional district or county name within the selected city, for example <code>朝阳区</code>. Requires a city."
                    },
                    "court": {
                        "title": "法院/机构 Court or agency",
                        "type": "string",
                        "description": "Optional court or disposal-agency <b>name</b> to return only that organization's lots, for example <code>北京市朝阳区人民法院</code> or just a fragment like <code>朝阳</code>. Leave blank for all organizations."
                    },
                    "enrichDetail": {
                        "title": "详情信息 Detail enrichment (default on)",
                        "type": "boolean",
                        "description": "Keep enabled to add per-lot 详情: starting price 起拍价, appraisal 评估价, deposit 保证金, full bid ladder, applicant and view counts, the court contact phone, the disposal agency, the court bidding notice 竞买须知, coordinates, and all images. Turn off for cheaper list-only rows.",
                        "default": true
                    },
                    "includeDescription": {
                        "title": "标的物属性 Attribute table",
                        "type": "boolean",
                        "description": "Also fetch the rich attribute table (area, floor, layout, orientation, deed, tenancy, transfer notes) as HTML. Off by default to keep enrichment lean.",
                        "default": false
                    },
                    "maxItems": {
                        "title": "拍卖数量 Max auctions",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Maximum number of auction rows to return. Default <code>20</code>. Test runs are capped at <code>5</code>. Free-tier runs are capped at <code>20</code>.",
                        "default": 20
                    },
                    "maxPages": {
                        "title": "最大页数 Max pages",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Optional hard cap on how many result pages to scan. Leave <code>0</code> for no page cap (bounded by Max auctions).",
                        "default": 0
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
