# Pediatric Nurse Practitioners Email Scraper (`contacts-api/pediatric-nurse-practitioners-email-scraper`) Actor

Pediatric nurse practitioners email scraper to extract verified NP emails from children’s hospitals, clinics, and healthcare directories 📧👶 Perfect for healthcare outreach, recruitment, and targeted pediatric medical lead generation.

- **URL**: https://apify.com/contacts-api/pediatric-nurse-practitioners-email-scraper.md
- **Developed by:** [Lead Heaven](https://apify.com/contacts-api) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## 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

### 🧒 Pediatric Nurse Practitioners Email Scraper — Find Verified Leads in Minutes

> The fastest way to build a targeted pediatric nurse practitioners list. This actor searches Google Maps for pediatric nurse practitioners and similar practices across any city, crawls their websites, and extracts verified pediatric nurse practitioners email, phone numbers, and social media profiles — all in one clean, export-ready dataset.

---

#### 🚀 Quick Start

1. Enter your search term — e.g., "Pediatric Nurse Practitioners"
2. Add one or more target locations — e.g., "New York"
3. Set your desired number of businesses with emails
4. Hit Run and get your results in minutes

No coding required. Export to CSV, JSON, or Excel instantly.

---

#### 💡 What Is the Pediatric Nurse Practitioners Email Scraper?

The pediatric nurse practitioners email scraper is a purpose-built lead generation and contact discovery tool designed for:

- Healthcare marketing teams
- Staffing and recruiting agencies
- B2B outreach professionals
- Researchers and data analysts

It combines Google Maps listing discovery with deep website crawling to extract publicly available contact data — producing an accurate, deduplicated pediatric nurse practitioners list ready for immediate use.

Whether you need it as a pediatric nurse practitioners email finder, a pediatric nurse practitioners lead scraper, or a pediatric nurse practitioners lead finder — this actor covers all three in a single automated run. It also works as a pediatric nurse practitioners contact finder and pediatric nurse practitioners contact scraper for broader outreach.

---

#### 📦 What Data Does It Extract?

| Field | Description |
|---|---|
| Business Name | Practice or company name from Google Maps |
| Website | Official website URL |
| Phone | Primary phone from the listing or website |
| Full Address | Complete address as listed |
| City / State / ZIP | Parsed location components |
| Country Code | ISO country code where available |
| Emails | All public practice emails extracted from website pages |
| Additional Phones | Extra phone numbers discovered during crawl |
| Social Media Links | Facebook, Instagram, LinkedIn, X/Twitter, and more |
| Email Count | Total unique emails found per business |
| Pages Scraped | Number of website pages crawled per domain |
| Rating | Average Google Maps star rating |
| Reviews | Total number of Google reviews |
| Latitude / Longitude | Geo-coordinates for mapping and filtering |
| Place ID | Google Maps place identifier |
| Scrape Status | Per-record status: success, partial, or error |

All outputs are accessible via the Apify dataset and can be exported to CSV, JSON, Excel, or consumed via API.

---

#### ⚙️ Input Configuration

##### Minimal Example

```json
{
  "googleMapsSearchTerm": "Pediatric Nurse Practitioners",
  "googleMapsLocation": ["New York"],
  "maxBusinesses": 50
}
````

##### Full Example with All Options

```json
{
  "googleMapsSearchTerm": "Pediatric Nurse Practitioners",
  "googleMapsLocation": [
    "New York",
    "Boston, Massachusetts",
    "Philadelphia, Pennsylvania"
  ],
  "maxBusinesses": 200,
  "scrapeMaxBusinessesPerLocation": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

##### Input Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `googleMapsSearchTerm` | String | ✅ Yes | Business type to search — e.g., "Pediatric Nurse Practitioners", "pediatric clinics" |
| `googleMapsLocation` | Array | ✅ Yes | One or more locations — e.g., \["New York", "Chicago, Illinois"] |
| `maxBusinesses` | Number | ❌ No | Max businesses with emails to return (1–1,000). The run stops when this target is reached |
| `scrapeMaxBusinessesPerLocation` | Boolean | ❌ No | If true, applies the cap per location; if false, it's a combined total across all locations |
| `proxyConfiguration` | Object | ❌ No | Proxy settings. Strongly recommended for large or multi-location runs |

***

#### 📤 Sample Output

```json
[
  {
    "name": "Bright Kids Pediatric Care",
    "website": "https://www.brightkidspeds.com",
    "phone": "+1 212-555-0147",
    "full_address": "221 W 82nd St, New York, NY 10024, United States",
    "city": "New York",
    "state": "NY",
    "zip": "10024",
    "country_code": "US",
    "scraped_emails": [
      "info@brightkidspeds.com",
      "nursepractitioner@brightkidspeds.com"
    ],
    "scraped_phones": ["+1 212-555-0147", "+1 212-555-0172"],
    "scraped_social_media": [
      "facebook:https://facebook.com/brightkidspeds",
      "instagram:https://instagram.com/brightkidspeds"
    ],
    "emails_found": 2,
    "pages_scraped": 12,
    "avg_rating": 4.7,
    "total_reviews": 89,
    "lat": 40.7851,
    "long": -73.9776,
    "place_id": "ChIJ2-EXAMPLEID",
    "scrape_status": "success"
  },
  {
    "name": "Hudson River Pediatric NP Clinic",
    "website": "https://www.hudsonriverpnp.com",
    "phone": "+1 917-555-0208",
    "full_address": "455 W 34th St, New York, NY 10001, United States",
    "city": "New York",
    "state": "NY",
    "zip": "10001",
    "country_code": "US",
    "scraped_emails": [
      "contact@hudsonriverpnp.com"
    ],
    "scraped_phones": ["+1 917-555-0208"],
    "scraped_social_media": [
      "linkedin:https://www.linkedin.com/company/hudsonriverpnp"
    ],
    "emails_found": 1,
    "pages_scraped": 7,
    "avg_rating": 4.5,
    "total_reviews": 54,
    "lat": 40.7537,
    "long": -73.9992,
    "place_id": "ChIJ3-EXAMPLEID",
    "scrape_status": "success"
  }
]
```

***

#### 🔧 How It Works — Under the Hood

```
Step 1 → Search Google Maps using your term + location
Step 2 → Collect business listings (name, address, phone, website)
Step 3 → Visit each website and crawl key pages (Home, Contact, About, etc.)
Step 4 → Extract public emails, phone numbers, and social media links
Step 5 → Deduplicate and normalize all contact data
Step 6 → Return structured results ready for export or API consumption
```

The actor is built to work as both a pediatric nurse practitioners lead finder and a pediatric nurse practitioners email extractor — and also as a pediatric nurse practitioners data scraper — in a single automated pipeline.

***

#### ✨ Key Features

The Pediatric Nurse Practitioners Email Scraper packs production-grade features for scalable outreach and research.

##### 🎯 Precise Location Targeting

Enter any city, state, or region. The actor pinpoints pediatric nurse practitioners in your exact target areas — delivering hyper-local pediatric nurse practitioners leads.

##### 🔍 Deep Website Crawl

Goes beyond the listing. Crawls homepages, contact pages, about pages, and footer sections to surface every available public pediatric nurse practitioners email and phone number. It doubles as a pediatric nurse practitioners email extractor and a pediatric nurse practitioners contact scraper.

##### 🌎 Multi-Location Scaling

Run across dozens of cities at once. Choose a combined cap or a per-location cap — perfect for building a large, multi-market pediatric nurse practitioners list.

##### 🧹 Smart De-Duplication

Automatically removes duplicate emails per domain so your contact lists stay clean and accurate — no messy cleanup required after export.

##### 📊 Structured, CRM-Ready Output

All results are normalized with consistent field names. Drop them straight into HubSpot, Salesforce, Apollo, Instantly, or any outreach tool. Ideal when you need a reliable pediatric nurse practitioners data scraper that speaks your CRM’s language.

##### 🛡️ Proxy-Ready for Reliability

Built-in proxy support enables stable, large-scale runs without rate-limiting or IP blocks — ideal for agency-level pediatric nurse practitioners leads campaigns.

##### ⏱️ Stop at Your Target

The actor halts as soon as your maxBusinesses limit is reached — no wasted compute, no overage.

##### 🔄 Schedulable & Repeatable

Set it to run daily, weekly, or monthly to continuously grow and refresh your pediatric nurse practitioners leads.

***

#### 🎯 Use Cases

##### 💼 B2B Outreach & Sales

Build pitch lists targeting independent pediatric clinics, hospital-affiliated practices, and private NP-led offices. Use this as your pediatric nurse practitioners lead scraper to fuel cold email sequences and as a pediatric nurse practitioners lead finder when expanding into new cities.

##### 🧑‍⚕️ Healthcare Staffing & Recruiting

Identify hiring managers and practices actively seeking staff. The pediatric nurse practitioners contact finder surfaces practice inboxes and admin contacts; pair it with the pediatric nurse practitioners email finder to speed outreach.

##### 📣 Local & Regional Marketing

Create geo-targeted campaigns with verified pediatric nurse practitioners email and phone numbers pulled directly from clinic websites.

##### 🤝 Partnership & Referral Development

Find complementary healthcare providers (pediatric specialists, labs, urgent care) using the pediatric nurse practitioners contact scraper to map local ecosystems.

##### 📚 Academic Research & Surveys

Quickly assemble contact info for surveys, studies, or public health initiatives. The pediatric nurse practitioners data scraper exports structured records for analysis.

##### 🏢 Agency Client Delivery

Run repeatable weekly scrapes and deliver fresh lead lists to clients on a predictable schedule — operating as a pediatric nurse practitioners lead scraper in your service stack.

##### 🗃️ CRM Enrichment

Enrich existing records with missing emails, phones, and social links using the pediatric nurse practitioners email finder for faster pipeline movement.

***

#### 📈 How Many Results Can You Get?

Scale from a small prospect list to a massive regional database — results depend on:

- Number of locations added
- Search term breadth (narrow vs. broad niche)
- Website density and email visibility in each market
- maxBusinesses setting and per-location vs. combined mode
- Proxy configuration and run timeout

##### Typical Output Ranges

| Campaign Size | Businesses with Emails |
|---|---|
| Small (1–3 cities) | 20 – 100 |
| Medium (5–15 cities) | 200 – 600 |
| Large (20+ cities / states) | 800 – 1,000+ per run |

Run multiple times across different regions to continuously grow your coverage without hitting hard platform limits.

***

#### 🔌 Integrations & Export Options

Once your run completes, you can:

| Option | Details |
|---|---|
| JSON | Full structured data download |
| CSV / Excel | Import directly into spreadsheets |
| Apify API | Stream results into your own apps or workflows |
| Zapier / Make | Trigger automations when new records are found |
| Webhooks | Push results to your CRM or pipeline on run completion |

Plug directly into Instantly, Smartlead, Apollo, HubSpot, Salesforce, or any platform that accepts CSV/JSON imports.

***

#### 🛠️ Step-by-Step Usage Guide

Step 1 — Log in to Apify\
Create a free account or sign in at apify.com.

Step 2 — Open the Actor\
Search for "Pediatric Nurse Practitioners Email Scraper" in the Apify Store and click Try for free.

Step 3 — Set Your Search Term\
Enter "Pediatric Nurse Practitioners" or a niche variant like "pediatric NP clinic" or "pediatric primary care".

Step 4 — Add Target Locations\
Enter one or more city/state combos — e.g., "New York", "Boston, Massachusetts", "Philadelphia, Pennsylvania".

Step 5 — Set Your Limit\
Choose how many businesses with emails you want — 20 for a quick test, up to 1,000 for a full campaign.

Step 6 — Choose Scaling Strategy

- Combined cap: The total across all locations combined
- Per-location cap: Applies your limit independently to each city

Step 7 — Enable Proxies\
Turn on Apify Proxy for stable, uninterrupted crawling at scale.

Step 8 — Run 🚀\
Click Start and let the Pediatric Nurse Practitioners Email Scraper do the work.

Step 9 — Export\
Download as JSON, CSV, or Excel — or pull via API straight into your stack.

***

#### ⚖️ Legal & Compliance

This actor collects only publicly available business contact information — emails and phone numbers published openly on websites.

Best practices to stay compliant:

- Only use publicly visible contact data
- Do not bypass login walls or paywalls
- Respect each website’s robots.txt and Terms of Service
- Include an unsubscribe option in all outreach
- Follow applicable laws in your jurisdiction

Relevant regulations to be aware of:

| Regulation | Region |
|---|---|
| GDPR | European Union |
| CAN-SPAM Act | United States |
| CASL | Canada |
| PECR | United Kingdom |

This tool is intended for ethical business prospecting and research only. You are responsible for how you use the data collected.

***

#### ❓ Frequently Asked Questions

Q: Does this scrape private or personal emails?\
A: No. The actor only extracts emails that are publicly visible on business websites — practice inboxes, admin contacts, and general inquiry addresses.

Q: Can I search multiple cities in one run?\
A: Yes. Add as many locations as needed. Use per-location capping for even geographic distribution.

Q: Does it deduplicate results?\
A: Yes. Emails are deduplicated per domain to keep your list accurate and clean.

Q: Can I schedule recurring runs?\
A: Absolutely. Use Apify’s built-in scheduler to run weekly or monthly and keep your contacts fresh.

Q: What niches does the search term support?\
A: Any Google Maps searchable term — try "pediatric clinic", "pediatric NP", "children’s primary care", or "school-based health center".

Q: Is a proxy required?\
A: Not for small runs, but proxies are strongly recommended for 200+ business runs to avoid rate limits and ensure reliability.

Q: What export formats are available?\
A: JSON, CSV, and Excel. You can also consume results via the Apify API or webhook.

Q: How is this different from manual Google searching?\
A: Manual search is slow and inconsistent. This automates the entire workflow — from discovery to contact extraction — in minutes.

Q: Can it work as an email extractor for pediatric nurse practitioners?\
A: Yes. It is a dedicated pediatric nurse practitioners email extractor that systematically crawls key pages to capture public inboxes.

Q: Can it help me find contact pages when websites hide emails?\
A: Yes. The pediatric nurse practitioners contact finder locates and follows Contact/About pages, footer links, and social profiles to surface the best available contact paths.

Q: Can agencies white-label or resell this?\
A: Yes. Run it on behalf of clients and deliver fresh datasets on a recurring basis.

***

#### 🧑‍💻 Support & Custom Solutions

Have a question, feature request, or need a custom build?\
Email: scrapermindapi@gmail.com

We’re happy to help with:

- Custom input/output configurations
- Niche-specific adaptations
- Bulk or enterprise run support
- Integration assistance

For any help or custom solution, contact via this mail: scrapermindapi@gmail.com

# Actor input Schema

## `googleMapsSearchTerm` (type: `string`):

Enter the business type or niche for email scraper (e.g., 'coffee shops', 'dentists').

## `googleMapsLocation` (type: `array`):

Target geographic location for the email scraper (e.g., 'Miami, Florida').

## `maxBusinesses` (type: `integer`):

Target number of businesses to find (1-1000). The scraper will stop when this target is reached.

## `scrapeMaxBusinessesPerLocation` (type: `boolean`):

If enabled, the scraper will collect up to `maxBusinesses` results per location. If disabled, it combines all locations up to a single total limit.

## `proxyConfiguration` (type: `object`):

Proxy settings for scraping. Recommended for large-scale scraping.

## Actor input object example

```json
{
  "googleMapsSearchTerm": "Pediatric Nurse Practitioners",
  "googleMapsLocation": [
    "New York"
  ],
  "maxBusinesses": 5,
  "scrapeMaxBusinessesPerLocation": false,
  "proxyConfiguration": {
    "useApifyProxy": 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "googleMapsSearchTerm": "Pediatric Nurse Practitioners",
    "googleMapsLocation": [
        "New York"
    ],
    "maxBusinesses": 5,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("contacts-api/pediatric-nurse-practitioners-email-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "googleMapsSearchTerm": "Pediatric Nurse Practitioners",
    "googleMapsLocation": ["New York"],
    "maxBusinesses": 5,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("contacts-api/pediatric-nurse-practitioners-email-scraper").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 '{
  "googleMapsSearchTerm": "Pediatric Nurse Practitioners",
  "googleMapsLocation": [
    "New York"
  ],
  "maxBusinesses": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call contacts-api/pediatric-nurse-practitioners-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=contacts-api/pediatric-nurse-practitioners-email-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Pediatric Nurse Practitioners Email Scraper",
        "description": "Pediatric nurse practitioners email scraper to extract verified NP emails from children’s hospitals, clinics, and healthcare directories 📧👶 Perfect for healthcare outreach, recruitment, and targeted pediatric medical lead generation.",
        "version": "1.0",
        "x-build-id": "mnDBumKLSBixeZRib"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/contacts-api~pediatric-nurse-practitioners-email-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-contacts-api-pediatric-nurse-practitioners-email-scraper",
                "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/contacts-api~pediatric-nurse-practitioners-email-scraper/runs": {
            "post": {
                "operationId": "runs-sync-contacts-api-pediatric-nurse-practitioners-email-scraper",
                "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/contacts-api~pediatric-nurse-practitioners-email-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-contacts-api-pediatric-nurse-practitioners-email-scraper",
                "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": [
                    "googleMapsLocation",
                    "googleMapsSearchTerm"
                ],
                "properties": {
                    "googleMapsSearchTerm": {
                        "title": "Search Term",
                        "type": "string",
                        "description": "Enter the business type or niche for email scraper (e.g., 'coffee shops', 'dentists').",
                        "default": "Pediatric Nurse Practitioners"
                    },
                    "googleMapsLocation": {
                        "title": "Location",
                        "type": "array",
                        "description": "Target geographic location for the email scraper (e.g., 'Miami, Florida').",
                        "default": [
                            "New York"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxBusinesses": {
                        "title": "Maximum Businesses With Emails",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Target number of businesses to find (1-1000). The scraper will stop when this target is reached.",
                        "default": 5
                    },
                    "scrapeMaxBusinessesPerLocation": {
                        "title": "Scrape Max Businesses Per Location",
                        "type": "boolean",
                        "description": "If enabled, the scraper will collect up to `maxBusinesses` results per location. If disabled, it combines all locations up to a single total limit.",
                        "default": false
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Proxy settings for scraping. Recommended for large-scale scraping."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```