发帖
雷达卡
想要"某家银行在信用卡账单争议上被投诉多少次、最后怎么处理"这类问题，最省事的入口是美国消费者金融保护局（CFPB）的公开投诉库。它不只是一张表，还是一个带查询参数的接口：按产品、时间段筛完直接返回 JSON，每个字段都能对得上业务含义。
库里有什么
| 项目 | 内容 |
| 全名 | CFPB Consumer Complaint Database |
| 覆盖 | 美国金融产品投诉，一件公开投诉为一条记录 |
| 当前总记录 | 18,855,389 条（接口元数据） |
| 时间基准 | 接口标注 last_updated 2026-11-02 |
| 许可 | CC0（接口元数据 license 字段） |
| 访问方式 | 网页检索界面与同名 JSON 接口，无需账号 |
一次实际查询的结果
用产品"信用卡"、时间 2026 年 9 月做筛选，返回的命中数是 8,573 条。抽三条看字段长什么样：
| 投诉 ID | 收到日期 | 问题 | 企业 | 企业回应 | 是否及时 |
| 29910704 | 2026-09-30 | Other features, terms, or problems | NAVY FEDERAL CREDIT UNION | In progress | Yes |
| 29430370 | 2026-09-28 | Struggling to pay your bill | WELLS FARGO & COMPANY | Closed with explanation | Yes |
| 29345821 | 2026-09-24 | Problem with a purchase shown on your statement | JPMORGAN CHASE & CO. | Closed with explanation | Yes |
每条记录共有 15 个字段：product、sub_product、issue、sub_issue、complaint_id、date_received、date_sent_to_company、company、company_response、company_public_response、state、zip_code、tags、submitted_via、timely。前四个是分类维度，complaint_id 是唯一键，两个日期分别是收到与转交企业的时间，后五个里 company_response 记处理结果、timely 记是否按时回应，state 与 zip_code 是投诉人所在地（zip 有部分打码）。
接口怎么调
接口路径固定在 search/api/v1/，后面跟查询串。四个参数就能控制一次查什么：product 指定产品，date_received_min 与 date_received_max 指定收到日期区间，size 控制返回条数，no_aggs=true 表示不要聚合结果、只要明细。完整地址放在下面币区，直接复制即可。
默认按分数排序，再加 sort 与 from 就能翻页。
真正做统计时要注意分页上限：一次拉几千条没问题，要拿全量就得按时间切片循环，每片控制在几千条以内，再用 complaint_id 去重。
用它做业务分析时的几个口径
第一，企业回应是分类变量而不是自由文本。常见取值有 In progress（处理中）、Closed with explanation（说明后关闭）等，做"解决率"时必须先决定把哪些取值算作关闭，别把 In progress 混进去。
第二，company_public_response 常常为空，有的企业声明不予公开回应。这一列空着不代表没处理，只代表没公开说明。
第三，投诉量不等于问题量。同一件事可能被同一人多次提交，也可能被转办后重复计数；跨企业比较前先用绝对量除以业务规模，否则大行天然占多。
第四，分类名是英文的固定词表。中文分析前先做一张对照表，把 product、issue、company_response 三列映射好，否则同一个概念会因为大小写或措辞不同被拆成两类。
许可与再分发
接口元数据里 license 字段写的是 CC0，即放弃版权、可自由使用；但库里是投诉人提交的内容，涉及个人信息，实际使用时去掉 zip_code 与 state 这类可定位字段更稳妥，公开发表时按汇总结果呈现，不逐条转载原始投诉。
先按上面那条 URL 取一页数据，看清 15 个字段，再决定要哪几列入库。
────────────────
回复本帖，可见接口地址与参数说明、字段清单与三条真实记录的原始 JSON，以及 CC0 许可与引用写法。
把经管之家装进你常用的 AI 智能体中 一键快捷安装经管之家 MCP／技能，让 AI 帮你查教程、找数据、读论坛帖子。 检索、阅读公开帖子不收费，安装可申请领取：3 通用积分＋100 论坛币＋3 元论坛资金 说明： AI 算力按所用平台规则计算；附件按原帖条件获取；福利领取条件以活动页面为准。 |
京公网安备 11010802022788号
