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	租赁情况