LocalFalcon Grid Scanner - Geographic Local Pack Ranking Visualization

Create geographic ranking grids showing exactly where a business ranks in local search results across a map. Similar to LocalFalcon's signature grid visualization. See rank position at every point in a 5x5, 7x7, 9x9, 11x11, 13x13, or 15x15 grid centered on a location. Track multiple keywords, see competitor rankings, and identify geographic ranking opportunities. BYOK (Bring Your Own Key) - use your LocalFalcon API key.

Features

• Grid Visualization - 5x5 to 15x15 ranking grids
• Custom Radius - 1 to 50 mile scan radius
• Multi-Keyword Tracking - Track multiple search terms per scan
• Competitor Visibility - See who ranks at each grid point
• Position Colors - Green (1-3), Yellow (4-10), Red (11-20), Gray (not ranking)
• Average Rank Calculation - Overall ranking performance score
• Top 3 Coverage - Percentage of grid where you rank top 3
• Trend Analysis - Compare scans over time
• Geographic Insights - Identify strong/weak areas
• Heatmap Data - Ready for map visualization
• Webhook Support - Async delivery for automation
• Demo Mode - Test with sample data before going live

Who Should Use This Actor?

Local SEO Agencies

Show clients exactly where they rank (and don't rank) geographically. Create visual reports that demonstrate the value of local SEO work.

Multi-Location Businesses

Identify geographic coverage gaps between locations. Optimize service area targeting based on actual ranking data.

Franchise Development Teams

Evaluate potential new locations based on competitive grid analysis. Find underserved geographic areas.

Local SEO Specialists

Track ranking improvements over time with before/after grids. Identify optimization opportunities in weak areas.

Marketing Managers

Visualize local search performance for executive reporting. Justify local SEO budget with clear ranking data.

Business Owners

Understand your local search visibility at a glance. See exactly where customers can find you.

Quick Start

Demo Mode (Free Test)

{
  "demoMode": true
}

Basic Grid Scan

{
  "localFalconApiKey": "your_localfalcon_api_key",
  "businessName": "Joe's Plumbing",
  "keyword": "plumber near me",
  "location": "Saint Louis, MO",
  "gridSize": 9,
  "radiusMiles": 10,
  "demoMode": false
}

Large Coverage Grid

{
  "localFalconApiKey": "your_localfalcon_api_key",
  "businessName": "Joe's Plumbing",
  "keyword": "plumber near me",
  "location": "Saint Louis, MO",
  "gridSize": 15,
  "radiusMiles": 25,
  "demoMode": false
}

Precise Location (Lat/Lng)

{
  "localFalconApiKey": "your_localfalcon_api_key",
  "businessName": "Joe's Plumbing",
  "keyword": "emergency plumber",
  "latitude": 38.6270,
  "longitude": -90.1994,
  "gridSize": 11,
  "radiusMiles": 15,
  "demoMode": false
}

Multiple Keywords

{
  "localFalconApiKey": "your_localfalcon_api_key",
  "businessName": "Joe's Plumbing",
  "keywords": ["plumber near me", "emergency plumber", "drain cleaning"],
  "location": "Saint Louis, MO",
  "gridSize": 7,
  "radiusMiles": 10,
  "demoMode": false
}

With Webhook Delivery

{
  "localFalconApiKey": "your_localfalcon_api_key",
  "businessName": "Joe's Plumbing",
  "keyword": "plumber near me",
  "location": "Saint Louis, MO",
  "gridSize": 9,
  "radiusMiles": 10,
  "webhookUrl": "https://hooks.zapier.com/...",
  "demoMode": false
}

How to Get Your LocalFalcon API Key

1. Sign up at LocalFalcon
2. Go to Settings → API
3. Generate or copy your API key
4. Paste it in the localFalconApiKey field

Note: LocalFalcon API requires an active subscription.

Input Parameters

Parameter	Type	Default	Description
localFalconApiKey	string	-	Your LocalFalcon API key (required)
businessName	string	-	Name of business to track
keyword	string	-	Single search keyword
keywords	array	-	Multiple keywords (alternative)
location	string	-	Center point city/address
latitude	number	-	Exact center latitude
longitude	number	-	Exact center longitude
gridSize	number	9	Grid size: 5, 7, 9, 11, 13, or 15
radiusMiles	number	10	Scan radius in miles (1-50)
demoMode	boolean	true	Return sample data
webhookUrl	string	-	Webhook URL for results
webhookPlatform	string	"custom"	Platform: zapier, make, n8n, custom

Grid Size Reference

Grid Size	Total Points	Best For
5×5	25	Quick overview
7×7	49	Standard tracking
9×9	81	Detailed analysis
11×11	121	Large service areas
13×13	169	Metro coverage
15×15	225	Regional analysis

Radius Guidelines

Radius	Best For
1-5 miles	Neighborhood businesses
5-10 miles	City-wide service
10-25 miles	Metropolitan coverage
25-50 miles	Regional service

Output Format

{
  "status": "success",
  "timestamp": "2026-01-28T10:30:00.000Z",
  "scanId": "scan-20260128-001",
  "data": {
    "businessName": "Joe's Plumbing",
    "keyword": "plumber near me",
    "gridSize": 9,
    "radiusMiles": 10,
    "centerPoint": {
      "location": "Saint Louis, MO",
      "lat": 38.6270,
      "lng": -90.1994
    },
    "summary": {
      "avgRank": 4.2,
      "medianRank": 3,
      "top3Count": 45,
      "top3Percent": 55.6,
      "top10Count": 72,
      "top10Percent": 88.9,
      "notRanking": 9,
      "notRankingPercent": 11.1,
      "totalPoints": 81,
      "bestRank": 1,
      "worstRank": 18
    },
    "gridData": [
      {
        "row": 0,
        "col": 0,
        "lat": 38.7120,
        "lng": -90.2844,
        "rank": 3,
        "rankColor": "green",
        "localPack": true,
        "competitors": [
          {"name": "Competitor A", "rank": 1},
          {"name": "Competitor B", "rank": 2}
        ]
      },
      {
        "row": 0,
        "col": 1,
        "lat": 38.7120,
        "lng": -90.2419,
        "rank": 1,
        "rankColor": "green",
        "localPack": true,
        "competitors": [
          {"name": "Competitor B", "rank": 2},
          {"name": "Competitor C", "rank": 3}
        ]
      }
    ],
    "heatmapData": {
      "bounds": {
        "north": 38.7970,
        "south": 38.4570,
        "east": -89.9144,
        "west": -90.4844
      },
      "intensityScale": [
        {"rank": 1, "color": "#00ff00", "intensity": 1.0},
        {"rank": 3, "color": "#22ff00", "intensity": 0.9},
        {"rank": 10, "color": "#ffff00", "intensity": 0.5},
        {"rank": 20, "color": "#ff0000", "intensity": 0.1}
      ]
    },
    "geographicInsights": {
      "strongAreas": ["Northwest", "Central"],
      "weakAreas": ["Southeast"],
      "opportunities": [
        "Southeast quadrant has low coverage - consider GBP optimization for this area"
      ]
    },
    "topCompetitors": [
      {"name": "Competitor A", "avgRank": 2.8, "top3Count": 52},
      {"name": "Competitor B", "avgRank": 3.5, "top3Count": 41},
      {"name": "Competitor C", "avgRank": 5.2, "top3Count": 28}
    ]
  },
  "billingEvents": [
    {"event": "grid_scan", "gridSize": 9, "points": 81, "unitPrice": 0.02, "total": 1.62}
  ]
}

Rank Color Coding

Color	Rank Range	Meaning
Green	1-3	Top of local pack
Yellow	4-10	Page 1 (below pack)
Red	11-20	Page 2
Gray	Not ranking	Not in top 20

Pricing (Pay-Per-Event)

Event	Description	Price
grid_point	Per ranking check point	$0.02

Example costs by grid size:

• 5×5 grid (25 points): 25 × $0.02 = $0.50
• 7×7 grid (49 points): 49 × $0.02 = $0.98
• 9×9 grid (81 points): 81 × $0.02 = $1.62
• 11×11 grid (121 points): 121 × $0.02 = $2.42
• 13×13 grid (169 points): 169 × $0.02 = $3.38
• 15×15 grid (225 points): 225 × $0.02 = $4.50
• Demo mode: $0.00

Note: You also consume LocalFalcon API credits (billed separately).

Common Scenarios

Scenario 1: Monthly Client Reporting

{
  "localFalconApiKey": "your_key",
  "businessName": "Client Business",
  "keyword": "main service near me",
  "location": "Client City, ST",
  "gridSize": 9,
  "radiusMiles": 10,
  "webhookUrl": "https://hooks.zapier.com/...",
  "demoMode": false
}

Monthly grid scans for client ranking reports.

Scenario 2: Competitive Analysis

{
  "localFalconApiKey": "your_key",
  "businessName": "Competitor Name",
  "keyword": "industry keyword",
  "location": "Your City, ST",
  "gridSize": 11,
  "radiusMiles": 15,
  "demoMode": false
}

Analyze competitor geographic strength.

Scenario 3: Before/After Optimization

{
  "localFalconApiKey": "your_key",
  "businessName": "Client Business",
  "keywords": ["primary keyword", "secondary keyword"],
  "location": "Client City, ST",
  "gridSize": 7,
  "radiusMiles": 10,
  "demoMode": false
}

Track ranking improvements after optimization work.

Webhook & Automation Integration

Zapier / Make.com / n8n

1. Create a webhook trigger in your automation platform
2. Copy the webhook URL to webhookUrl
3. Route grid data to visualization tools

Popular automations:

• Grid data -> Google Sheets (historical tracking)
• Monthly scan -> Email report to client
• Low coverage alert -> Slack notification
• Grid data -> Custom dashboard visualization

Apify Scheduled Runs

Schedule weekly or monthly scans for ongoing rank tracking.

LocalFalcon Suite Comparison

Actor	Best For
Grid Scanner	Geographic ranking visualization
GBP Monitor	Profile change detection
Local Business Intelligence Suite	Complete local SEO audit

FAQ

Q: How is this different from LocalFalcon's web app?

A: Same underlying data, but API access for automation. Integrate grid scans into your workflows, reports, and dashboards.

Q: Can I track competitors?

A: The scan shows competitor rankings at each point. Enter a competitor's name as businessName to see their grid.

Q: How often should I scan?

A: Monthly is standard for client reporting. Weekly for active optimization campaigns. On-demand before/after changes.

Q: What if my business doesn't show in the local pack?

A: Grid points where you don't rank show "notRanking". This helps identify geographic optimization opportunities.

Q: Can I visualize the data?

A: The output includes heatmapData with coordinates and colors. Use with Google Maps API or Leaflet for visualization.

Common Problems & Solutions

"Business not found at grid point"

• Business may not rank in local pack at that location
• This is useful data - shows coverage gaps
• Check notRanking count in summary

"Invalid location"

• Verify city/state format ("City, ST")
• Or use exact lat/lng coordinates
• Location must be in LocalFalcon's coverage

"Scan taking too long"

• Larger grids take longer (15×15 = 225 API calls)
• Use webhook for async delivery
• Start with smaller grid (7×7) for testing

"Demo data showing"

• Set demoMode: false
• Provide valid localFalconApiKey

---

📞 Support

• Actor Arsenal: Full Actor Catalog
• Developer: John Rippy

---

Built by John Rippy | Actor Arsenal