API para Facebook

API para Facebook: Buscar empresas

Busque anunciantes na Biblioteca de Anúncios da Meta por palavra-chave e receba as páginas correspondentes: ID da página, categoria, verificação, número de seguidores e Instagram vinculado.

POST/v1/run/facebook.search_companies
Disponibilidade
100,00%
30d · 2.340 chamadas
Requisições
2.342
30d · semanal, últimas 12 sem.
Resposta
0,9s
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": {
    "companies": [
      {
        "category": "general",
        "country": "US",
        "entityType": "general",
        "igFollowers": 12500,
        "igUsername": "alex_rivera",
        "igVerified": true,
        "imageUrl": "https://example.com/image.jpg",
        "likes": 12500,
        "name": "Example title",
        "pageAlias": "example",
        "pageDeleted": false,
        "pageId": "a1b2c3d4",
        "verification": "example"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface FacebookSearchCompaniesResponse {
  data: {
    companies: {
      category: string;
      country: string;
      entityType: string;
      igFollowers: number;
      igUsername: string;
      igVerified?: boolean;
      imageUrl: string;
      likes: number;
      name: string;
      pageAlias: string;
      pageDeleted?: boolean;
      pageId: string;
      verification: 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_companies
curl -X POST https://api.getanyapi.com/v1/run/facebook.search_companies \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"nike"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"nike"Palavra-chave para buscar páginas de anunciantes (ex.: "nike").
Resposta
dataobject
data.companiesobject[]
data.companies[].categorystringPopulated whenever the provider has data for the entity.
data.companies[].countrystring
data.companies[].entityTypestringPopulated whenever the provider has data for the entity.
data.companies[].igFollowersintegerPopulated whenever the provider has data for the entity.
data.companies[].igUsernamestringPopulated whenever the provider has data for the entity.
data.companies[].igVerifiedbooleanWhether the page's linked Instagram account is verified.
data.companies[].imageUrlstringPopulated whenever the provider has data for the entity.
data.companies[].likesinteger
data.companies[].namestringPopulated whenever the provider has data for the entity.
data.companies[].pageAliasstringPopulated whenever the provider has data for the entity.
data.companies[].pageDeletedbooleanWhether the Facebook Page has been deleted.
data.companies[].pageIdstringPopulated whenever the provider has data for the entity.
data.companies[].verificationstringPopulated whenever the provider has data for the entity.
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 Buscar empresas da API para Facebook

O endpoint Buscar empresas da AnyAPI para Facebook retorna dados de Facebook em JSON normalizado com uma chamada POST para /v1/run/facebook.search_companies. Busque anunciantes na Biblioteca de Anúncios da Meta por palavra-chave e receba as páginas correspondentes: ID da página, categoria, verificação, número de seguidores e Instagram vinculado. 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 Buscar empresas da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 0,9 segundos, em 2.340 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 anunciantes na Biblioteca de Anúncios da Meta por palavra-chave e receba as páginas correspondentes: ID da página, categoria, verificação, número de seguidores e Instagram vinculado. 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 Buscar empresas da API para Facebook feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 0,9 segundos, em 2.340 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.