如何将Facebook-Python-Ads-SDK返回的Cursor对象转为JSON/CSV格式？

我之前在做Facebook广告报告自动化的时候也踩过这个Cursor的坑，给你梳理几个实用的解决步骤：

先搞懂Cursor对象的本质 #

Facebook Ads SDK返回的Cursor不是直接的JSON数据，而是一个迭代器对象，里面每个元素是AdReportStats类的实例，所以直接用pd.read_json()肯定会报错——它根本不是JSON字符串！

步骤1：把Cursor转成Python字典列表 #

每个AdReportStats实例都有一个._json属性，能直接拿到对应的字典格式数据。用列表推导式就能快速把整个Cursor转成字典列表：

# 假设cursor_result是你获取到的Cursor对象
report_records = [item._json for item in cursor_result]

这一步之后，report_records就是标准的Python字典列表，后续处理就简单了。

步骤2：转成JSON格式 #

用Python内置的json模块就能轻松转换并保存：

import json

# 转成JSON字符串
json_data = json.dumps(report_records, indent=2)

# 写入JSON文件
with open('ad_group_report.json', 'w', encoding='utf-8') as f:
    json.dump(report_records, f, indent=2, ensure_ascii=False)

步骤3：导入Pandas DataFrame或转CSV #

不用再绕pd.read_json()了，直接把字典列表传给DataFrame构造器就行：

import pandas as pd

# 直接生成DataFrame
df = pd.DataFrame(report_records)

# 如果有嵌套字段（比如campaign、adset的详情），可以用json_normalize扁平化
from pandas import json_normalize
df_flat = json_normalize(report_records)

# 导出CSV
df_flat.to_csv('ad_group_report.csv', index=False, encoding='utf-8-sig')

关于export_format参数无效的说明 #

你提到的export_format参数其实是给异步报告API用的（比如创建报告后等待生成下载链接的那种模式），而用Cursor获取的是实时分页的同步数据，这个参数对Cursor模式完全不生效，所以之前设置了也没反应~

内容的提问来源于stack exchange，提问作者R.Z.