API para Facebook

API para Facebook: Busca de eventos

Busque eventos públicos do Facebook por palavra-chave e receba registros estruturados de eventos (nome, programação, local, preços e participação) em JSON normalizado.

POST/v1/run/facebook.events_search
Disponibilidade
100,00%
30d · 161 chamadas
Requisições
161
30d
Resposta
4,5s
mediana · 30d

Teste

Faça sua primeira requisição

Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "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 da resposta
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";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 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"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"music festival"A consulta usada para buscar eventos.
cursorstringCursor de paginação de uma resposta anterior.
Resposta
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.
Preço
Preço por requisiçãoUSDUS$ 0,0012
Preço /mil req.USDUS$ 1,20

Dúvidas frequentes

Sobre o endpoint Busca de eventos da API para Facebook

O endpoint Busca de eventos da AnyAPI para Facebook retorna dados de Facebook em JSON normalizado com uma chamada POST para /v1/run/facebook.events_search. Busque eventos públicos do Facebook por palavra-chave e receba registros estruturados de eventos (nome, programação, local, preços e participação) em JSON normalizado. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Busca de eventos da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 4,5 segundos, em 161 chamadas medidas.

Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque eventos públicos do Facebook por palavra-chave e receba registros estruturados de eventos (nome, programação, local, preços e participação) em JSON normalizado. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Busca de eventos da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 4,5 segundos, em 161 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.