LocalFalcon Grid Scanner

Run local ranking grid scans to visualize Google Maps visibility across a geographic area.

Built by John Rippy | johnrippy.link

---

Overview

This actor integrates with the LocalFalcon API to run grid-based local ranking scans. See exactly where your business ranks in Google Maps across a geographic grid - essential for local SEO strategy and competitor analysis.

Features

• Grid Scanning: Create 5x5, 7x7, 9x9, 11x11, 13x13, or 15x15 ranking grids
• Custom Radius: Set scan radius from 1 to 50 miles
• Keyword Tracking: Track any local search keyword
• Competitor Visibility: See competitor rankings at each grid point
• Trend Analysis: Compare scans over time to track progress
• Visual Output: Grid data ready for map visualization
• BYOK Pattern: Bring your own LocalFalcon API key

Input Parameters

Parameter	Type	Required	Description
businessName	string	Yes	Name of the business to track
keyword	string	Yes	Search keyword (e.g., "plumber near me")
location	string	Yes	Center point (e.g., "Saint Louis, MO")
latitude	number	No	Exact latitude for center point
longitude	number	No	Exact longitude for center point
gridSize	number	No	Grid size: 5, 7, 9, 11, 13, or 15 (default: 9)
radiusMiles	number	No	Scan radius in miles (default: 10)
localFalconApiKey	string	Yes	Your LocalFalcon API key
webhookUrl	string	No	URL to receive results when complete
demoMode	boolean	No	Run with sample data (no API calls)

Example Usage

Basic Grid Scan

{
  "businessName": "Joe's Plumbing",
  "keyword": "plumber near me",
  "location": "Saint Louis, MO",
  "gridSize": 9,
  "radiusMiles": 10,
  "localFalconApiKey": "your-api-key"
}

Large Area Scan

{
  "businessName": "ABC HVAC",
  "keyword": "hvac repair",
  "latitude": 38.6270,
  "longitude": -90.1994,
  "gridSize": 15,
  "radiusMiles": 25,
  "localFalconApiKey": "your-api-key"
}

Output Format

{
  "status": "success",
  "timestamp": "2025-12-28T12:00:00.000Z",
  "data": {
    "businessName": "Joe's Plumbing",
    "keyword": "plumber near me",
    "gridSize": 9,
    "radiusMiles": 10,
    "centerPoint": {
      "lat": 38.6270,
      "lng": -90.1994
    },
    "summary": {
      "avgRank": 4.2,
      "top3Count": 45,
      "top10Count": 72,
      "notRanking": 9,
      "totalPoints": 81
    },
    "gridData": [
      {
        "row": 0,
        "col": 0,
        "lat": 38.7120,
        "lng": -90.2844,
        "rank": 3,
        "competitors": [
          { "name": "Competitor A", "rank": 1 },
          { "name": "Competitor B", "rank": 2 }
        ]
      }
    ]
  }
}

Pricing

Pay-per-event pricing:

• local-grid-scan: Per grid scan (price varies by grid size)

Demo Mode

Set demoMode: true to test with sample data without consuming LocalFalcon API credits.

Related Actors

Part of the SEO Intelligence Suite:

• localhowl~seo-intelligence-mcp-server - Unified MCP orchestrator
• localhowl~dataforseo-serp - SERP rankings and keyword research
• localhowl~dataforseo-onpage - On-page SEO audits
• localhowl~dataforseo-backlinks - Backlink analysis
• localhowl~serpapi-realtime - Real-time SERP snapshots

Support

• GitHub: Report issues
• LinkedIn: John Rippy
• Website: johnrippy.link