API para Facebook

API para Facebook: Buscar páginas

Busque Páginas do Facebook por palavra-chave, opcionalmente restritas a uma localização, e receba perfis estruturados das páginas (nome, categoria, seguidores, dados de contato).

POST/v1/run/facebook.search_pages
Disponibilidade
96,98%
30d · 199 chamadas
Requisições
199
30d · semanal, últimas 12 sem.
Resposta
24,9s
mediana · 30d

Preços

Um preço, em dólares

Como chamar

Faça sua primeira requisição

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())
Abrir em
Obter chave grátis
Resposta de exemplo
{
  "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 da resposta
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";
}

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.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"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"nike"Palavra-chave para buscar Páginas do Facebook (ex.: 'coffee roasters').
limitinteger3Número máximo de resultados a retornar (1-10, padrão 10). A cobrança é por resultado retornado, então um limite menor custa menos.
locationstringLocalização opcional em texto livre para restringir a busca: uma cidade, província ou país (ex.: 'Berlin').
Resposta
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.
Preço
Preço por requisição (teto)USDUS$ 0,123
Preço /mil resultadosUSDUS$ 11,18

Dúvidas frequentes

Sobre o endpoint Buscar páginas da API para Facebook

O endpoint Buscar páginas da AnyAPI para Facebook retorna dados de Facebook em JSON normalizado com uma chamada POST para /v1/run/facebook.search_pages. Busque Páginas do Facebook por palavra-chave, opcionalmente restritas a uma localização, e receba perfis estruturados das páginas (nome, categoria, seguidores, dados de contato). A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa US$ 11,18 por mil resultados, e nunca mais de US$ 0,123 por requisição, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 97,0% das chamadas ao endpoint Buscar páginas da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 24,9 segundos, em 199 chamadas medidas.

Custa US$ 11,18 por mil resultados, e nunca mais de US$ 0,123 por requisição, 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 Páginas do Facebook por palavra-chave, opcionalmente restritas a uma localização, e receba perfis estruturados das páginas (nome, categoria, seguidores, dados de contato). 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, 97,0% das chamadas ao endpoint Buscar páginas da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 24,9 segundos, em 199 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.
Mais para chamar

Outros endpoints de Facebook

Perfila partir de US$ 1,20 /mil req.Posts do perfila partir de US$ 1,20 /mil req.Posta partir de US$ 1,20 /mil req.Comentários do posta partir de US$ 1,20 /mil req.Reels do perfila partir de US$ 1,20 /mil req.Detalhes do anúncioa partir de US$ 1,20 /mil req.Detalhes do anúncio (versão completa)a partir de US$ 4,62 /mil req.Transcrição do anúncioa partir de US$ 1,20 /mil req.Busca de anúnciosa partir de US$ 1,20 /mil req.Respostas a comentáriosa partir de US$ 1,20 /mil req.Anúncios da empresaa partir de US$ 1,20 /mil req.Detalhes do eventoa partir de US$ 1,20 /mil req.Eventosa partir de US$ 1,20 /mil req.Busca de eventosa partir de US$ 1,20 /mil req.Seguidoresa partir de US$ 6,00 /mil resultadosPosts do grupoa partir de US$ 1,20 /mil req.Marketplacea partir de US$ 1,20 /mil req.Item do Marketplacea partir de US$ 1,20 /mil req.Busca de localização no Marketplacea partir de US$ 1,20 /mil req.Contato da páginaa partir de US$ 1,20 /mil req.Consultar páginaa partir de US$ 9,75 /mil req.Fotosa partir de US$ 1,20 /mil req.Transcrição do posta partir de US$ 1,20 /mil req.Eventos do perfila partir de US$ 1,20 /mil req.Buscar empresasa partir de US$ 1,20 /mil req.Buscar postsa partir de US$ 30,00 /mil req.