Facebook API

Facebook 搜索帖子 API

按关键词搜索公开的 Facebook 帖子，可选按地点筛选，返回结构化帖子记录（文本、作者、互动数据）。

POST/v1/run/facebook.search_posts
可用率
99.23%
30d · 1,435 次调用
请求数
1,438
30d · 按周，近 12 周
响应时间
20.2s
中位数 · 30d

服务商网络

按流量排序的服务商

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "albumPreview": [
      {
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "type": "general",
        "url": "https://example.com/page"
      }
    ],
    "authorId": "Alex Rivera",
    "authorImage": "https://example.com/image.jpg",
    "imagesCount": 12500,
    "items": [
      {
        "authorName": "Alex Rivera",
        "authorUrl": "https://example.com/page",
        "commentCount": 12500,
        "createdUtc": 12.5,
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "reactionCount": 12500,
        "shareCount": 13,
        "text": "A short example description of this item.",
        "url": "https://example.com/page"
      }
    ],
    "reactions": {
      "angry": 42,
      "care": 42,
      "haha": 42,
      "like": 12500,
      "love": 42,
      "sad": 42,
      "wow": 42
    },
    "type": "general"
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface FacebookSearchPostsResponse {
  data: {
    albumPreview?: {
      id?: string;
      image?: string;
      type?: string;
      url?: string;
    }[];
    authorId?: string;
    authorImage?: string;
    imagesCount?: number | null;
    items: {
      authorName?: string;
      authorUrl?: string;
      commentCount?: number;
      createdUtc: number;
      id: string;
      image?: string;
      reactionCount?: number;
      shareCount?: number;
      text: string;
      url: string;
    }[];
    reactions?: {
      angry?: number;
      care?: number;
      haha?: number;
      like?: number;
      love?: number;
      sad?: number;
      wow?: number;
    };
    type?: string;
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/facebook.search_posts
curl -X POST https://api.getanyapi.com/v1/run/facebook.search_posts \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"query":"nike"}'
字段类型示例值
请求体
querystring"nike"用于搜索 Facebook 帖子的关键词或短语（例如 'product launch'）。
endDatestring只返回在此日期或之前发布的帖子，格式为 YYYY-MM-DD（例如 2024-12-31）。
limitinteger3最多返回的结果数（1-20，默认 20）。
locationstring可选，用于缩小结果范围的地点；同时填写城市和国家可获得最佳匹配（例如 'Paris, France'）。
startDatestring只返回在此日期或之后发布的帖子，格式为 YYYY-MM-DD（例如 2024-01-01）。
响应
dataobject
data.albumPreviewobject[]Preview of the photos attached to the post.
data.albumPreview[].idstringNumeric Facebook id of the photo, as a string.
data.albumPreview[].imagestringImage URL of the photo.
data.albumPreview[].typestringKind of attachment, e.g. "photo".
data.albumPreview[].urlstringCanonical Facebook URL of the photo.
data.authorIdstringNumeric Facebook id of the page or profile that posted, as a string.
data.authorImagestringProfile picture URL of the page or profile that posted.
data.imagesCountintegerNumber of images attached to the post. Null when the source does not report it.
data.itemsobject[]Matching public Facebook post records for the query. Populated whenever the provider has data for the entity.
data.items[].authorNamestringDisplay name of the post's author. Empty when the upstream omits it.
data.items[].authorUrlstringCanonical profile URL of the post's author, with tracking query params stripped. Empty when the upstream omits it.
data.items[].commentCountintegerTotal number of comments on the post.
data.items[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.items[].idstringThe post's numeric Facebook ID, as a string. Populated whenever the provider has data for the entity.
data.items[].imagestringURL of the post's primary image, with tracking query params stripped. Empty for text-only or video posts.
data.items[].reactionCountintegerTotal number of reactions on the post.
data.items[].shareCountintegerTotal number of shares/reshares of the post.
data.items[].textstringThe post's text/message. Empty for media-only posts with no caption.
data.items[].urlstringCanonical URL of the post, with tracking query params stripped. Populated whenever the provider has data for the entity.
data.reactionsobjectReaction counts on the post, broken down by reaction type.
data.reactions.angryintegerAngry reactions.
data.reactions.careintegerCare reactions.
data.reactions.hahaintegerHaha reactions.
data.reactions.likeintegerLike reactions.
data.reactions.loveintegerLove reactions.
data.reactions.sadintegerSad reactions.
data.reactions.wowintegerWow reactions.
data.typestringKind of record Facebook returned, e.g. "post".
foundbooleanWhether any matching posts were returned for the query.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
价格
每次请求价格USDUS$0.03
价格（/千次请求）USDUS$30.00

常见问题

关于 Facebook 搜索帖子 API

AnyAPI 的 Facebook 搜索帖子 API 只需一次 POST 请求 /v1/run/facebook.search_posts，就以统一格式的 JSON 返回 Facebook 数据。按关键词搜索公开的 Facebook 帖子，可选按地点筛选，返回结构化帖子记录（文本、作者、互动数据）。AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$30 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Facebook 搜索帖子 API 调用中有 99.2% 成功，响应时间中位数为 20.2 秒，共测量 1,435 次调用。

费用：每千次请求 US$30 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

按关键词搜索公开的 Facebook 帖子，可选按地点筛选，返回结构化帖子记录（文本、作者、互动数据）。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Facebook 搜索帖子 API 调用中有 99.2% 成功，响应时间中位数为 20.2 秒，共测量 1,435 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。
更多接口

Facebook 的其他接口

主页/千次请求 US$1.20 起主页帖子/千次请求 US$1.20 起帖子/千次请求 US$1.20 起帖子评论/千次请求 US$1.20 起主页 Reels/千次请求 US$1.20 起广告详情/千次请求 US$1.20 起广告详情（完整版）/千次请求 US$4.62 起广告转录文本/千次请求 US$1.20 起广告搜索/千次请求 US$1.20 起评论回复/千次请求 US$1.20 起公司广告/千次请求 US$1.20 起活动详情/千次请求 US$1.20 起活动/千次请求 US$1.20 起活动搜索/千次请求 US$1.20 起粉丝/千条结果 US$6.00 起小组帖子/千次请求 US$1.20 起Marketplace/千次请求 US$1.20 起Marketplace 商品/千次请求 US$1.20 起Marketplace 地点搜索/千次请求 US$1.20 起公共主页联系方式/千次请求 US$1.20 起查找公共主页/千次请求 US$9.75 起照片/千次请求 US$1.20 起帖子转录文本/千次请求 US$1.20 起主页活动/千次请求 US$1.20 起搜索公司/千次请求 US$1.20 起搜索公共主页/千条结果 US$11.18 起