按年份领取竞价分笔 Parquet 日包。仅有效专业版和旗舰版可用：专业版为当前日期往前一年内的已发布日包，旗舰版为所选年份全部已发布日包；每年返回一个分享，目录按日期排列。覆盖以实际发布文件为准，回填中和待核查文件不开放。文件名 YYYYMMDD_aucde.parquet，使用 ZSTD 压缩，可用 DuckDB、pandas 或 Polars 读取。
POST
/apiapiname:file_download生产专线（默认）深圳
http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apiname | string（file_download） | 必选 | file_download | 固定接口名称，用于选择对应的数据能力。 |
apikey | string | 必选 | — | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。 |
params | object | 必选 | {"data_type":"auction_tick","year":2026} | 查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。 |
params 参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
data_type | string（auction_tick） | 必选 | auction_tick | 竞价分笔文件。 |
year | integer | 必选 | 2026 | 2022年至当前年份，实际可下载范围以已发布文件为准。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
code | integer | — | — | 200可用，1002无数据，403无权限，422参数错误，503暂不可用 |
message | string | — | — | 返回字段 |
data | object|null | — | — | 返回字段 |
请求与响应样例
固定样例
{
"apiname": "file_download",
"apikey": "YOUR_API_KEY",
"params": {
"data_type": "auction_tick",
"year": 2026
}
}{
"code": 200,
"message": "success",
"data": {
"code": 0,
"message": "string",
"data": {
"status": "ready",
"data_type": "auction_tick",
"year": 2026,
"start_date": "string",
"end_date": "string",
"file_count": 0,
"size_bytes": 0,
"url": "string",
"password": "string",
"expires_at": "string",
"retry_after": 0
}
}
}