Facebook API

Facebook 活动搜索 API

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

POST/v1/run/facebook.events_search
可用率
100.00%
30d · 161 次调用
请求数
161
30d
响应时间
4.5s
中位数 · 30d

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "events": [
      {
        "coverImage": "https://example.com/image.jpg",
        "dayTimeSentence": "2024-01-15T09:30:00Z",
        "eventKind": "general",
        "goingCount": 12500,
        "id": "a1b2c3d4",
        "interestedCount": 12500,
        "isOnline": true,
        "isPast": true,
        "name": "Example title",
        "placeId": "a1b2c3d4",
        "placeName": "Example title",
        "priceRangeText": "A short example description of this item.",
        "startTimestamp": 42,
        "type": "general",
        "url": "https://example.com/page"
      }
    ],
    "nextCursor": "example"
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface FacebookEventsSearchResponse {
  data: {
    events: {
      coverImage: string;
      dayTimeSentence: string;
      eventKind?: string;
      goingCount: number;
      id: string;
      interestedCount: number;
      isOnline: boolean;
      isPast: boolean;
      name: string;
      placeId?: string;
      placeName: string;
      priceRangeText: string;
      startTimestamp: number;
      type?: string;
      url: string;
    }[];
    nextCursor: string | null;
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/facebook.events_search
curl -X POST https://api.getanyapi.com/v1/run/facebook.events_search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"music festival"}'
字段类型示例值
请求体
querystring"music festival"用于搜索活动的查询词。
cursorstring上一次响应返回的分页游标。
响应
dataobject
data.eventsobject[]
data.events[].coverImagestringPopulated whenever the provider has data for the entity.
data.events[].dayTimeSentencestringPopulated whenever the provider has data for the entity.
data.events[].eventKindstringEvent kind Facebook reports, e.g. "PUBLIC_TYPE".
data.events[].goingCountinteger
data.events[].idstringPopulated whenever the provider has data for the entity.
data.events[].interestedCountinteger
data.events[].isOnlineboolean
data.events[].isPastboolean
data.events[].namestringPopulated whenever the provider has data for the entity.
data.events[].placeIdstringNumeric Facebook id of the event's place, as a string.
data.events[].placeNamestringPopulated whenever the provider has data for the entity.
data.events[].priceRangeTextstring
data.events[].startTimestampintegerPopulated whenever the provider has data for the entity.
data.events[].typestringEntity type of the record, e.g. "Event".
data.events[].urlstringPopulated whenever the provider has data for the entity.
data.nextCursorstringOpaque cursor for the next page of events, or null when this lane has no more. Pass it back as cursor to continue.
foundboolean
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.0012
价格(/千次请求)USDUS$1.20

常见问题

关于 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.5 秒,共测量 161 次调用。

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

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

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