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

US$ 9,18/mil resultados, pague por requisição, sem assinatura.

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

Pages

Kreuzberg Coffee Roasters

Coffee Shop

18.4K followers

O que a API retornouitems[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 campos a mais
}
Disponibilidade
89,38%
30d · 1.158 chamadas
Requisições
1.158
30d · semanal, últimas 12 sem.
Resposta
39,2s
mediana · 30d

Como chamar

Obtenha Buscar páginas do Facebook em uma só 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": "nike",
        "limit": 3
    },
)
print(res.json())
Abrir em
Obter chave grátis
Resposta de exemplo

Este exemplo mostra 19 de 21 campos. Ver todos os campos

{
  "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"
        ]
      }
    ]
  }
}

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

Referência

Uma requisição, um formato de resposta.

Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.

Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • querystring

    coffee roasters

    Palavra-chave para buscar Páginas do Facebook (ex.: 'coffee roasters').

  • limitinteger

    3

    Nú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.

  • locationstring

    Berlin

    Localização opcional em texto livre para restringir a busca: uma cidade, província ou país (ex.: 'Berlin').

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

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.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

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$ 9,18 por mil resultados, e nunca mais de US$ 0,101 por requisição, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 89,4% das chamadas ao endpoint Buscar páginas da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 39,2 segundos, em 1.158 chamadas medidas.

Custa US$ 9,18 por mil resultados, e nunca mais de US$ 0,101 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, 89,4% das chamadas ao endpoint Buscar páginas da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 39,2 segundos, em 1.158 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.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/facebook.search_pages com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.