# Pullleads (`axsrocks/pullleads`) Actor Extract local business leads from Google Maps, Yelp, Yellow Pages and BBB. Finds owner emails, not generic info@ addresses. Perfect for B2B lead generation and cold email campaigns. - **URL**: https://apify.com/axsrocks/pullleads.md - **Developed by:** [Alexis Vedia](https://apify.com/axsrocks) (community) - **Categories:** Lead generation - **Stats:** 20 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🎯 PullLeads - Multi-Source Lead Extractor Extract local business leads from **Google Maps, Yelp, Yellow Pages, and BBB** with automatic email enrichment. Find owner/decision-maker emails, not generic info@ addresses. ### What it does 1. **Scrapes businesses** from multiple directories (Google Maps, Yelp, Yellow Pages, BBB) 2. **Finds owner emails** using Hunter.io, Apollo.io, and Snov.io 3. **Verifies emails** with NeverBounce (optional) 4. **Exports clean data** ready for your CRM or cold email tool ### Perfect for - 🏠 **Home services** (plumbers, HVAC, electricians, roofers) - 🦷 **Healthcare** (dentists, chiropractors, clinics) - 🏢 **Professional services** (lawyers, accountants, real estate) - 🍽️ **Restaurants & hospitality** - 🔧 **Auto repair shops** ### Input | Field | Type | Description | |-------|------|-------------| | `query` | string | Type of business (e.g., "plumbers", "dentists") | | `location` | string | City/area to search (e.g., "Miami, Florida") | | `limit` | number | Max businesses to extract (default: 50) | | `source` | string | Data source: `google_maps`, `yelp`, `yellow_pages`, `bbb`, `all_usa` | | `enrichMode` | string | Email search aggressiveness | | `skipEnrichment` | boolean | Skip email finding (faster) | | `skipVerification` | boolean | Skip email verification | #### API Keys (Optional) For email enrichment, provide your own API keys: - `hunterApiKey` - Hunter.io API key - `apolloApiKey` - Apollo.io API key - `snovApiKey` - Snov.io API key - `neverbounceApiKey` - NeverBounce API key (for verification) ### Output Each lead includes: ```json { "name": "Joe's Plumbing", "address": "123 Main St, Miami, FL 33101", "phone": "(305) 555-1234", "website": "https://joesplumbing.com", "category": "Plumber", "rating": "4.8", "reviews_count": "156", "email": "joe@joesplumbing.com", "email_source": "hunter", "email_verified": true, "facebook": "https://facebook.com/joesplumbing", "instagram": "https://instagram.com/joesplumbing", "source": "google_maps" } ```` ### Data Sources | Source | Coverage | Best for | |--------|----------|----------| | Google Maps | Global | General local businesses | | Yelp | USA | Restaurants, services with reviews | | Yellow Pages | USA | Traditional business directory | | BBB | USA/Canada | Verified/accredited businesses | ### Email Enrichment The Actor rotates between 3 email finding services to maximize results: - **Hunter.io** - Best for domain-based search - **Apollo.io** - Great for company name search - **Snov.io** - Good fallback option #### Enrichment Modes - `website-only` - Only search if business has a website - `name-search` - Search by company name if no website (default) - `aggressive` - Try all available methods ### Tips for Best Results 1. **Start small** - Test with `limit: 10` first 2. **Be specific** - "plumbers" works better than "home services" 3. **Use location format** - "Miami, Florida" or "Miami, FL" 4. **Combine sources** - Use `all_usa` for comprehensive results ### Pricing This Actor uses Apify's standard compute pricing. Email enrichment APIs have their own free tiers: - Hunter: 25 searches/month free - Apollo: 75 credits/month free - Snov: 50 credits/month free ### Support - Issues: [GitHub](https://github.com/axsrocks/multi-source-lead-extractor) - Website: [pulleads.com](https://pulleads.com) *** Built with ❤️ by [PullLeads](https://pulleads.com) # Actor input Schema ## `query` (type: `string`): Type of business to search for (e.g., 'plumbers', 'dentists', 'restaurants') ## `location` (type: `string`): Geographic location to search in (e.g., 'Miami, Florida', 'New York, NY') ## `niche` (type: `string`): Use a preset niche instead of custom query. Options: plumbers, hvac, electricians, roofers, landscapers, dentists, chiropractors, real-estate, lawyers, auto-repair, restaurants ## `limit` (type: `integer`): Maximum number of businesses to extract ## `source` (type: `string`): Source to scrape businesses from ## `enrichMode` (type: `string`): How aggressively to search for emails ## `skipEnrichment` (type: `boolean`): Skip the email finding phase (faster, but no emails) ## `skipVerification` (type: `boolean`): Skip NeverBounce email verification ## `hunterApiKey` (type: `string`): API key for Hunter.io email finder (optional - uses env var if not provided) ## `apolloApiKey` (type: `string`): API key for Apollo.io email finder (optional - uses env var if not provided) ## `snovApiKey` (type: `string`): API key for Snov.io email finder (optional - uses env var if not provided) ## `neverbounceApiKey` (type: `string`): API key for NeverBounce email verification (optional) ## Actor input object example ```json { "query": "plumbers", "location": "Miami, Florida", "limit": 50, "source": "google_maps", "enrichMode": "name-search", "skipEnrichment": false, "skipVerification": true } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "plumbers", "location": "Miami, Florida" }; // Run the Actor and wait for it to finish const run = await client.actor("axsrocks/pullleads").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "plumbers", "location": "Miami, Florida", } # Run the Actor and wait for it to finish run = client.actor("axsrocks/pullleads").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "plumbers", "location": "Miami, Florida" }' | apify call axsrocks/pullleads --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=axsrocks/pullleads", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pullleads", "description": "Extract local business leads from Google Maps, Yelp, Yellow Pages and BBB. Finds owner emails, not generic info@ addresses. Perfect for B2B lead generation and cold email campaigns.", "version": "1.1", "x-build-id": "paSw4p7K6lr1G4RSQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axsrocks~pullleads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axsrocks-pullleads", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/axsrocks~pullleads/runs": { "post": { "operationId": "runs-sync-axsrocks-pullleads", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/axsrocks~pullleads/run-sync": { "post": { "operationId": "run-sync-axsrocks-pullleads", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "location" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "Type of business to search for (e.g., 'plumbers', 'dentists', 'restaurants')" }, "location": { "title": "Location", "type": "string", "description": "Geographic location to search in (e.g., 'Miami, Florida', 'New York, NY')" }, "niche": { "title": "Preset Niche", "type": "string", "description": "Use a preset niche instead of custom query. Options: plumbers, hvac, electricians, roofers, landscapers, dentists, chiropractors, real-estate, lawyers, auto-repair, restaurants" }, "limit": { "title": "Max Results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of businesses to extract", "default": 50 }, "source": { "title": "Data Source", "enum": [ "google_maps", "yelp", "yellow_pages", "bbb", "all_usa" ], "type": "string", "description": "Source to scrape businesses from", "default": "google_maps" }, "enrichMode": { "title": "Enrichment Mode", "enum": [ "website-only", "name-search", "aggressive" ], "type": "string", "description": "How aggressively to search for emails", "default": "name-search" }, "skipEnrichment": { "title": "Skip Email Enrichment", "type": "boolean", "description": "Skip the email finding phase (faster, but no emails)", "default": false }, "skipVerification": { "title": "Skip Email Verification", "type": "boolean", "description": "Skip NeverBounce email verification", "default": true }, "hunterApiKey": { "title": "Hunter.io API Key", "type": "string", "description": "API key for Hunter.io email finder (optional - uses env var if not provided)" }, "apolloApiKey": { "title": "Apollo.io API Key", "type": "string", "description": "API key for Apollo.io email finder (optional - uses env var if not provided)" }, "snovApiKey": { "title": "Snov.io API Key", "type": "string", "description": "API key for Snov.io email finder (optional - uses env var if not provided)" }, "neverbounceApiKey": { "title": "NeverBounce API Key", "type": "string", "description": "API key for NeverBounce email verification (optional)" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```