Facebook API

Facebook 搜索公共主页 API

按关键词搜索 Facebook 公共主页，可选按地点缩小范围，返回结构化的主页资料（名称、类别、粉丝、联系方式）。

POST/v1/run/facebook.search_pages
可用率
96.98%
30d · 199 次调用
请求数
199
30d · 按周，近 12 周
响应时间
24.9s
中位数 · 30d

价格

一个价格，以美元计

调用方式

发出你的第一个请求

import os, requests

res = requests.post(
    "https://api.getanyapi.com/v1/run/facebook.search_pages",
    headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"},
    json={
        "query": ""
    },
)
print(res.json())
打开于
获取免费密钥
示例响应
{
  "data": {
    "items": [
      {
        "about": "A short example description of this item.",
        "adStatus": "active",
        "categories": [
          "example"
        ],
        "category": "general",
        "coverPhotoUrl": "https://example.com/image.jpg",
        "createdUtc": 12.5,
        "followers": 12500,
        "id": "a1b2c3d4",
        "image": "https://example.com/image.jpg",
        "likes": 12500,
        "owner": "Alex Rivera",
        "pageAlias": "example",
        "phone": "+1 555-0142",
        "title": "Example title",
        "url": "https://example.com/page",
        "website": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface FacebookSearchPagesResponse {
  data: {
    items: {
      about?: string;
      adStatus?: string;
      categories?: string[];
      category?: string;
      coverPhotoUrl?: string;
      createdUtc?: number;
      followers?: number;
      id: string;
      image?: string;
      likes?: number;
      owner?: string;
      pageAlias?: string;
      phone?: string;
      title: string;
      url: string;
      website?: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/facebook.search_pages
curl -X POST https://api.getanyapi.com/v1/run/facebook.search_pages \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"query":"nike"}'
字段类型示例值
请求体
querystring"nike"用于搜索 Facebook 公共主页的关键词（例如 'coffee roasters'）。
limitinteger3最多返回的结果数（1-10，默认 10）。按返回的结果数扣费，所以上限越低，费用越少。
locationstring可选，用于缩小搜索范围的自由文本地点：城市、省份或国家（例如 'Berlin'）。
响应
dataobject
data.itemsobject[]Matching Facebook Page records for the query. Populated whenever the provider has data for the entity.
data.items[].aboutstringThe page's intro text.
data.items[].adStatusstringFacebook Ad Library status sentence for the page, e.g. whether it is currently running ads.
data.items[].categoriesstring[]Categories Facebook lists the page under.
data.items[].categorystringThe page's primary category (e.g. "Sportswear Store"). Empty when the upstream omits it.
data.items[].coverPhotoUrlstringCover photo image URL of the page.
data.items[].createdUtcnumberUTC epoch timestamp in seconds (Unix time) the page was created. Multiply by 1000 for a JS Date in milliseconds.
data.items[].followersintegerThe page's follower count.
data.items[].idstringThe page's numeric Facebook ID, as a string. Populated whenever the provider has data for the entity.
data.items[].imagestringURL of the page's profile picture, with tracking query params stripped. Empty when the upstream omits it.
data.items[].likesintegerThe page's like count.
data.items[].ownerstringConfirmed owner of the page, when Facebook publishes one.
data.items[].pageAliasstringThe page's vanity URL alias, e.g. "nikesportswear".
data.items[].phonestringThe page's public phone number. Empty when the upstream omits it.
data.items[].titlestringThe page's public name. Populated whenever the provider has data for the entity.
data.items[].urlstringCanonical URL of the Facebook Page, with tracking query params stripped. Populated whenever the provider has data for the entity.
data.items[].websitestringThe page's public website URL. Empty when the upstream omits it.
foundbooleanWhether any matching pages 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.123
价格（/千条结果）USDUS$11.18

常见问题

关于 Facebook 搜索公共主页 API

AnyAPI 的 Facebook 搜索公共主页 API 只需一次 POST 请求 /v1/run/facebook.search_pages，就以统一格式的 JSON 返回 Facebook 数据。按关键词搜索 Facebook 公共主页，可选按地点缩小范围，返回结构化的主页资料（名称、类别、粉丝、联系方式）。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千条结果 US$11.18，单次请求最多 US$0.123，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Facebook 搜索公共主页 API 调用中有 97.0% 成功，响应时间中位数为 24.9 秒，共测量 199 次调用。

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

按关键词搜索 Facebook 公共主页，可选按地点缩小范围，返回结构化的主页资料（名称、类别、粉丝、联系方式）。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Facebook 搜索公共主页 API 调用中有 97.0% 成功，响应时间中位数为 24.9 秒，共测量 199 次调用。这些是 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$30.00 起