id- 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url- 该记录在原平台上的可访问链接。
text- 正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
author_name- 作者昵称(显示名)。
author_username- 作者用户名(@handle),通常可用于拼 URL。
author_id- 评论作者的数字用户 ID(稳定标识,可用于跨请求去重)。
author_url- 评论作者的主页链接。
author_avatar_url- 作者头像图片链接(多数平台带签名、会过期)。
media- 帖子的图片 / 视频:type、url(图片或视频封面)、width、height、link(点开的地址)。
reactions- 分表情计数:like、love、care、haha、wow、sad、angry。
view_count- 浏览/播放数。null 表示不公开,不等于 0。
link- 帖子附带的外链。
group_name- 帖子所在的群名(群帖才有)。
is_paid_partnership- 是否付费合作帖。
like_count- 点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
comment_count- 评论数。null 表示不公开,不等于 0。
share_count- 分享/转发数。null 表示不公开,不等于 0。
posted_at- 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
platform- 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
name- 名称。用于账号/商品/商家类能力,指该对象本身的名字。
bio- 个人简介,账号自己填写的文本。可能含换行和 emoji。
category- 分类名称,取值为原平台的分类体系,未做跨平台归一。
follower_count- 粉丝数。null 表示不公开,不等于 0。
is_verified- 是否为平台认证账号(蓝V等)。null 表示无法判定。
phone- 联系电话,原文透传,未做号码格式归一。
email- 邮箱(主页公开信息)。
website- 账号或商家填写的外链网址。
rating- 评分。分制随平台而异,同一行的
rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 rating_scale- 上一列
rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 avatar_url- 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
depth- 评论层级:0 是顶层评论(一级),1 是对顶层评论的回复(二级),2 是对回复的再回复(三级)。深度行的 id 与其父评论组相同,重建评论树请用 depth + reply_to_id。
reply_to_id- 被回复评论的 ID(depth>=1 才有;depth=0 恒为空)。回复行的 id 会复用父评论组 ID,要区分父子请以本字段为准。
comment_url- 该条评论的永久链接;深度行的链接带 reply_comment_id 参数指向被回复的评论。
reply_count- 回复数,通常用于评论的子回复。null 表示不公开。
username- 用户名(@handle)。
following_count- 关注数。null 表示不公开,不等于 0。
post_count- 发布内容总数。null 表示不公开,不等于 0。
connection_count- 人脉数。
precision- 数据精确度标记(平台对模糊值的标注)。
title- 标题。平台无标题概念时(如纯文本帖)为 null。
cta_text- 行动按钮文案(如 Shop Now)。
link_url- 广告落地页链接。分析竞品投放策略时最有用的字段。
is_active- 广告是否在投。
started_at- 投放开始时间。
ended_at- 投放结束时间。
platforms- 投放平台(Facebook/Instagram/Messenger/AN)。
variant_count- 广告素材变体数。多变体说明在做 A/B 测试。
advertiser_id- 广告主 ID。
advertiser_name- 广告主名称。
advertiser_url- 广告主主页。
advertiser_likes- 广告主主页点赞数。
image_url- 图片链接。多图能力可能返回 image_urls 数组。
group_url- 小组链接。
price- 价格数值,不含货币符号;币种见 currency。
currency- 价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
city- 城市名,用原平台的语言书写,未做中英归一。
state- 所在州/状态。
condition- 商品成色(Marketplace 用)。
is_recommended- 是否为推荐评价(FB 用推荐/不推荐替代星级)。
page_like_count- 主页点赞数(advertiser_search)。
instagram_username- 这个主页关联的 Instagram 账号(advertiser_search);没关联时没有这个字段。
instagram_follower_count- 关联 Instagram 账号的粉丝数(advertiser_search);没关联时没有这个字段。
instagram_verified- 关联 Instagram 账号是否认证(advertiser_search);没关联时没有这个字段。
country- 国家或地区。可能是全称也可能是 ISO 代码,取决于平台,未归一。
caption- 广告里显示的落地页域名(ad_detail,如 example.com)。
link_description- 广告链接卡片下方的描述文字(ad_detail)。
display_format- 广告形式(ad_detail):IMAGE、VIDEO、CAROUSEL、DPA(动态商品广告)等。
creatives- 广告的各个素材版本(ad_detail):title、text、caption、link_url、link_description、cta_text、image_url、video_url。轮播和动态商品广告每张卡片一项。
advertiser_avatar_url- 广告主主页头像(ad_detail)。
advertiser_categories- 广告主主页的类目(ad_detail)。
starts_at- 活动开始时间(events_search、page_events;ISO 8601,UTC)。
date_text- Facebook 页面上显示的活动时间原文,带当地时区(events_search、page_events),如「Sat, Oct 31 at 8:00 PM CDT」。
place_name- 活动地点名称或地址(events_search、page_events);线上活动可能没有。
place_id- 活动地点的 Facebook 主页 ID(events_search)。
is_online- 是否线上活动(events_search、page_events)。
is_past- 活动是否已结束(events_search、page_events)。
going_count- 标记「参加」的人数(events_search)。
interested_count- 标记「感兴趣」的人数(events_search)。
price_text- 票价说明原文(events_search);免费或没写时没有这个字段。
next_page_token- 翻页令牌(events_search、page_events):作为下一次请求的 page_token 原样传回取下一页;同一页每行的值相同,响应顶层也有同一个 next_page_token。没有该字段即到底。
original_price_text- 划线原价原文(marketplace_item),卖家降过价才有。
attributes- 商品属性(marketplace_item):name、value,如 Condition = Used - Good、Bicycle Type = Mountain Bike。
location- 地理位置描述,原文透传,格式随平台而异。
latitude- 商品所在位置纬度(marketplace_item,Facebook 给的大致位置)。
longitude- 商品所在位置经度(marketplace_item)。
is_sold- 是否已售出(marketplace_item)。
is_pending- 是否交易中(marketplace_item)。
is_shipping_offered- 卖家是否提供邮寄(marketplace_item)。
delivery_types- 交付方式(marketplace_item):IN_PERSON 当面交易、SHIPPING 邮寄等。
category_id- Marketplace 商品类目 ID(marketplace_item)。
image_urls- 图片链接数组,按平台展示顺序;没有图片时不出现这个字段。
seller_id- 卖家的 Facebook 标识(marketplace_item)。
seller_name- 卖家显示名(marketplace_item)。
seller_rating- 卖家评分(marketplace_item,满分 5);没有评价时没有这个字段。
seller_rating_count- 卖家收到的评价数(marketplace_item)。
seller_joined_at- 卖家加入 Facebook 的时间(marketplace_item;ISO 8601,UTC)。
host_name- 办活动的主页名称(page_events);联合主办时可能是合作方主页。
is_canceled- 活动是否已取消(page_events)。
duration_seconds- 时长,单位秒。非视频/音频内容为 null。