Facebook API

Facebook 搜索公共主页 API

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

US$9.18/千条结果,按请求付费,无需订阅。

fcoffee roasters | Facebook Search
facebook.com/search/pages?q=coffee%20roasters

Pages

Kreuzberg Coffee Roasters

Coffee Shop

18.4K followers

API 返回的内容items[0]
{
"id": "108827441652390",
"title": "Kreuzberg Coffee Roasters",
"url": "https://www.facebook.com/kreuzbergcoffeeroasters",
"category": "Coffee Shop",
"followers": 18400,
"likes": 17900,
"phone": "+49 30 5550 1873",
"website": "https://kreuzbergroasters.de",
... 还有 9 个字段
}
可用率
89.38%
30d · 1,158 次调用
请求数
1,158
30d · 按周,近 12 周
响应时间
39.2s
中位数 · 30d

调用方式

一个请求获取 Facebook 搜索公共主页

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": "nike",
        "limit": 3
    },
)
print(res.json())
打开于
获取免费密钥
示例响应

这个示例展示了 21 个字段中的 19 个。查看全部字段

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "108827441652390",
        "title": "Kreuzberg Coffee Roasters",
        "url": "https://www.facebook.com/kreuzbergcoffeeroasters",
        "category": "Coffee Shop",
        "followers": 18400,
        "likes": 17900,
        "phone": "+49 30 5550 1873",
        "website": "https://kreuzbergroasters.de",
        "image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/kreuzberg_avatar.jpg",
        "pageAlias": "kreuzbergcoffeeroasters",
        "about": "Small-batch coffee roasted daily in Kreuzberg since 2014. Wholesale and cafe pickup.",
        "coverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/kreuzberg_cover.jpg",
        "createdUtc": 1391212800,
        "adStatus": "This Page is not currently running ads.",
        "owner": "",
        "categories": [
          "Coffee Shop",
          "Coffee Roastery"
        ]
      },
      {
        "id": "241093887761204",
        "title": "Nordlicht Rostkaffee",
        "url": "https://www.facebook.com/nordlichtrostkaffee",
        "category": "Coffee Roastery",
        "followers": 6250,
        "likes": 6010,
        "phone": "+49 30 5550 2946",
        "website": "https://nordlicht-kaffee.de",
        "image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/nordlicht_avatar.jpg",
        "pageAlias": "nordlichtrostkaffee",
        "about": "Direct-trade single-origin roaster based in Prenzlauer Berg.",
        "coverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/nordlicht_cover.jpg",
        "createdUtc": 1476403200,
        "adStatus": "This Page is currently running ads.",
        "owner": "",
        "categories": [
          "Coffee Roastery"
        ]
      },
      {
        "id": "365710428839112",
        "title": "Spandau Bean Co.",
        "url": "https://www.facebook.com/spandaubeanco",
        "category": "Coffee Shop",
        "followers": 2870,
        "likes": 2790,
        "phone": "",
        "website": "https://spandaubean.co",
        "image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/spandau_avatar.jpg",
        "pageAlias": "spandaubeanco",
        "about": "Neighborhood roastery and cafe on Wilhelmstrasse.",
        "coverPhotoUrl": "https://scontent.xx.fbcdn.net/v/t39.30808-1/spandau_cover.jpg",
        "createdUtc": 1552608000,
        "adStatus": "This Page is not currently running ads.",
        "owner": "",
        "categories": [
          "Coffee Shop"
        ]
      }
    ]
  }
}

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

参考

一个请求,一种响应结构。

你发送的每个字段和收到的每个字段,都附有真实示例。

最近验证于 2026-11-14 · 可用率和延迟按 30d 统计

请求体

JSON,POST 到这个接口。

  • querystring

    coffee roasters

    用于搜索 Facebook 公共主页的关键词(例如 'coffee roasters')。

  • limitinteger

    3

    最多返回的结果数(1-10,默认 10)。按返回的结果数扣费,所以上限越低,费用越少。

  • locationstring

    Berlin

    可选,用于缩小搜索范围的自由文本地点:城市、省份或国家(例如 'Berlin')。

你发送。 一个简短的 JSON 请求体。显示的值只是示例,请换成你自己的。

响应

JSON,每个字段一个示例值。

each itemdata.items[]

Matching Facebook Page records for the query. Populated whenever the provider has data for the entity.

  • aboutstring

    Small-batch coffee roasted daily in Kreuzberg since 2014. Wholesale and cafe pickup.

    The page's intro text.

  • adLibraryPageIdstring

    The page's Facebook Ad Library id, the `pageId` facebook.company_ads takes. It differs from `id`. Absent when Facebook shows none.

  • adStatusstring

    This Page is not currently running ads.

    Facebook Ad Library status sentence for the page, e.g. whether it is currently running ads.

  • categoriesstring[]

    Categories Facebook lists the page under.

  • categorystring

    Coffee Shop

    The page's primary category (e.g. "Sportswear Store"). Empty when the upstream omits it.

  • coverPhotoUrlstring

    https://scontent.xx.fbcdn.net/v/t39.30808-1/kreuzberg_cover.jpg

    Cover photo image URL of the page.

  • createdUtcnumber

    1391212800

    UTC epoch timestamp in seconds (Unix time) the page was created. Multiply by 1000 for a JS Date in milliseconds.

  • followersinteger

    18400

    The page's follower count.

  • idstring

    108827441652390

    The page's numeric Facebook ID, as a string. Populated whenever the provider has data for the entity.

  • imagestring

    https://scontent.xx.fbcdn.net/v/t39.30808-1/kreuzberg_avatar.jpg

    URL of the page's profile picture, a signed CDN URL whose query must be kept. Empty when the upstream omits it.

  • likesinteger

    17900

    The page's like count.

  • ownerstring

    Confirmed owner of the page, when Facebook publishes one.

  • pageAliasstring

    kreuzbergcoffeeroasters

    The page's vanity URL alias, e.g. "nikesportswear".

  • phonestring

    +49 30 5550 1873

    The page's public phone number. Empty when the upstream omits it.

  • titlestring

    Kreuzberg Coffee Roasters

    The page's public name. Populated whenever the provider has data for the entity.

  • urlstring

    https://www.facebook.com/kreuzbergcoffeeroasters

    Canonical URL of the Facebook Page, with tracking query params stripped. Populated whenever the provider has data for the entity.

  • websitestring

    https://kreuzbergroasters.de

    The page's public website URL. Empty when the upstream omits it.

top level
  • foundboolean

    true

    Whether 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.

你收到。 字段有名称、有类型,无论哪个数据源响应,结构都一样。

常见问题

关于 Facebook 搜索公共主页 API

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

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

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

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

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡。

向 https://api.getanyapi.com/v1/run/facebook.search_pages 发送 POST 请求,在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥,并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元,每个请求从中扣费。没有月度套餐,也没有最低消费,同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk,Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口,任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器,或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥,再通过 HTTP 调用这个接口。