> ## 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 — scraping & enrichment actors

> How Apollo Space uses Apify to discover leads on maps and enrich contact information from websites.

Ask Apollo Space to "find 50 pizza places in São Paulo," and a few minutes
later your pipeline holds 50 new leads — names, addresses, phone numbers, and
for many of them an email already pulled from their website. Nobody opened a
browser tab or copied a row. That whole motion runs on Apify.

The grunt work of building a list — searching, scraping, deduping, hunting down
a contact — leaves your plate. You ask in plain language; an agent does the
gathering and hands back a clean pipeline.

## What it is

[Apify](https://apify.com) is a platform that runs **actors** — pre-built
scraping/extraction programs for specific sources (Google
Maps, LinkedIn, websites, etc.).

Apollo Space uses Apify in **two critical CRM flows**:

<CardGroup cols={2}>
  <Card title="Lead discovery via Google Maps" icon="map-pin">
    "Find 50 pizza places in São Paulo" — Apollo Space triggers the Apify
    Maps actor and populates your pipeline with new leads, deduplicated
    against your existing ones.
  </Card>

  <Card title="Contact enrichment via website" icon="address-book">
    Given a lead with a website but no email, Apollo Space triggers the Apify
    contacts actor to extract emails, phone numbers, and social profiles
    from the site.
  </Card>
</CardGroup>

## Connection (BYO key)

<Steps>
  <Step title="Create an Apify account">
    [apify.com](https://apify.com) → the free tier includes \$5 in initial
    credit. Enough for testing; paid plans for real volume.
  </Step>

  <Step title="Get your API key">
    In the Apify dashboard, under **Settings → Integrations**, copy your
    API token.
  </Step>

  <Step title="Paste it into Apollo Space">
    **Settings → Integrations → Apify** → paste the token.
  </Step>

  <Step title="Done">
    The Maps and enrichment tools become available to your
    organization's agents.
  </Step>
</Steps>

<Info>
  Your Apify token is encrypted and isolated per organization — other
  Apollo Space customers cannot see your token. See [Security](/en/trust/security).
</Info>

## What each actor does

### Maps lead search

Searches Google Maps by niche and region and returns a list of
businesses with:

* Business name
* Full address
* Phone number (when public)
* Website (when public)
* Latitude / longitude
* Rating and review count
* Category and business hours

Optionally, it can also extract **text reviews** (up to N per
business) — useful for mining pain points.

### Website contacts enrichment

Given a site URL, it crawls the pages looking for:

* Emails (with a same-domain filter to avoid service-provider emails
  listed in footers)
* Phone numbers in E.164 format
* Social profiles (LinkedIn, Instagram, Twitter, etc.)

Apollo Space combines the Apify result with an internal lightweight
scraper. Apify runs first (more robust); if it returns no same-domain
email, the fallback scraper tries. No fabrication: if nothing works,
the lead is marked as "no email."

## How costs are calculated

Apify charges **per actor run + per result**. For each of the two flows:

| Flow             | Billing model                                                          |
| ---------------- | ---------------------------------------------------------------------- |
| Maps lead search | Per place returned (+ additional per place when reviews are extracted) |
| Website contacts | Per URL processed                                                      |

Prices are visible directly in the Apify dashboard — we are not
an intermediary. Apollo Space reads the execution result and deducts
Stars proportional to usage.

## Agent tools

You never call Apify directly. Your agents do — reaching for the right actor
the moment a request needs one. Apify is exposed to them as two tools:

| Tool               | Used by         | When                                                         |
| ------------------ | --------------- | ------------------------------------------------------------ |
| `maps_lead_search` | Marcus / Athena | When you ask to "find N leads in \[region]"                  |
| `contact_enrich`   | Marcus / Athena | When a new lead comes in without an email but with a website |

Both generate a trace and an entry in the org's usage history, auditable in
the Billing dashboard.

## Costs

| Where it lands                                              | Who pays                                |
| ----------------------------------------------------------- | --------------------------------------- |
| **Actor runs** (Apify invoice)                              | Your Apify account directly             |
| **Orchestration** (Marcus/Athena + Apollo Space processing) | Your [Stars](/en/billing/stars) balance |

## Known limitations

* **Google Maps rate limits** — Apify has its own proxy infrastructure, but
  very aggressive searches can be detected. Apollo Space applies a conservative
  internal cap to avoid this.
* **JavaScript-heavy sites** — some single-page-app sites return empty HTML.
  The contacts actor does not run JavaScript by default
  (the cost would be high). In these cases the fallback scraper also fails.
* **Bulk Google Maps reviews** — extracting 50 reviews × 100
  businesses is expensive. Apollo Space limits to a few
  reviews per place by default on large searches; opt in for extended extraction.

## Next steps

<CardGroup cols={2}>
  <Card title="Marcus — who triggers it" icon="paper-plane" href="/en/agents/marcus">
    Outbound uses Apify to populate the pipeline before writing.
  </Card>

  <Card title="CRM" icon="users" href="/en/features/crm">
    How new leads from Apify appear in your pipeline.
  </Card>

  <Card title="Stars" icon="star" href="/en/billing/stars">
    How usage feeds into billing.
  </Card>
</CardGroup>