《信用卡等金融产品的投诉类别、企业回应与处理结果(CFPB)》
想要"某家银行在信用卡账单争议上被投诉多少次、最后怎么处理"这类问题,最省事的入口是美国消费者金融保护局(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 算力按所用平台规则计算;附件按原帖条件获取;福利领取条件以活动页面为准。 |