wiki/skills/jd-fapai-scrape/url_structure.md

# 京东法拍房搜索 URL 结构说明

## 一、URL 总体结构

```
https://pro.m.jd.com/mall/active/{activityId}/index.html?{query_params}
```

| 部分 | 值 | 说明 |
|------|-----|------|
| 协议/域名 | `https://pro.m.jd.com` | 京东移动端 H5 活动页服务器 |
| 路径 | `/mall/active/3Rja7L2jmC72Ta8eoa31VFDvaAjf/index.html` | 活动 ID，对应司法拍卖（法拍）频道首页 |

> **最小可用 URL**：路径中的活动 ID 本身就标识了法拍频道，即使不带任何查询参数也能打开法拍首页。

---

## 二、查询参数详解

### 2.1 页面上下文参数（控制页面渲染状态）

| 参数 | 示例值 | 必填 | 说明 |
|------|--------|------|------|
| `pageParam` | `judicature_icon_search_after` | ✅ | 页面状态：从司法图标搜索进入结果页 |
| `pageFrom` | `judicature_search_home` | ✅ | 来源页面：司法搜索首页 |
| `tabParam` | `all` | ✅ | 当前 Tab："all" = 全部 |
| `pageParamMiddle` | `judicature_search_middle` | ✅ | 中间页参数（SSR 渲染需要） |
| `fixSearchParams` | `false` | ❌ | 是否固定搜索条件 |
| `navh` | `49` | ❌ | 导航栏高度（px） |
| `stath` | `33` | ❌ | 状态栏高度（px） |

### 2.2 搜索条件参数（`spo_` 前缀，核心筛选字段）

| 参数 | 示例值 | 必填 | 说明 |
|------|--------|------|------|
| `spo_keyword` | `塘厦` | ✅ | **搜索关键词**（URL 编码） |
| `spo_sortField` | `11` | ✅ | **排序字段**：`11` = 按最新发布排序 |
| `spo_multiThirdCateIds` | `15` | ✅ | **类目 ID**：`15` = 法拍房 |
| `spo_lat` | `22.599037` | ✅ | 定位纬度（影响搜索结果） |
| `spo_lng` | `114.01689` | ✅ | 定位经度（影响搜索结果） |
| `spo_lbsEffect` | `2` | ✅ | LBS 效果模式 |
| `spo_reqSource` | `1` | ✅ | 请求来源标识 |

### 2.3 设备/位置信息（`tttparams`，base64 编码 JSON）

原始值是一段 base64 编码，解码后为 JSON 对象，包含：

| 字段 | 示例值 | 说明 |
|------|--------|------|
| `addressId` | `138503600` | 京东地址 ID |
| `d_brand` | `HONOR` | 手机品牌 |
| `model` | `VER-AN10` | 手机型号 |
| `gLat` / `gLng` | `22.623829` / `114.027948` | GPS 定位 |
| `lbsLat` / `lbsLng` | `22.600537` / `114.014698` | LBS 基站定位 |
| `gps_area` | `19_1607_3155_62119` | GPS 区域编码（省_市_区_街道） |
| `un_area` | `19_1607_47388_62139` | 用户区域编码 |
| `scale` | `3` | 屏幕缩放 |
| `os` | `16` | 系统版本 |

> 区域编码 `19_1607_3155_62119` 对应：广东(19)_深圳(1607)_塘厦镇(3155)

### 2.4 时间戳

| 参数 | 示例值 | 说明 |
|------|--------|------|
| `_ts` | `1788869426803` | 毫秒级时间戳 |

### 2.5 UTM 分享/推广追踪

| 参数 | 示例值 | 说明 |
|------|--------|------|
| `utm_user` | `plusmember` | 用户身份 |
| `utm_source` | `androidapp` | 来源平台 |
| `utm_medium` | `appshare` | 分享媒介 |
| `utm_campaign` | `t_335139774` | 活动 ID |
| `utm_term` | `Wxfriends_shareid...` | 微信好友分享 ID |
| `ad_od` | `share` | 广告类型 |
| `gx` / `gxd` | `RnAonzoTNmGdh8lR5Q` / `...` | 京东内部追踪参数 |

---

## 三、完整 URL（脚本实际使用）

```
https://pro.m.jd.com/mall/active/3Rja7L2jmC72Ta8eoa31VFDvaAjf/index.html
  ?pageParamMiddle=judicature_search_middle
  &pageParam=judicature_icon_search_after
  &pageFrom=judicature_search_home
  &tabParam=all
  &fixSearchParams=false
  &navh=49
  &stath=33
  &tttparams=<base64编码的位置信息>
  &spo_lng=114.01689
  &spo_lbsEffect=2
  &spo_reqSource=1
  &spo_multiThirdCateIds=15
  &spo_lat=22.599037
  &spo_keyword=塘厦
  &spo_sortField=11
```

> ⚠️ `tttparams`、`spo_lat`、`spo_lng` 等位置参数影响搜索结果范围。早期使用最小 URL 时会漏掉部分房源（如塘厦搜索漏掉 51 条）。

### 可替换的变量

| 变量 | 替换示例 | 说明 |
|------|----------|------|
| `spo_keyword` | `塘厦` → `长安` | 搜索其他镇/区域 |
| `spo_sortField` | `11`(最新) → 其他值 | 排序方式 |
| `spo_multiThirdCateIds` | `15`(法拍房) → 其他 | 法拍类目 |

---

## 四、排序字段 `spo_sortField` 已知值

| 值 | 排序方式 |
|----|----------|
| `11` | 按最新发布排序 |
| 其他值待补充 | — |

---

## 五、底层 API 接口

页面通过 JavaScript 动态加载数据，但**第一页数据通过 SSR 内嵌在 HTML 的 `<script>` 标签中**，不经过 API 调用。API 只负责 page 2 及之后的加载。

### 数据来源

| 来源 | 范围 | 获取方式 |
|------|------|----------|
| SSR 内嵌数据 | page 1（约 40 条） | 页面加载后从 `<script>` 标签解析 JSON |
| `getSearchData` API | page 2+ | `page.on("response")` 拦截 API 响应 |
| `getPaimaiCurrentInfoByIdsForApi` | 全部 | 实时拍卖状态（当前价、出价、围观） |
| `getAuctionLabelConfigs` | 部分可见项 | 拍卖标签（一拍、二拍、变卖等） |

> ⚠️ 如果只拦截 API 响应而不提取 SSR 数据，会漏掉 page 1 的全部房源（包括最新发布的房源）。

### API 请求格式

```
POST https://api.m.jd.com/api?appid=paimai&functionId=getSearchData&loginType=2
Content-Type: application/x-www-form-urlencoded

body=<URL编码的JSON>
```

> ⚠️ API 有风险控制（`shieldResult.intercept: true`），直接调用返回 "no access"。需通过浏览器渲染执行风险验证后方可获取数据。

### getSearchData 响应字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `paimaiId` | int | 拍卖 ID（唯一标识） |
| `skuId` | int | 商品 SKU ID |
| `title` | string | 房源标题/地址 |
| `startPrice` | float | 起拍价（元） |
| `currentPrice` | float | 当前价（元） |
| `currentPriceCN` | string | 当前价（中文，如"125.8945万"） |
| `discountRate` | float | 折扣率 |
| `paimaiStatus` | int | 拍卖状态：0=未开始, 1=进行中, 2=已结束, 3=已撤回 |
| `auctionType` | int | 拍卖类型：5=司法拍卖 |
| `location` | array | 位置信息 |
| `houseAttributes` | object | 房产属性（见下表） |
| `productImage` | string | 图片路径（CDN） |

### houseAttributes 子字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `houseTypeInfo` | string | 户型（如"4室1厅1卫"） |
| `housePurpose` | string | 用途（如"住宅"） |
| `houseArea` | float | 面积（㎡） |
| `plotName` | string | 小区名称 |
| `averagePrice` | string | 均价（如"8254.40元/平"） |
| `houseFloorInfo` | int | 楼层信息 |
| `houseEmpty` | int | 是否空置 |
| `houseCertificate` | int | 权属证书类型 |
| `houseLease` | int | 租赁情况 |