LocalFalcon GBP Monitor

Monitor Google Business Profile (GBP) changes using the LocalFalcon API. Track when client profiles change their 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

Tasks

1. Snapshot (snapshot)

Take a point-in-time snapshot of a GBP profile including:

• Business name and address
• Phone and website
• Primary and additional categories
• Business description
• Hours of operation
• Photos and photo count
• Review count and average rating

2. Compare (compare)

Compare two snapshots to detect changes:

• Identifies what fields changed
• Shows previous and new values
• Assigns significance levels (high/medium/low)
• Provides a summary of all changes

3. Monitor Batch (monitor_batch)

Monitor multiple locations at once:

• Checks each location for changes since last snapshot
• Returns summary of which locations changed
• Ideal for agencies managing multiple client locations

4. Change History (change_history)

Get historical changes for a location:

• View all changes within a date range
• See change frequency by category
• Identify most frequently changed fields

Input Examples

Take a Snapshot

{
  "task": "snapshot",
  "placeId": "ChIJ4SZQ2nL2D4gRwPhDqdXKMGs",
  "localFalconApiKey": "your-api-key"
}

Compare Snapshots

{
  "task": "compare",
  "snapshotId1": "snap-001",
  "snapshotId2": "snap-002",
  "localFalconApiKey": "your-api-key"
}

Monitor Multiple Locations

{
  "task": "monitor_batch",
  "placeIds": [
    "ChIJ4SZQ2nL2D4gRwPhDqdXKMGs",
    "ChIJ5ZQ2nL2D4gRwPhDqdXKMGs",
    "ChIJ6ZQ2nL2D4gRwPhDqdXKMGs"
  ],
  "localFalconApiKey": "your-api-key"
}

Get Change History

{
  "task": "change_history",
  "placeId": "ChIJ4SZQ2nL2D4gRwPhDqdXKMGs",
  "dateRange": {
    "start": "2024-12-01",
    "end": "2025-01-15"
  },
  "localFalconApiKey": "your-api-key"
}

Output

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"]
  }
}

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

Pricing

Pay-per-event pricing:

• GBP Monitor Completed: $0.03 per monitoring check

Demo Mode

Set demoMode: true to test with sample data without requiring an API key.

Author

By John Rippy | johnrippy.link