Facebook 公开数据 API

传入 Facebook 主页 url。已核实的 results 对象含名称、page_id、认证标记、粉丝数、分类、图片及 delegate_page.id、reels_page_id；部分联系与简介字段可为 null。普通 page_id 用于主页帖子，视频与 Reels 标识另行保存。无效链接曾返回缺少身份的 private_page，不能据此判断主页不存在或一定为私密主页。粉丝数是公开快照，不是触达人数或后台洞察。

使用主页详情确认的 page_id，首次不填 cursor。已核实响应含 results 与 cursor，帖子含 post_id、正文、数值时间戳、作者、评论数、反应数、转发数及可为空的媒体引用。保留 comments_id、shares_id，top_comments 只是预览。续查原样传回游标，设置请求上限并按帖子 ID 去重，不保证完整历史；start_date、end_date 的格式和行为仍需核实。

填写 query 查找主页候选，可选 location_uid 与 cursor。NASA 样本返回名称、facebook_id、链接、类型、is_verified 和带尺寸的图片对象，以及游标；先确认身份再使用。无匹配测试正常返回 results=[]、cursor=null，不应自动视为异常。续查使用同一搜索返回的非空游标；位置筛选与续查行为尚未单独核实。

提交 Facebook 主页 url，请求解析其 ID。此专用解析接口尚无代表性响应样本，不预设返回字段或包装结构；先核实结果，再用于帖子、评价等 ID 查询。如还需要名称、认证与粉丝数，可选择已有样本的主页详情接口。获得 ID 不表示所有主页内容均可公开访问。

填写 page_id 请求公开主页照片。按已列明的续查约定，下一页需同时传首次响应中的 cursor 与 collection_id，两者必须属于同一主页集合。本接口尚无响应样本，照片字段、包装与排序均需核实后再定义存储结构。可读照片不代表拥有下载、转载或训练权限，也不保证完整相册历史。

优先使用主页详情中的 reels_page_id；page_id 是保留的旧版输入，不能当作 Reels 集合标识替代。虽然字段约定将两者列为可选，推荐流程仍需有效集合 ID。cursor 用于续查。本接口尚无响应样本，不套用主页帖子字段；公开可见性不保证历史完整，也不赋予短视频再利用权。

必填 delegate_page_id，不能用普通 page_id 替代。已核实的主页详情含 delegate_page.id，主页帖子作者信息也出现过代理标识，应确认属于目标主页后使用。cursor 是已列明的续查参数。本视频接口尚无响应样本，不承诺具体字段、播放格式或视频数量；专用 ID 不能解锁私密视频。

传入商家 page_id，可选同一评价响应返回的 cursor。本接口已列入目录，但尚无响应样本，评价正文、日期、评分语义与结构都需核实。空结果或不可用不证明商家没有评价。持续监测、快照对比和主题分析由你的应用实现，不是内置情感分析功能。

传入 page_id 请求主页透明度记录。此接口尚无响应样本，不承诺管理位置、名称变化或其他来源背景字段；先检查实际返回内容并记录观察时间。透明度信息只供人工尽调参考，不是身份认证证书、自动风险分数或真实性保证。

必填 query，可选位置、近期、日期和游标。NASA 查询样本含官方帖子及相关报道，返回 results、cursor、帖子 ID、正文、时间、作者、互动计数和可为空的媒体引用；关键词相关不代表精确作者筛选。只核实了关键词请求，日期格式、位置、recent_posts 与续查行为仍待验证，不能把结果当作全站提及总量。

提供 post_id 或 post_url，两者同时传入时 post_id 优先。按链接查询时清空未使用的 ID，避免覆盖目标。本接口尚无响应样本，不承诺详情字段或包装；衔接评论与转发前，先核实返回的专用标识，不假定它们等于帖子 ID。内容不可用也不能单独证明作者已删除。

必填 post_id，可选同一讨论的 cursor。讨论流程涉及帖子数据中的评论集合标识，出现 comments_id 时应原样保留，先验证此接口接受哪种 ID，再批量续查；不要将所有帖子标识互换。此评论接口尚无响应样本，正文、作者、时间及包装需核实。top_comments 预览不等于完整评论，采样应有上限并保护个人隐私。

comment_id 使用旧版评论 ID，并保留讨论响应提供的匹配 post_id 与 expansion_token。字段虽均列为可选，不代表空请求能定位线程。展开令牌属于敏感的不透明上下文，仅使用获授权、匹配目标线程的值，不发布到示例。此接口尚无样本，输入组合、父子关系字段与回复覆盖需验证；不要用新版不透明评论键替代旧版 ID。

传入已知公开评论的 comment_id，直接请求单条评论。此接口尚无响应样本，正文、作者、创建时间及结构都需核实；它与嵌套回复接口不同，不承诺返回回复集合。仅刷新许可用途相关的评论，不可用记录不能直接认定为删除或审核移除。

必填 post_id，可选 reaction_type 与 cursor。已列明类型为 like、love、haha、wow、sad、care，每次选一个值，不要把选项列表整体发送。本接口尚无样本，反应记录字段与筛选效果待验证；它不同于帖子列表中的汇总计数。可见反应不是完整受众触达，也不是内置情感分类。

参数名仍为 post_id，但已列明的前置值来自帖子的分享标识。说明使用 share_id，主页帖子样本则出现 shares_id；保留原始字段和值，先核实兼容性，不默认等于普通帖子 ID。cursor 可选。此接口尚无响应样本，不承诺字段和覆盖，也不暴露私密分享或完整传播网络。

必填 query、两位国家代码 country 与一个 active_status：ALL、ACTIVE 或 INACTIVE。已核实的 US、ACTIVE、pizza 查询返回 ads 和 cursor，广告含档案 ID、主页身份、投放标记、平台、数值日期及创意卡片、文字、链接等快照。动态模板文字可与已填充卡片并存，不因此认定是假数据。其他状态与续查待核实，不提供广告管理或完整花费、展示量保证。

必填 page_id、两位国家代码与单个 active_status，可选 cursor、布尔 sort_by_new。本广告主专用接口尚无样本，不能假定与关键词广告搜索结构一致，也不保证新优先排序的具体行为；先核实档案 ID 与创意字段。定时复查、新广告识别和提醒需要应用自行保存与比较，不会自动管理广告活动。

提供同一公开广告的 ad_archive_id、page_id 与两位国家代码。广告搜索样本已有档案和广告主标识，但此详情接口尚无独立响应样本，具体创意与包装需先核实。三项上下文应匹配同一广告；公开详情不授予广告编辑权限，也不保证花费或受众统计。

只有已存 ad_archive_id 时可尝试此便捷入口。已列明说明提示它可能较不可靠；若知道广告主主页与国家，优先尝试带上下文的广告详情。本接口尚无样本，不保证创意字段或与完整详情等价；一次解析失败也不能认定广告已删除。

传入 query 与 country 请求广告搜索建议。此接口尚无样本，建议文字、广告主键、排序与结构需核实。建议用于细化发现词，之后由用户主动运行广告搜索；它不代表已验证广告主身份、完整品牌名录或可投放受众。

传入公开个人资料 url。已核实样本使用 profile 对象，含名称、profile_id、认证、简介、图片、about_public 与 Reels 集合标识；about 为空、delegate_page_id 为 null，不能承诺这些字段总有内容。仅保留许可用途所需资料，不提供私密字段，也不证明同名人物身份；创作者研究应确认适当授权，避免敏感属性推断。

传入已确认 profile_id，无需再次解析链接。此 ID 接口尚无样本，不能直接套用按链接查询的包装与字段；先验证代表性结果并最小化个人信息留存。稳定 ID 可帮助关联获授权观察，但不是身份认证证书，也不能访问私密资料。

提交公开个人资料 url 请求标识。此解析接口尚无样本，返回键与包装需核实后再衔接按 ID 查资料或内容。如需可见名称与背景，可选已有样本的按链接查资料。保留原提交链接供人工核对，解析 ID 不等于取得本人同意，也不赋予非公开内容访问权。

必填 profile_id，可选 cursor、start_date、end_date。本接口尚无样本，不能套用主页帖子的包装和字段，日期格式也需验证。适用于公众人物或适当授权的创作者公开内容；续查设置上限并在游标缺失或重复时停止，不保证全部历史或非公开帖子。

提供 profile_id，可选 cursor 与 collection_id，并保留实际返回的照片集合上下文。本接口尚无样本，照片字段及特定续查是否需要集合 ID 均应核实，不照搬主页照片规则。仅用于许可的公开内容或创作者授权场景，公开可见不代表获得图片再利用权，也不提供私密相册访问。

必填 reels_profile_id，从按链接查个人资料或已验证的资料响应取得，可选 cursor。它是集合 ID，不能用普通 profile_id 替代。来源资料样本包含该标识，但本 Reels 接口尚无样本，字段、媒体格式与覆盖需核实。仅处理许可的公众人物或创作者内容，并保持独立的短视频续查链。

提供 profile_id，续查按约定同时使用该个人响应中的 cursor 与 collection_id。本接口尚无样本，关注账号字段、数量和完整性待核实。它不是私密好友列表或隐藏关系访问；仅在创作者同意或其他适当许可目的下使用，尽量少留存账号引用，不据此推断完整社交图谱。

填写 query，可选 cursor、location_uid、recent_posts 与起止日期。此全局搜索尚无样本，内容类别、包装、字段和筛选效果均待核实。先把结果当作探索候选，再验证相应内容详情接口；不预设日期格式，也不承诺全站完整提及索引或私密内容访问。

填写 hashtag，可选同一话题搜索的 cursor。此接口尚无响应样本，结果字段、匹配规则、排序及是否需要前缀均需验证。结果是观察样本，不代表标签使用总量、触达、情感结论或完整营销活动覆盖。

填写 query，可选 cursor。人物搜索尚无样本，资料字段、包装和身份匹配行为待核实。每项结果都只是候选，需人工确认，不能以同名证明现实身份。仅用于公众人物或自愿参与创作者发现等适当许可场景，不提供私密联系方式、敏感属性推断或身份认证。

必填 query，可选 location_uid 与 cursor。此地点搜索尚无样本，场所身份、地理字段和结构需核实；需要位置背景时先查位置标识，并人工确认歧义匹配。这里发现公开场所引用，不验证商家所有权，不保证营业时间或完整地理覆盖。

填写 query，可选 cursor、recent_videos 与起止日期。此视频搜索尚无样本，视频字段、排序、近期与日期效果都需验证，不预设可接受日期格式。近期布尔选项不是实时性保证，发现媒体引用也不等于拥有播放、下载或再利用许可。

填写城市或地名 query，请求位置标识。名称歧义时可补充国家，结果异常时可尝试不带变音符号的拼写。本接口尚无样本，标识字段与地理粒度需核实；确认目标后才作为支持接口的 location_uid 使用。文本匹配不等于按坐标保证半径范围。

填写 query，可选 cursor。此群组搜索尚无样本，名称、标识、可见性标记和包装需验证。出现在搜索结果不等于帖子或媒体可公开读取，应在进一步查询前单独确认访问条件；仅用于适当许可的社区研究，不提供私密群组访问或成员目录。

提供群组 url 请求摘要。此接口尚无样本，摘要字段、群组标识与可见性信息需核实。摘要可读并不保证帖子、照片、视频或活动可读；选定进一步研究对象前确认公开访问条件和适当权限，不提供私密群组内容或成员枚举。

提交群组 url 请求 ID。解析器尚无样本，应先核实返回字段与标识，再传给群组内容接口。ID 解析只是引用归一化，不证明群组公开或内容可读；保留原始链接，单独检查访问授权和公开状态。

必填 group_id，可选 cursor 与单个 sorting_order：CHRONOLOGICAL 或 TOP_POSTS。此接口仅面向公开群组，空或不可用时应检查可见性，不直接认定没有讨论。尚无群帖响应样本，字段、包装与排序效果需核实；设置采样上限、记录观察时间并验证 ID 后去重，不保证完整历史。

必填 query，实际群内研究还应提供已确认的 group_id；虽然字段约定将群组 ID 列为可选，不代表省略后仍有明确群组范围。可选 cursor 与起止日期。本接口尚无样本，匹配、字段和日期格式待验证；不提供私密群内讨论，也不保证主题覆盖完整。

填写 group_id，可选同一群组照片集合的 cursor。本接口仅用于公开可访问群组，尚无样本，照片字段、排序和媒体行为待验证。没有内容时先确认访问条件；只保存许可视觉研究所需引用，核实标识后去重，不将其当完整相册或图片使用许可。

传入公开可访问群组的 group_id，可选同一视频集合的 cursor。本接口尚无样本，字段、媒体格式与包装需验证；内容不可用时先检查公开可见性。仅用于适当许可目的，不暗示私密群组访问，也不自动获得下载或再利用权。

填写目标公开群组 group_id，可选其活动响应返回的 cursor。此接口已列明读取未来活动，但尚无样本，活动 ID、日期及结构需核实。空结果可能反映可见性或可用性，不说明没有活动计划；用有界、人工审核的流程处理，不推断私密日历或完整活动覆盖。

必填 query，可选 location_uid、cursor、start_date 与 end_date。本活动搜索尚无样本，活动字段、位置匹配和日期格式需核实；位置标识应另行解析并确认。结果先作为人工审阅候选，入日历前核对详情，不保证覆盖全部活动或安排仍然有效。

提交公开可访问活动的 url。此详情接口尚无样本，不预设标题、场所、日期或包装字段；导入日历前先验证返回内容，并保留原链接供编辑核查。活动安排与可用性可能变化，公开活动链接不代表可以获取或重新发布无关参与者个人资料。

填写已确认 event_id 请求详情。本路径尚无样本，不假定与链接查询完全一致；仅用实际活动引用核实的 ID，并保存每次观察时间。不可用响应不证明活动取消，修改已发布日历前应核对返回信息或公开来源。

必填 page_id，可选活动响应中的 cursor 与 collection_id。此接口请求主页未来活动，尚无样本，字段及具体续查要求需核实；保留实际返回的集合上下文，不自行编造。结果适合作为人工审阅的公开活动来源，不保证完整未来安排或实时场所日历。

提供 page_id，可选 cursor 与 collection_id。此过往活动集合尚无样本，字段、顺序和续查细节待核实；集合 ID 与对应历史活动游标一起保存。结果是已观察到的公开活动引用，不保证完整历史，也不能证明每场活动都按原计划实际举行。

必填 query、lat、lng，可选公里半径、类别、成色和价格上下限。类别示例为 cars、boats；成色可用 new、used_like_new、used_good、used_fair，并按说明用逗号组合。本接口尚无样本，距离、字段和价格口径需验证。当前参数没有 cursor，不额外构造分页；价格只能作挂牌观察，不是成交价，也不提供私人卖家联系方式。

填写实际公开 Marketplace 引用中已核实的 listing_id。本详情接口尚无样本，不承诺描述、价格、位置、卖家或可售状态字段；先检查实际结构再建比较数据集。商品不可用不证明已成交，展示价格不等于最终交易金额，也不提供私人卖家联系信息。

填写 query，并选择单个 sort_order：VIEWERS 或 SUGGESTED，可选 cursor。说明提到空词浏览，但 query 在字段约定中必填，因此验证空输入行为前应提供搜索词。此游戏目录尚无样本，字段、排序和浏览效果待核实；按观看人数排序不等于全站完整热度指标。

必填已确认 game_id 与一个 sort_order：VIEWERS 或 SUGGESTED，可选 cursor。此接口已列明查找游戏相关直播，但尚无样本，直播字段、在播状态准确性和排序待核实；先从实际游戏发现结果确认标识。引用仅用于许可范围内发现，不保证持续在播，也不自动赋予嵌入或转播权。