> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apollospace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Apify — actors de scraping & enrichment

> Como o Apollo Space usa Apify para descobrir leads em mapas e enriquecer informações de contato a partir de websites.

Peça ao Apollo Space pra "encontrar 50 pizzarias em São Paulo" e, alguns
minutos depois, seu pipeline tem 50 leads novos — nome, endereço, telefone e,
pra muitos deles, um e-mail já extraído do site. Ninguém abriu uma aba do
navegador ou copiou uma linha. Esse movimento todo roda em cima do Apify.

O trabalho braçal de montar uma lista — buscar, raspar, deduplicar, caçar um
contato — sai do seu colo. Você pede em linguagem natural; um agente faz a
coleta e te devolve um pipeline limpo.

## O que é

[Apify](https://apify.com) é uma plataforma que roda **actors** — programas
de scraping/extração pré-construídos pra fontes específicas (Google
Maps, LinkedIn, websites, etc.).

O Apollo Space usa Apify em **dois fluxos críticos** do CRM:

<CardGroup cols={2}>
  <Card title="Descoberta de leads via Google Maps" icon="map-pin">
    "Encontre 50 pizzarias em São Paulo" — Apollo Space dispara o actor de
    maps do Apify e popula seu pipeline com leads novos, deduplicados
    pelos seus existentes.
  </Card>

  <Card title="Enriquecimento de contato via website" icon="address-book">
    Dado um lead com site mas sem e-mail, Apollo Space dispara o actor de
    contatos do Apify pra extrair e-mails, telefones e perfis sociais
    do site.
  </Card>
</CardGroup>

## Conexão (BYO key)

<Steps>
  <Step title="Crie conta no Apify">
    [apify.com](https://apify.com) → free tier tem \$5 de crédito
    inicial. Suficiente pra testes; planos pagos pra volume real.
  </Step>

  <Step title="Pegue a API key">
    No dashboard Apify, em **Settings → Integrations**, copie sua
    API token.
  </Step>

  <Step title="Cole no Apollo Space">
    **Settings → Integrações → Apify** → cola o token.
  </Step>

  <Step title="Pronto">
    As tools de maps + enrichment passam a ser disponíveis pros
    agentes da org.
  </Step>
</Steps>

<Info>
  Token Apify fica criptografado e isolado por organização — outro
  cliente Apollo Space não vê seu token. Veja [Segurança](/pt/trust/security).
</Info>

## O que cada actor faz

### Maps lead search

Pesquisa no Google Maps por nicho + região e devolve uma lista de
estabelecimentos com:

* Nome do negócio
* Endereço completo
* Telefone (quando público)
* Website (quando público)
* Latitude / longitude
* Rating + número de reviews
* Categoria + horário de funcionamento

Opcionalmente, pode também extrair **reviews textuais** (até N por
estabelecimento) — útil pra mineração de pain-points.

### Website contacts enrichment

Dado uma URL de site, varre as páginas atrás de:

* E-mails (com fence de mesmo-domínio pra evitar e-mails de
  prestadores de serviço listados no rodapé)
* Telefones em formato E.164
* Perfis sociais (LinkedIn, Instagram, Twitter, etc.)

O Apollo Space combina o resultado do Apify com um **scraper leve interno**.
O Apify roda primeiro (mais robusto); se não retorna e-mail same-domain, o
scraper de fallback tenta. Sem fabricação: se nada funciona, o lead fica
marcado como "sem e-mail".

## Como o custo é calculado

O Apify cobra **por execução de actor + por resultado**. Pra cada um
dos dois fluxos:

| Fluxo            | Modelo de cobrança                                                       |
| ---------------- | ------------------------------------------------------------------------ |
| Maps lead search | Por place retornado (+ adicional por place quando reviews são extraídos) |
| Website contacts | Por URL processada                                                       |

Os preços ficam visíveis no painel do Apify direto — não somos
intermediadores. O Apollo Space lê o resultado da execução e debita Stars
proporcionais ao consumo.

## Tools dos agentes

Você nunca chama o Apify direto. Seus agentes chamam — pegando o actor certo
no momento em que um pedido precisa dele. O Apify é exposto a eles como duas
tools:

| Tool               | Quem usa        | Quando                                            |
| ------------------ | --------------- | ------------------------------------------------- |
| `maps_lead_search` | Marcus / Athena | Quando você pede "encontre N leads em \[região]"  |
| `contact_enrich`   | Marcus / Athena | Quando um lead novo entra sem e-mail mas com site |

Ambas geram trace + entrada no histórico de uso da org, auditáveis no
painel de Faturamento.

## Custos

| Onde cai                                                      | Quem paga                               |
| ------------------------------------------------------------- | --------------------------------------- |
| **Actor runs** (fatura Apify)                                 | Sua conta Apify direto                  |
| **Orquestração** (Marcus/Athena + processamento Apollo Space) | Seu saldo de [Stars](/pt/billing/stars) |

## Limitações conhecidas

* **Rate limit do Google Maps** — o Apify tem proxy próprio, mas
  buscas muito agressivas podem ser detectadas. O Apollo Space aplica um
  cap interno conservador pra evitar.
* **Sites com JavaScript pesado** — alguns sites de single-page-app
  retornam HTML vazio. O actor de contatos não roda JS por default
  (custo seria alto). Nesses casos o scraper de fallback também falha.
* **Reviews de Google Maps em massa** — extrair 50 reviews × 100
  estabelecimentos é caro. O Apollo Space limita por default a poucos
  reviews por place em buscas grandes; opt-in pra extração ampla.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Marcus — quem dispara" icon="paper-plane" href="/pt/agents/marcus">
    O outbound usa o Apify pra popular o pipeline antes de escrever.
  </Card>

  <Card title="CRM" icon="users" href="/pt/features/crm">
    Como leads novos do Apify aparecem no seu pipeline.
  </Card>

  <Card title="Stars" icon="star" href="/pt/billing/stars">
    Como o uso entra no faturamento.
  </Card>
</CardGroup>