Facebook API

Facebook 活动搜索 API

按关键词搜索公开的 Facebook 活动,以标准化 JSON 返回结构化活动记录(名称、时间安排、场地、价格和参与情况)。

US$1.20/千次请求,按请求付费,无需订阅。

fmusic festival | Facebook Search
facebook.com/search/events?q=music%20festival

Events

Lakeside Music Festival 2026

Sat, Nov 14 at 12:00 PM EST · Crescent Lake Amphitheater

$45 - $120 · 18.2K interested

API 返回的内容events[0]
{
"id": "5192837465019283",
"name": "Lakeside Music Festival 2026",
"url": "https://www.facebook.com/events/5192837465019283/",
"dayTimeSentence": "Sat, Nov 14 at 12:00 PM EST",
"startTimestamp": 1794675600,
"placeName": "Crescent Lake Amphitheater",
"priceRangeText": "$45 - $120",
"coverImage": "https://scontent.xx.fbcdn.net/v/t39.30808-6/event_cover_5192837465019283.jpg",
... 还有 7 个字段
}
可用率
100.00%
30d · 2,862 次调用
请求数
2,862
30d · 按周,近 12 周
响应时间
4.6s
中位数 · 30d

价格与服务商

Facebook 活动搜索 API 价格:一个 API,2 个可互换的服务商

最便宜的服务商优先响应。如果它失败,下一个会在同一次调用中接手。

你需支付
US$12.00
US$1.20/千次请求,只为实际用量付费。没有月度套餐。
有了 US$0.10 的初始余额,你的前 83 次请求免费。

试一试

一个请求获取 Facebook 活动搜索

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

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

{
  "found": true,
  "data": {
    "nextCursor": "AbW7f_musicfest_cursor_02",
    "events": [
      {
        "id": "5192837465019283",
        "name": "Lakeside Music Festival 2026",
        "url": "https://www.facebook.com/events/5192837465019283/",
        "dayTimeSentence": "Sat, Nov 14 at 12:00 PM EST",
        "startTimestamp": 1794675600,
        "placeName": "Crescent Lake Amphitheater",
        "priceRangeText": "$45 - $120",
        "coverImage": "https://scontent.xx.fbcdn.net/v/t39.30808-6/event_cover_5192837465019283.jpg",
        "interestedCount": 18200,
        "goingCount": 6400,
        "isOnline": false,
        "isPast": false,
        "placeId": "120938475610293",
        "eventKind": "PUBLIC_TYPE",
        "type": "Event"
      },
      {
        "id": "4028193746501928",
        "name": "Riverside Indie Music Fest",
        "url": "https://www.facebook.com/events/4028193746501928/",
        "dayTimeSentence": "Sat, Sep 12 at 2:00 PM CDT",
        "startTimestamp": 1789239600,
        "placeName": "Riverside Park Pavilion",
        "priceRangeText": "Free",
        "coverImage": "https://scontent.xx.fbcdn.net/v/t39.30808-6/event_cover_4028193746501928.jpg",
        "interestedCount": 3200,
        "goingCount": 940,
        "isOnline": false,
        "isPast": true,
        "placeId": "938201847562910",
        "eventKind": "PUBLIC_TYPE",
        "type": "Event"
      }
    ]
  }
}

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

参考

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

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

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

请求体

JSON,POST 到这个接口。

  • querystring

    music festival

    用于搜索活动的查询词。

  • cursorstring

    上一次响应返回的分页游标。

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

响应

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

each eventdata.events[]
  • coverImagestring

    https://scontent.xx.fbcdn.net/v/t39.30808-6/event_cover_5192837465019283.jpg

    Populated whenever the provider has data for the entity.

  • dayTimeSentencestring

    Sat, Nov 14 at 12:00 PM EST

    Populated whenever the provider has data for the entity.

  • eventKindstring

    PUBLIC_TYPE

    Event kind Facebook reports, e.g. "PUBLIC_TYPE".

  • goingCountinteger

    6400

  • idstring

    5192837465019283

    Populated whenever the provider has data for the entity.

  • interestedCountinteger

    18200

  • isOnlineboolean

    false

  • isPastboolean

    false

  • namestring

    Lakeside Music Festival 2026

    Populated whenever the provider has data for the entity.

  • placeIdstring

    120938475610293

    Numeric Facebook id of the event's place, as a string.

  • placeNamestring

    Crescent Lake Amphitheater

    Populated whenever the provider has data for the entity.

  • priceRangeTextstring

    $45 - $120

  • startTimestampinteger

    1794675600

    Populated whenever the provider has data for the entity.

  • typestring

    Event

    Entity type of the record, e.g. "Event".

  • urlstring

    https://www.facebook.com/events/5192837465019283/

    Populated whenever the provider has data for the entity.

datadata
  • nextCursorstring

    AbW7f_musicfest_cursor_02

    Opaque cursor for the next page of events, or null when this lane has no more. Pass it back as cursor to continue.

top level
  • foundboolean

    true

  • 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.events_search,就以统一格式的 JSON 返回 Facebook 数据。按关键词搜索公开的 Facebook 活动,以标准化 JSON 返回结构化活动记录(名称、时间安排、场地、价格和参与情况)。AnyAPI 会在 2 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Facebook 活动搜索 API 调用中有 100.0% 成功,响应时间中位数为 4.6 秒,共测量 2,862 次调用。

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

按关键词搜索公开的 Facebook 活动,以标准化 JSON 返回结构化活动记录(名称、时间安排、场地、价格和参与情况)。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

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

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 83 次 Facebook 活动搜索,每次 US$0.0012。

AnyAPI 会在同一个请求中依次尝试它的 2 个数据源,从最便宜的开始,所以一个数据源宕机不会让你的调用失败。

向 https://api.getanyapi.com/v1/run/facebook.events_search 发送 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 调用这个接口。