LocalFalcon GBP Monitor

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

---

Monitor Google Business Profile changes using LocalFalcon API. Track hours, categories, photos, descriptions, and more.

Features

• Profile Snapshots: Capture the complete state of a GBP profile at any point in time
• Change Detection: Compare snapshots to detect what changed (hours, categories, photos, etc.)
• Batch Monitoring: Monitor multiple locations at once
• Change History: View historical changes for a location over time
• Change Significance: Categorizes changes as high/medium/low significance
• Webhook Support: Get notified when monitoring completes

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
See input schema

Output Format

Snapshot Output

{
  "snapshotId": "snap-demo-001",
  "placeId": "ChIJ4SZQ2nL2D4gRwPhDqdXKMGs",
  "businessName": "Drive Social Media",
  "address": "1 N 1st St, St. Louis, MO 63102",
  "phone": "+1 (314) 555-0123",
  "website": "https://drivesocialmedia.com",
  "primaryCategory": "Marketing Agency",
  "additionalCategories": ["Social Media Agency", "Digital Marketing Agency"],
  "description": "Drive Social Media is a data-driven marketing agency...",
  "hours": [...],
  "photos": [...],
  "photoCount": 24,
  "reviewCount": 156,
  "averageRating": 4.8,
  "snapshotTakenAt": "2025-01-15T10:00:00Z"
}

Comparison Output

{
  "placeId": "ChIJ4SZQ2nL2D4gRwPhDqdXKMGs",
  "businessName": "Drive Social Media",
  "hasChanges": true,
  "changes": [
    {
      "field": "hours.Monday",
      "previousValue": {"open": "09:00", "close": "17:00"},
      "newValue": {"open": "08:00", "close": "18:00"},
      "changeType": "modified",
      "significance": "high"
    }
  ],
  "summary": {
    "totalChanges": 3,
    "highSignificanceChanges": 2,
    "categoriesChanged": ["hours", "photos"]
  }
}

Pricing

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

• GBP Monitor Completed: $0.03 per monitoring check

Use Cases

1. Client Onboarding: Take initial snapshot when onboarding a new client
2. Competitor Monitoring: Track when competitors update their profiles
3. QA Checks: Verify changes were made correctly after GBP optimization
4. Alerts: Get notified when unauthorized changes are made to client profiles
5. Reporting: Show clients what changes were made over time

---

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