社交内容 · 数据 API

Facebook

Facebook API

整理 Facebook 公开主页、帖子评论、广告库素材和 Marketplace 商品挂牌,用于商家内容与推广调研;部分资料需通过异步任务取得。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次–$2.78 / 千次;失败不计费。

10

个能力

$1.39 / 千次–$2.78 / 千次

能力价格

同步/异步

调用模式

1 个

一把 Key 通用 89 个平台

Facebook 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcontent_type, since, until默认 10 · 最多 200同步$1.39 / 千次id · url · text · author_name · author_username · like_count · comment_count · share_count · posted_at · platform
profileurl——异步$2.78 / 千次id · name · url · bio · category · like_count · follower_count · is_verified · phone · email · website · rating · rating_scale · avatar_url · platform
user_postsurl—默认 10 · 最多 50异步$2.78 / 千次id · url · text · author_name · author_username · like_count · comment_count · share_count · posted_at · platform
posturl——同步$1.39 / 千次id · url · text · author_name · author_username · like_count · comment_count · share_count · posted_at · platform
commentsurl—默认 10 · 最多 50异步$2.78 / 千次id · text · author_name · author_username · like_count · reply_count · posted_at · reply_to_id · platform
followersusernamechannel—同步$1.39 / 千次id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform
adskeywordcountry, status默认 20 · 最多 200同步$1.39 / 千次id · url · text · title · cta_text · link_url · is_active · started_at · ended_at · platforms · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · image_url · platform
group_postsurlsort默认 20 · 最多 200同步$1.39 / 千次id · url · text · posted_at · like_count · comment_count · share_count · author_id · author_name · author_url · group_url · platform
marketplacekeywordlocation默认 20 · 最多 200同步$1.39 / 千次id · url · name · price · currency · city · state · condition · image_url · posted_at · platform
reviewsurl—默认 20 · 最多 200同步$1.39 / 千次id · url · text · is_recommended · rating · rating_scale · posted_at · like_count · comment_count · author_id · author_name · author_url · platform

Facebook 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

怎么调用 Facebook 主页或对象详情 API?

profile

使用 platform="facebook"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 id、name、url、bio、category、like_count 等 15 个字段。

Facebook profile 的参数分别是什么意思?

url必填
按接口传目标:profile/user_posts 传公开主页,post/comments 传帖子,group_posts 传群组主页或群组标识,reviews 传商家主页(会补 /reviews)。不是任意 Facebook 链接均可用于所有接口。

官方分别讨论 Page/个人资料中的公开信息、公开分享与评论。可见性定义不等于所有链接都可读、所有字段都返回,也不表示接口拥有 Meta 的访问许可。官方来源:Facebook 官方:Page 资料、帖子及评论的公开可见性来源核查:

Meta 明确说明未经其事先许可自动获取 Facebook 数据违反条款,即便数据日常可见也不例外;引用权威来源不构成本站采集或再利用授权证明。官方来源:Meta 官方:自动化采集需要事先许可来源核查:

Facebook 特有返回字段与含义(1)
email
邮箱(主页公开信息)。

怎么调用 Facebook 用户内容 API?

user_posts

使用 platform="facebook"、action="user_posts" 调用“用户内容”能力;返回列表,默认 10 条、单次最多 50 条,主要包含 id、url、text、author_name、author_username、like_count 等 10 个字段。

Facebook user_posts 的参数分别是什么意思?

url必填
按接口传目标:profile/user_posts 传公开主页,post/comments 传帖子,group_posts 传群组主页或群组标识,reviews 传商家主页(会补 /reviews)。不是任意 Facebook 链接均可用于所有接口。

官方分别讨论 Page/个人资料中的公开信息、公开分享与评论。可见性定义不等于所有链接都可读、所有字段都返回,也不表示接口拥有 Meta 的访问许可。官方来源:Facebook 官方:Page 资料、帖子及评论的公开可见性来源核查:

Meta 明确说明未经其事先许可自动获取 Facebook 数据违反条款,即便数据日常可见也不例外;引用权威来源不构成本站采集或再利用授权证明。官方来源:Meta 官方:自动化采集需要事先许可来源核查:

怎么调用 Facebook 单条内容 API?

post

使用 platform="facebook"、action="post" 调用“单条内容”能力;返回单个对象,主要包含 id、url、text、author_name、author_username、like_count 等 10 个字段。

Facebook post 的参数分别是什么意思?

url必填
按接口传目标:profile/user_posts 传公开主页,post/comments 传帖子,group_posts 传群组主页或群组标识,reviews 传商家主页(会补 /reviews)。不是任意 Facebook 链接均可用于所有接口。

官方分别讨论 Page/个人资料中的公开信息、公开分享与评论。可见性定义不等于所有链接都可读、所有字段都返回,也不表示接口拥有 Meta 的访问许可。官方来源:Facebook 官方:Page 资料、帖子及评论的公开可见性来源核查:

Meta 明确说明未经其事先许可自动获取 Facebook 数据违反条款,即便数据日常可见也不例外;引用权威来源不构成本站采集或再利用授权证明。官方来源:Meta 官方:自动化采集需要事先许可来源核查:

怎么调用 Facebook 评论 API?

comments

使用 platform="facebook"、action="comments" 调用“评论”能力;返回列表,默认 10 条、单次最多 50 条,主要包含 id、text、author_name、author_username、like_count、reply_count 等 9 个字段。

Facebook comments 的参数分别是什么意思?

url必填
按接口传目标:profile/user_posts 传公开主页,post/comments 传帖子,group_posts 传群组主页或群组标识,reviews 传商家主页(会补 /reviews)。不是任意 Facebook 链接均可用于所有接口。

官方分别讨论 Page/个人资料中的公开信息、公开分享与评论。可见性定义不等于所有链接都可读、所有字段都返回,也不表示接口拥有 Meta 的访问许可。官方来源:Facebook 官方:Page 资料、帖子及评论的公开可见性来源核查:

Meta 明确说明未经其事先许可自动获取 Facebook 数据违反条款,即便数据日常可见也不例外;引用权威来源不构成本站采集或再利用授权证明。官方来源:Meta 官方:自动化采集需要事先许可来源核查:

Facebook 特有返回字段与含义(1)
reply_to_id
被回复评论 ID。

怎么调用 Facebook 粉丝数量 API?

followers

使用 platform="facebook"、action="followers" 调用“粉丝数量”能力;返回单个对象,主要包含 id、username、url、follower_count、following_count、post_count 等 10 个字段。

Facebook followers 的参数分别是什么意思?

username必填
followers 的 Facebook 账号/主页标识,不带 @;此能力当前返回粉丝数量对象,不是粉丝个人名单,不能用于逐人导出关系链。

官方解释 Follow 用于接收 Page 动态,并说明部分 Page 从 Like 转向 Follow 后的差异;用于区分 follower_count 与 like_count,不证明本站能导出关注者名单。官方来源:Facebook 官方:关注 Page 与点赞不是同一件事来源核查:

channel可选
followers 的账号标识兼容输入;username 已提供时优先 username,且公开请求仍需包含必填 username。这里不是聊天频道 ID。
Facebook 特有返回字段与含义(2)
connection_count
人脉数。
precision
数据精确度标记(平台对模糊值的标注)。

怎么调用 Facebook 广告素材 API?

ads

使用 platform="facebook"、action="ads" 调用“广告素材”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、url、text、title、cta_text、link_url 等 17 个字段。

Facebook ads 的参数分别是什么意思?

keyword必填
search 查公开帖子;ads 查广告关键词,也可传广告库/主页 URL;marketplace 查商品词,也可传完整 Marketplace 搜索 URL。三个入口范围不同,不是同一份结果换字段。

历史公告介绍按关键词或 Page 查看广告,区分一般在投广告与政治/议题广告的透明度数据;也明确官方 API 访问要求。不能据此推断所有广告都有花费、曝光或完整历史,本接口没有这些稳定字段。官方来源:Meta 官方:Ad Library 的广告与 Page 搜索对象来源核查:

country可选
ads 关键词查询的国家代码,例如 US,默认 US,构造 URL 时转为大写。keyword 已是完整 URL 时直接使用该 URL 中的条件,不再用此参数替换地区。
status可选
广告主页查询状态:all 全部(默认)、active 在投、inactive 已停投。这是投放状态,不是广告审核状态;关键词广告库 URL 的 active_status 与此参数是不同输入路径,当前不保证两条路径筛选等价。
Facebook 特有返回字段与含义(11)
advertiser_id
广告主 ID。
advertiser_name
广告主名称。
advertiser_url
广告主主页。
advertiser_likes
广告主主页点赞数。
is_active
广告是否在投。
started_at
投放开始时间。
ended_at
投放结束时间。
cta_text
行动按钮文案(如 Shop Now)。
link_url
广告落地页链接。分析竞品投放策略时最有用的字段。
platforms
投放平台(Facebook/Instagram/Messenger/AN)。
variant_count
广告素材变体数。多变体说明在做 A/B 测试。

怎么调用 Facebook 群组帖子 API?

group_posts

使用 platform="facebook"、action="group_posts" 调用“群组帖子”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、url、text、posted_at、like_count、comment_count 等 12 个字段。

Facebook group_posts 的参数分别是什么意思?

url必填
按接口传目标:profile/user_posts 传公开主页,post/comments 传帖子,group_posts 传群组主页或群组标识,reviews 传商家主页(会补 /reviews)。不是任意 Facebook 链接均可用于所有接口。

官方说明群组转公开后新内容公开,但原私有阶段内容和成员列表仍受限制;因此不能因群组现在公开就承诺历史帖和成员全量可取。官方来源:Meta 官方:群组转公开后,旧私有内容仍受保护来源核查:

Meta 明确说明未经其事先许可自动获取 Facebook 数据违反条款,即便数据日常可见也不例外;引用权威来源不构成本站采集或再利用授权证明。官方来源:Meta 官方:自动化采集需要事先许可来源核查:

sort可选
group_posts 当前使用 top 表示热门帖子、recent 表示最近有活动的帖子;不传时为按时间顺序。recent 不是仅按发帖时间,其他字符串当前回落时间顺序而非报错。
Facebook 特有返回字段与含义(1)
group_url
小组链接。

怎么调用 Facebook 市集商品 API?

marketplace

使用 platform="facebook"、action="marketplace" 调用“市集商品”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、url、name、price、currency、city 等 11 个字段。

Facebook marketplace 的参数分别是什么意思?

keyword必填
search 查公开帖子;ads 查广告关键词,也可传广告库/主页 URL;marketplace 查商品词,也可传完整 Marketplace 搜索 URL。三个入口范围不同,不是同一份结果换字段。
location可选
marketplace 的城市路径标识,例如 nyc,默认 nyc;不是自由文本街道地址。keyword 为完整 Marketplace URL 时以该 URL 为准,不再应用 location。

官方历史介绍把 Marketplace 定义为本地商品挂牌与发现,并区分商品名称、价格和位置。仅支撑对象语义,不把官方界面的筛选选项或历史地区开放范围当作本接口当前能力。官方来源:Meta 官方:Marketplace 挂牌与地点搜索来源核查:

Facebook 特有返回字段与含义(2)
condition
商品成色(Marketplace 用)。
state
所在州/状态。

怎么调用 Facebook 评价 API?

reviews

使用 platform="facebook"、action="reviews" 调用“评价”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、url、text、is_recommended、rating、rating_scale 等 13 个字段。

Facebook reviews 的参数分别是什么意思?

url必填
按接口传目标:profile/user_posts 传公开主页,post/comments 传帖子,group_posts 传群组主页或群组标识,reviews 传商家主页(会补 /reviews)。不是任意 Facebook 链接均可用于所有接口。

官方说明在 Page 的 Reviews 区域查看推荐,并指出违规评论删除可能影响 Page 评分;页面总体评分与单条推荐记录不同,不能把 is_recommended 自动换算为星级。官方来源:Facebook 官方:Page Recommendations 与 Reviews来源核查:

Meta 明确说明未经其事先许可自动获取 Facebook 数据违反条款,即便数据日常可见也不例外;引用权威来源不构成本站采集或再利用授权证明。官方来源:Meta 官方:自动化采集需要事先许可来源核查:

Facebook 特有返回字段与含义(1)
is_recommended
是否为推荐评价(FB 用推荐/不推荐替代星级)。
Facebook search 调用流程一次 Facebook search 调用的全过程:向 POST /api/v1/social 发送 platform="facebook"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、author_name、author_username 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "facebook"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idurltextauthor_nameauthor_username
一次 Facebook search 调用的全过程:向 POST /api/v1/social 发送 platform="facebook"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、author_name、author_username 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。

Facebook 原始字段名

EveryInfra 统一字段名

左边是 Facebook 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Facebook 的独有字段名(当前目录)

全站 89 个平台的当前目录中,这 10 个字段名只在 Facebook 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • cta_text
  • link_url
  • is_active
  • ended_at
  • platforms
  • variant_count
  • advertiser_id
  • advertiser_name
  • advertiser_url
  • advertiser_likes

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url
该记录在原平台上的可访问链接。
text
正文内容,已去除 HTML 标签。长文可能被截断。
author_name
作者昵称(显示名)。
author_username
作者用户名(@handle),通常可用于拼 URL。
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 链接,可能有时效。
reply_count
回复数,通常用于评论的子回复。null 表示不公开。
reply_to_id
被回复评论 ID。
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 数组。
author_id
作者在原平台的唯一 ID。
author_url
作者在原平台的主页链接。
group_url
小组链接。
price
价格数值,不含货币符号;币种见 currency。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
city
城市名,用原平台的语言书写,未做中英归一。
state
所在州/状态。
condition
商品成色(Marketplace 用)。
is_recommended
是否为推荐评价(FB 用推荐/不推荐替代星级)。

请求填写示例

填写公开搜索词;搜索对象与模式以该接口参数说明为准,不表示私密内容可读。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

facebook_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"facebook","action":"search","params":{"keyword":"urban gardening"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "text": null,
  "author_name": null,
  "author_username": null,
  "like_count": null,
  "comment_count": null,
  "share_count": null,
  "posted_at": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

Facebook search 的 content_type 为什么是排序,不是视频筛选?

search 按 keyword 查公开帖子样本,用于比较主题讨论;它和广告库、群组或 Marketplace 搜索不是同一个入口。

查看 search 的 content_type 参数 →
  • content_type 目前只接受 latest 和 most_popular,分别表示较新与热门帖子,不是 image/video 内容格式。since、until 表示帖子发布时间范围,建议 YYYY-MM-DD,不是广告投放时间。
  • text、author_name、posted_at 描述帖子;like_count 可能归一自 reactions 总量,不应一律解释为单一种 Like 表情。默认请求 10 条、目录上限 200 条,但不同读取条件下结果数和覆盖范围可能不同,不等于完整检索索引。

如何用 Facebook 主页链接核对商家资料?

profile 返回一个公开 Page 资料对象,适合核对商家名称、简介、分类与公开联系方式,不是个人账户后台信息。

查看 profile 的 url 参数 →
  • url 必填,应传目标公开主页完整链接,不能用帖子、群组或商品链接替代。该 action 为异步,提交成功不等于资料已经返回。
  • name、bio、category、website 用于确认主体;follower_count 与 like_count 是不同计数,不应互换。phone、email 仅在实际结果中可得时使用,不承诺完整联系人信息;公开可见也不构成任意采集或营销授权。

如何读取 Facebook Page 的帖子,而不是关键词搜索结果?

user_posts 用一个公开主页 url 定位该主页的帖子样本,适合追踪商家的公开内容更新。

查看 user_posts 的 url 参数 →
  • url 使用主页完整链接,不是 username、群组地址或某条帖子的永久链接。此 action 为异步,默认请求 10 条、上限 50 条;没有已公开的日期或内容格式筛选参数。
  • url、text、posted_at 对应各条帖子;author_name 帮助复核发布主体,comment_count、share_count 是互动快照。它不返回主页管理数据,也不保证抓取全部历史、隐藏内容或好友可见内容。

已知 Facebook 帖子链接,怎样复核一条原帖?

post 返回单条可获取的帖子对象,适合根据搜索结果链接核对文本和互动信息。

查看 post 的 url 参数 →
  • url 必须定位具体帖子,而不是 Page 主页;此 action 名称是 post,不是 post_detail。返回单个对象,不能把它当成某主页的帖子列表。
  • text、author_name、posted_at 用于确认原帖;like_count、comment_count、share_count 是返回时可得的计数。该接口没有视频下载、观看人数、转写稿或附件全集,不因为链接可能指向 Reel 就承诺这些字段。

如何读取 Facebook 帖子评论并区分楼中楼?

comments 根据帖子 url 提交评论读取任务,评论文本与所属父评论的标识分开返回。

查看 comments 的 url 参数 →
  • url 传具体帖子链接;此 action 为异步,默认请求 10 条、上限 50 条。没有公开排序或嵌套开关,不承诺完整评论树、所有隐藏评论或平台界面的显示顺序。
  • 每行 id、text、author_name、posted_at 对应一条评论;reply_count 是该评论的回复计数,不是已返回子评论条数。reply_to_id 若出现才可作为父评论线索,缺失不能自动判定完整层级已经导出。

Facebook followers 能导出每位粉丝吗?

followers 提供账号或主页的计数对象,不返回粉丝个人名单。

查看 followers 的 username 参数 →
  • username 必填,使用 Facebook 账号或主页标识;channel 为兼容输入,username 优先且不能省略。这里的 channel 不是 Messenger 频道。
  • follower_count、following_count、like_count 按实际返回区分,Page 的关注与点赞不可互换。precision 没有已公开值域,只按返回说明保留;不要把通用 connection_count 当作 Facebook 好友名单或精确关系图。

如何用 Facebook 广告库核对素材与投放主体?

ads 根据广告关键词或完整广告库/主页 URL 读取可获取的广告记录,用于检查广告内容、落地页和发布主体,不提供广告账户后台指标。

查看 ads 的 keyword 参数 →
  • keyword 为普通词时,country 使用国家代码、默认 US 并转大写;keyword 为完整 URL 时直接沿用 URL 条件,country 不再覆盖它。status 用于广告主页查询路径,当前不能保证与关键词 URL 的 active_status 完全等价;它不是广告审核状态。
  • text、title、cta_text、link_url 描述广告内容和入口;advertiser_name、advertiser_url 标识主体,is_active、started_at、ended_at 描述可得的投放状态与时间。没有稳定的花费、精确曝光、转化或 ROAS 字段;variant_count 不能单独证明广告主正在做 A/B 实验,image_url 当前可能只是广告主头像,不应当作广告主素材图。

Facebook 群组的 recent 和按发帖时间排序有什么区别?

group_posts 读取目标公开群组的帖子样本,不等于 Page 帖子,也不读取私有群的历史内容。

查看 group_posts 的 sort 参数 →
  • url 必填,可传完整群组地址或群组标识;sort=top 表示热门,sort=recent 表示最近有活动,不是单纯最新发帖。不传时使用时间顺序;当前未声明严格枚举,不应把其他字符串当作受支持的新选项。
  • group_url 标识群组,author_url 标识作者,posted_at 是帖子时间。正文最多保留 3000 字符。群组从私有转公开也不意味着过去的内容自动公开;此接口不提供成员名单或绕过旧内容隐私设置。

Marketplace 的 location 应填城市路径,还是完整地址?

marketplace 检索本地商品挂牌,适合查看标价与城市分布;挂牌价格不是成交价格。

查看 marketplace 的 location 参数 →
  • keyword 填商品词时,location 是城市路径标识,例如 nyc,默认 nyc;当前会清除非英文字母,不适合填街道、邮编或任意中文城市名。若 keyword 已是完整 Marketplace 搜索 URL,则使用该 URL,不再追加 location。
  • name、price、currency 描述挂牌,city、state 描述位置;condition 是返回的成色或条件信息,不是已验证的质检结果。没有成交量、买家身份或实时库存保证,不把标价当实际销售收入。

Facebook 推荐评价可以直接按五星评论处理吗?

reviews 按商家主页读取评价行,保留推荐与评分的区别,不能把所有评价强制换成五星。

查看 reviews 的 url 参数 →
  • url 字段必填:传商家主页链接,当前会补 /reviews;不是普通帖子评论入口。默认请求 20 条、上限 200 条,不能保证页面所有历史评价都可获取。
  • is_recommended 表达是否推荐,rating 仅在实际存在时表示评分,二者不能机械相互换算。text、author_name、posted_at 属于评价本身,like_count、comment_count 属于该评价的互动;它们不是商家总体评分或评价总数。

Facebook API 常见问题

Facebook API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="facebook"、action 和 params。以 search 为例,必填 keyword,可选 content_type、since、until。填写公开搜索词;搜索对象与模式以该接口参数说明为准,不表示私密内容可读。 Facebook 共 10 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Facebook API 怎么收费?

$1.39 / 千次–$2.78 / 千次,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 359 次 Facebook 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Facebook API 一次能返回多少条数据?

Facebook 有 7 个列表接口,包括 search、user_posts、comments、ads、group_posts、marketplace、reviews。其余 3 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Facebook API 返回哪些字段?

当前目录为 search 列出 id、url、text、author_name、author_username、like_count 等 10 个字段名。按全站当前目录统计,10 个字段名只在 Facebook 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

Facebook API 的异步能力怎么用?

profile、user_posts、comments 是异步能力:提交后立即返回 job_id,用 GET /api/v1/jobs/{job_id} 轮询取结果。只在提交时计费一次,轮询免费。

Facebook search 的 content_type 为什么是排序,不是视频筛选?

search 按 keyword 查公开帖子样本,用于比较主题讨论;它和广告库、群组或 Marketplace 搜索不是同一个入口。 content_type 目前只接受 latest 和 most_popular,分别表示较新与热门帖子,不是 image/video 内容格式。since、until 表示帖子发布时间范围,建议 YYYY-MM-DD,不是广告投放时间。 text、author_name、posted_at 描述帖子;like_count 可能归一自 reactions 总量,不应一律解释为单一种 Like 表情。默认请求 10 条、目录上限 200 条,但不同读取条件下结果数和覆盖范围可能不同,不等于完整检索索引。

如何用 Facebook 主页链接核对商家资料?

profile 返回一个公开 Page 资料对象,适合核对商家名称、简介、分类与公开联系方式,不是个人账户后台信息。 url 必填,应传目标公开主页完整链接,不能用帖子、群组或商品链接替代。该 action 为异步,提交成功不等于资料已经返回。 name、bio、category、website 用于确认主体;follower_count 与 like_count 是不同计数,不应互换。phone、email 仅在实际结果中可得时使用,不承诺完整联系人信息;公开可见也不构成任意采集或营销授权。

如何读取 Facebook Page 的帖子,而不是关键词搜索结果?

user_posts 用一个公开主页 url 定位该主页的帖子样本,适合追踪商家的公开内容更新。 url 使用主页完整链接,不是 username、群组地址或某条帖子的永久链接。此 action 为异步,默认请求 10 条、上限 50 条;没有已公开的日期或内容格式筛选参数。 url、text、posted_at 对应各条帖子;author_name 帮助复核发布主体,comment_count、share_count 是互动快照。它不返回主页管理数据,也不保证抓取全部历史、隐藏内容或好友可见内容。

已知 Facebook 帖子链接,怎样复核一条原帖?

post 返回单条可获取的帖子对象,适合根据搜索结果链接核对文本和互动信息。 url 必须定位具体帖子,而不是 Page 主页;此 action 名称是 post,不是 post_detail。返回单个对象,不能把它当成某主页的帖子列表。 text、author_name、posted_at 用于确认原帖;like_count、comment_count、share_count 是返回时可得的计数。该接口没有视频下载、观看人数、转写稿或附件全集,不因为链接可能指向 Reel 就承诺这些字段。

可以先免费试用 Facebook API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Facebook 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 10 个能力。无需信用卡。

开始调用 Facebook API

加微信领 $1 免费额度,先选一个 Facebook 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始