# Google Maps Local SEO Prospect Finder (`coregent/google-maps-local-seo-prospect-finder`) Actor

Find local businesses from Google Maps and identify simple Local SEO prospect opportunities using clean business data and transparent non-AI scoring.

- **URL**: https://apify.com/coregent/google-maps-local-seo-prospect-finder.md
- **Developed by:** [Delowar Munna](https://apify.com/coregent) (community)
- **Categories:** Lead generation, SEO tools
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.40 / 1,000 pospect results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Google Maps Local SEO Prospect Finder

![Google Maps Local SEO Prospect Finder](https://raw.githubusercontent.com/coregentdevspace/google-maps-local-seo-prospect-finder-assets/main/thumbnail-google-maps-local-seo-prospect-finder.jpg)

Find local businesses on Google Maps and rank them as **Local SEO prospects** using transparent non-AI scoring. Returns clean, flat, CSV-friendly lead data — built for **SEO agencies, web designers, lead-generation teams, and local sales prospecting**.

V1 deliberately avoids website crawling, email extraction, full review scraping, photos, and AI enrichment so the run stays **fast and cheap**. You only pay for unique prospect rows that pass your filters and are successfully written to the dataset.

### ✨ Why this scraper

- **SEO-prospect focused** — 25 flat fields tuned for outreach, plus a transparent `local_seo_score` and `reason_tags` per row.
- **Pay-Per-Event** — `$` per saved unique prospect row. Duplicates, filtered rows, and failed pushes are not charged.
- **No login, no cookies, no sessions** — keyword + location, or any Google Maps search URL.
- **CSV-friendly output** — flat structure, no nested objects, drops cleanly into Sheets/Excel/CRMs.
- **Transparent scoring** — rule-based, explained below. No AI black box.

---

### 🚀 Quick start — sample inputs

#### Example 1 — discover prospects in a city

```json
{
  "searches": [
    { "key": "dentists", "value": "Canberra ACT" }
  ],
  "startUrls": [],
  "maxResults": 100,
  "maxResultsPerSearch": 100,
  "language": "en",
  "countryCode": "AU",
  "businessStatus": "any",
  "websiteFilter": "any",
  "phoneFilter": "any",
  "minRating": 0,
  "maxRating": 5,
  "minReviews": 0,
  "maxReviews": 0,
  "includeScore": true,
  "deduplicate": true,
  "proxyConfiguration": { "useApifyProxy": true }
}
````

#### Example 2 — find no-website / low-review prospects across multiple cities

```json
{
  "searches": [
    { "key": "electricians", "value": "Sydney NSW" },
    { "key": "plumbers",     "value": "Melbourne VIC" },
    { "key": "cafes",        "value": "Brisbane QLD" }
  ],
  "startUrls": [],
  "maxResults": 200,
  "maxResultsPerSearch": 80,
  "language": "en",
  "countryCode": "AU",
  "businessStatus": "open",
  "websiteFilter": "noWebsite",
  "phoneFilter": "any",
  "minRating": 0,
  "maxRating": 5,
  "minReviews": 0,
  "maxReviews": 30,
  "includeScore": true,
  "deduplicate": true,
  "proxyConfiguration": { "useApifyProxy": true }
}
```

> The `searches` field uses Apify's **Key/Value form editor** — the **Key** column is the business keyword (e.g. `dentists`), the **Value** column is the location (e.g. `Canberra ACT`). Add one row per search.

***

### 📦 Output

The dataset has one view: **Local SEO prospects** — a 25-column flat table.

![Local SEO prospects table view](https://raw.githubusercontent.com/coregentdevspace/google-maps-local-seo-prospect-finder-assets/main/google-maps-local-seo-prospect-finder-output-local-seo-prospects-table-view.png)

#### Sample record — Local SEO prospects

```json
{
  "business_id": "0x6b164f2bc100c4e7:0xd21f9af5314ab950",
  "place_url": "https://www.google.com/maps/place/Weber+Plumbing/data=!4m7!3m6!1s0x6b164f2bc100c4e7:0xd21f9af5314ab950!8m2!3d-35.3764967!4d149.2467654!16s%2Fg%2F11bc95wrz3!19sChIJ58QAwStPFmsRULlKMfWaH9I",
  "business_name": "Weber Plumbing",
  "category": "Plumber",
  "address": "32 Doeberl Pl",
  "city": null,
  "state_region": null,
  "country_code": "AU",
  "phone": "0423 682 816",
  "website": null,
  "domain": null,
  "rating": 5,
  "review_count": 20,
  "business_status": "open",
  "opening_hours_summary": null,
  "latitude": -35.3764967,
  "longitude": 149.2467654,
  "local_seo_score": 42,
  "local_seo_label": "medium_opportunity",
  "reason_tags": "no_website|low_review_count",
  "input_query": "plumbers",
  "input_location": "Queanbeyan NSW",
  "input_url": null,
  "input_index": 1,
  "scraped_at": "2026-05-06T06:56:24.113Z"
}
```

#### Output fields (25)

`business_id`, `place_url`, `business_name`, `category`, `address`, `city`, `state_region`, `country_code`, `phone`, `website`, `domain`, `rating`, `review_count`, `business_status`, `opening_hours_summary`, `latitude`, `longitude`, `local_seo_score`, `local_seo_label`, `reason_tags`, `input_query`, `input_location`, `input_url`, `input_index`, `scraped_at`.

***

### 🎯 Local SEO opportunity score

Transparent rule-based score (0–100) — **higher means stronger prospect opportunity**. Computed only from visible Google Maps fields. No AI, no enrichment, nothing hidden.

| Signal                       | Points |
| ---------------------------- | -----: |
| No website                   |    +30 |
| Reviews 0–10                 |    +20 |
| Reviews 11–30                |    +12 |
| Rating < 4.0                 |    +15 |
| Missing phone                |    +10 |
| Missing category             |    +10 |
| Unknown business status      |     +5 |

**Labels**: `high_opportunity` (70–100) · `medium_opportunity` (40–69) · `low_opportunity` (0–39).
**`reason_tags`** is a pipe-separated string (CSV-friendly), e.g. `no_website|low_review_count|missing_phone`.

***

### 💰 Pricing

**Pay-Per-Event**. The actor charges a single `prospect-result` event for each unique, filtered prospect row that is successfully written to the dataset. The actor honors the user-configured per-run spending cap (Apify `eventChargeLimitReached`) and stops cleanly when reached.

Not charged:

- Duplicates (de-duplicated by `business_id`, `place_url`, `domain` + name, name + address, etc.).
- Rows filtered out by `businessStatus`, `websiteFilter`, `phoneFilter`, `minRating`, `maxRating`, `minReviews`, or `maxReviews`.
- Rows missing a `business_name` or all of `place_url` / `address` / `phone` / `website`.
- Failed dataset pushes.
- Anything after the per-run spending cap is reached.

***

### 📊 Run summary

After each run, a `RUN-SUMMARY` entry is written to the key-value store:

```json
{
  "inputs_total": 3,
  "successful_inputs": 3,
  "failed_inputs": 0,
  "invalid_inputs": 0,
  "raw_results_found": 240,
  "results_saved": 187,
  "duplicates_removed": 21,
  "filtered_out": 32,
  "charged_events": 187,
  "blocked_requests": 0,
  "retry_count": 4,
  "runtime_seconds": 142,
  "scraped_at": "2026-05-06T00:00:00.000Z"
}
```

`charged_events` always equals `results_saved`.

***

#### 🚦 Proxy policy

Use **Apify Datacenter** proxy or **no proxy** for normal runs — both work reliably for Google Maps search at this actor's conservative concurrency (max 3).

**Apify Residential proxy is not supported.** The actor will fail at startup if `apifyProxyGroups` includes `RESIDENTIAL`. Reason: in pay-per-event actors, residential bandwidth (~/GB) is billed to the developer, not the run user, so a single bandwidth-heavy run could exceed the per-result event revenue.

If you genuinely need residential routing, supply your own residential provider via the proxy editor's **Custom proxy URLs** field — that traffic goes through your provider, not Apify, and is unaffected:

```
http://user:pass@proxy.iproyal.com:12321
http://user:pass@proxy.brightdata.com:22225
http://user:pass@proxy.oxylabs.io:7777
```

***

### ⚙️ Filters

| Filter           | Effect                                                              |
| ---------------- | ------------------------------------------------------------------- |
| `businessStatus` | `any` / `open` / `closed`.                                          |
| `websiteFilter`  | `any` / `hasWebsite` / `noWebsite`.                                 |
| `phoneFilter`    | `any` / `hasPhone` / `noPhone`.                                     |
| `minRating`      | Drop businesses below this star rating (`0` disables).              |
| `maxRating`      | Drop businesses above this star rating (`5` disables).              |
| `minReviews`     | Drop businesses with fewer reviews (`0` disables).                  |
| `maxReviews`     | Drop businesses with more reviews (`0` / unset disables).           |
| `deduplicate`    | Drop duplicates across overlapping searches (recommended ON).       |

Filters are applied **after** extraction and **before** dataset push or event charge.

***

### 🚧 Limitations (V1)

- **Cards-only extraction**: V1 reads each business directly from the search results panel and does not click into individual place detail panels. Phone, website, full opening hours, and `business_id` only appear when Google surfaces them on the card itself.
- No website crawling, email extraction, or social link extraction.
- No full review text or sentiment.
- No photos, menus, prices, or popular times.
- No login/cookie/session-based scraping.
- Address parsing into `city` / `state_region` is best-effort; the full `address` field is the source of truth.
- Per-search hard cap is **1,000 results**; per-run hard cap is **5,000 results**.

***

### 🛠️ Technical notes

- **Stack**: Node.js 22 · Apify SDK 3 · Crawlee · Puppeteer.
- **Concurrency**: `min=1`, `max=3` (conservative to reduce blocking).
- **Memory**: 1 GB min · 2 GB default · 4 GB max.
- **Proxy**: Apify Proxy enabled by default; custom configs accepted.
- **Diagnostics**: On the first failed render, the actor saves the page HTML and URL to the key-value store as `debug-no-feed-html` / `debug-zero-cards-html`.

# Actor input Schema

## `searches` (type: `array`):

List of keyword + location pairs to search on Google Maps. Each row builds a search like "dentists in Canberra ACT". Required unless Start URLs are provided. "Key" is the business keyword, "Value" is the location.

## `startUrls` (type: `array`):

Optional list of Google Maps search/result URLs. Useful for advanced users who want to paste pre-built Maps search URLs. Invalid URLs are skipped and recorded in the run summary.

## `maxResults` (type: `integer`):

Global cap on the total number of saved unique prospect rows for the whole run. The actor stops cleanly when this limit is reached.

## `maxResultsPerSearch` (type: `integer`):

Per-input cap on the number of unique prospect rows saved from each search/start URL. Prevents one input from consuming the whole run.

## `language` (type: `string`):

Language code used for Google Maps UI (lowercase, e.g. en, es, de).

## `countryCode` (type: `string`):

Two-letter ISO country code used as a Google Maps locale hint (e.g. AU, US, GB).

## `businessStatus` (type: `string`):

Filter by visible open/closed status. "any" keeps everything; "open" keeps only open listings; "closed" keeps only closed listings.

## `websiteFilter` (type: `string`):

Filter by website availability. "any" keeps everything; "hasWebsite" keeps only businesses with a website; "noWebsite" keeps only businesses without a website.

## `phoneFilter` (type: `string`):

Filter by phone availability. "any" keeps everything; "hasPhone" keeps only businesses with a phone; "noPhone" keeps only businesses without a phone.

## `minRating` (type: `integer`):

Drop businesses with a rating below this value (0-5). Set to 0 to disable.

## `maxRating` (type: `integer`):

Drop businesses with a rating above this value (0-5). Useful for finding low-rating opportunities. Missing rating passes when this is below 5.

## `minReviews` (type: `integer`):

Drop businesses with fewer reviews than this value. Set to 0 to disable.

## `maxReviews` (type: `integer`):

Drop businesses with more reviews than this value. Useful for finding low-review opportunities. Leave empty (or 0) to disable.

## `includeScore` (type: `boolean`):

When enabled, adds local\_seo\_score, local\_seo\_label, and reason\_tags to each row using transparent rule-based scoring (no AI).

## `deduplicate` (type: `boolean`):

Remove duplicate businesses across overlapping searches using business\_id, place\_url, name+address, and other normalized keys.

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

Apify Proxy configuration. Defaults to Apify Proxy enabled. Recommended for production runs.

## Actor input object example

```json
{
  "searches": [
    {
      "key": "dentists",
      "value": "Canberra ACT"
    },
    {
      "key": "plumbers",
      "value": "Queanbeyan NSW"
    }
  ],
  "startUrls": [],
  "maxResults": 100,
  "maxResultsPerSearch": 200,
  "language": "en",
  "countryCode": "AU",
  "businessStatus": "any",
  "websiteFilter": "any",
  "phoneFilter": "any",
  "minRating": 0,
  "maxRating": 5,
  "minReviews": 0,
  "maxReviews": 0,
  "includeScore": true,
  "deduplicate": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

Flat 25-field table of every prospect row pushed to the dataset.

# 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 = {
    "searches": [
        {
            "key": "dentists",
            "value": "Canberra ACT"
        },
        {
            "key": "plumbers",
            "value": "Queanbeyan NSW"
        }
    ],
    "startUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("coregent/google-maps-local-seo-prospect-finder").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 = {
    "searches": [
        {
            "key": "dentists",
            "value": "Canberra ACT",
        },
        {
            "key": "plumbers",
            "value": "Queanbeyan NSW",
        },
    ],
    "startUrls": [],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("coregent/google-maps-local-seo-prospect-finder").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 '{
  "searches": [
    {
      "key": "dentists",
      "value": "Canberra ACT"
    },
    {
      "key": "plumbers",
      "value": "Queanbeyan NSW"
    }
  ],
  "startUrls": [],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call coregent/google-maps-local-seo-prospect-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=coregent/google-maps-local-seo-prospect-finder",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Maps Local SEO Prospect Finder",
        "description": "Find local businesses from Google Maps and identify simple Local SEO prospect opportunities using clean business data and transparent non-AI scoring.",
        "version": "1.0",
        "x-build-id": "FwaU8prvEEDs10qu3"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/coregent~google-maps-local-seo-prospect-finder/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-coregent-google-maps-local-seo-prospect-finder",
                "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/coregent~google-maps-local-seo-prospect-finder/runs": {
            "post": {
                "operationId": "runs-sync-coregent-google-maps-local-seo-prospect-finder",
                "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/coregent~google-maps-local-seo-prospect-finder/run-sync": {
            "post": {
                "operationId": "run-sync-coregent-google-maps-local-seo-prospect-finder",
                "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",
                "properties": {
                    "searches": {
                        "title": "Searches (keyword + location)",
                        "type": "array",
                        "description": "List of keyword + location pairs to search on Google Maps. Each row builds a search like \"dentists in Canberra ACT\". Required unless Start URLs are provided. \"Key\" is the business keyword, \"Value\" is the location.",
                        "default": [
                            {
                                "key": "dentists",
                                "value": "Canberra ACT"
                            }
                        ],
                        "items": {
                            "type": "object",
                            "required": [
                                "key",
                                "value"
                            ],
                            "properties": {
                                "key": {
                                    "type": "string",
                                    "title": "Key"
                                },
                                "value": {
                                    "type": "string",
                                    "title": "Value"
                                }
                            }
                        }
                    },
                    "startUrls": {
                        "title": "Start URLs (advanced)",
                        "type": "array",
                        "description": "Optional list of Google Maps search/result URLs. Useful for advanced users who want to paste pre-built Maps search URLs. Invalid URLs are skipped and recorded in the run summary.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResults": {
                        "title": "Max results (per run)",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Global cap on the total number of saved unique prospect rows for the whole run. The actor stops cleanly when this limit is reached.",
                        "default": 100
                    },
                    "maxResultsPerSearch": {
                        "title": "Max results per search",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Per-input cap on the number of unique prospect rows saved from each search/start URL. Prevents one input from consuming the whole run.",
                        "default": 200
                    },
                    "language": {
                        "title": "Language",
                        "type": "string",
                        "description": "Language code used for Google Maps UI (lowercase, e.g. en, es, de).",
                        "default": "en"
                    },
                    "countryCode": {
                        "title": "Country code",
                        "type": "string",
                        "description": "Two-letter ISO country code used as a Google Maps locale hint (e.g. AU, US, GB).",
                        "default": "AU"
                    },
                    "businessStatus": {
                        "title": "Business status",
                        "enum": [
                            "any",
                            "open",
                            "closed"
                        ],
                        "type": "string",
                        "description": "Filter by visible open/closed status. \"any\" keeps everything; \"open\" keeps only open listings; \"closed\" keeps only closed listings.",
                        "default": "any"
                    },
                    "websiteFilter": {
                        "title": "Website filter",
                        "enum": [
                            "any",
                            "hasWebsite",
                            "noWebsite"
                        ],
                        "type": "string",
                        "description": "Filter by website availability. \"any\" keeps everything; \"hasWebsite\" keeps only businesses with a website; \"noWebsite\" keeps only businesses without a website.",
                        "default": "any"
                    },
                    "phoneFilter": {
                        "title": "Phone filter",
                        "enum": [
                            "any",
                            "hasPhone",
                            "noPhone"
                        ],
                        "type": "string",
                        "description": "Filter by phone availability. \"any\" keeps everything; \"hasPhone\" keeps only businesses with a phone; \"noPhone\" keeps only businesses without a phone.",
                        "default": "any"
                    },
                    "minRating": {
                        "title": "Minimum rating",
                        "minimum": 0,
                        "maximum": 5,
                        "type": "integer",
                        "description": "Drop businesses with a rating below this value (0-5). Set to 0 to disable.",
                        "default": 0
                    },
                    "maxRating": {
                        "title": "Maximum rating",
                        "minimum": 0,
                        "maximum": 5,
                        "type": "integer",
                        "description": "Drop businesses with a rating above this value (0-5). Useful for finding low-rating opportunities. Missing rating passes when this is below 5.",
                        "default": 5
                    },
                    "minReviews": {
                        "title": "Minimum review count",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop businesses with fewer reviews than this value. Set to 0 to disable.",
                        "default": 0
                    },
                    "maxReviews": {
                        "title": "Maximum review count",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop businesses with more reviews than this value. Useful for finding low-review opportunities. Leave empty (or 0) to disable.",
                        "default": 0
                    },
                    "includeScore": {
                        "title": "Include Local SEO opportunity score",
                        "type": "boolean",
                        "description": "When enabled, adds local_seo_score, local_seo_label, and reason_tags to each row using transparent rule-based scoring (no AI).",
                        "default": true
                    },
                    "deduplicate": {
                        "title": "Deduplicate results",
                        "type": "boolean",
                        "description": "Remove duplicate businesses across overlapping searches using business_id, place_url, name+address, and other normalized keys.",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify Proxy configuration. Defaults to Apify Proxy enabled. Recommended for production runs.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
