LocalFalcon Grid Scanner

What is LocalFalcon?

LocalFalcon is a local SEO tool that tracks Google Business Profile rankings across a geographic grid. It shows exactly where a business ranks in local search results.

How to Get Your LocalFalcon API Key

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

---

Geographic ranking grid scans for local SEO using LocalFalcon API. Track local pack rankings across geographic areas.

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

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

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)

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

This actor uses pay-per-event billing: Pay-per-event pricing:

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

Use Cases

• Data collection
• Research
• Automation

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal