Official Google OAuth Integration

LocalEdge Guardian API

Real-time Google Business Profile alerts via webhooks. Protect your locations. Automate your ops.

Authentication

All requests require your API key in the X-Api-Key header.

curl https://avision.org/api/v1/guardian/subscriptions \
  -H "X-Api-Key: YOUR_API_KEY"

Endpoints

POST/api/v1/guardian/subscribe

Subscribe a GBP location to webhook events (and optional email digest).

curl -X POST https://avision.org/api/v1/guardian/subscribe \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gbp_id": "YOUR_GBP_ID",
    "profile_id": 123,
    "webhook_url": "https://yourapp.com/webhook",
    "events": ["hours_changed","status_suspended"],
    "notify_email": "you@yourcompany.com"
  }'

GET/api/v1/guardian/subscriptions

List all active subscriptions for your API key.

curl https://avision.org/api/v1/guardian/subscriptions \
  -H "X-Api-Key: YOUR_API_KEY"

DELETE/api/v1/guardian/subscribe/{id}

Deactivate a subscription by ID.

curl -X DELETE https://avision.org/api/v1/guardian/subscribe/1 \
  -H "X-Api-Key: YOUR_API_KEY"

GET/api/v1/guardian/logs/{profile_id}

Fetch recent webhook delivery logs for a profile.

curl https://avision.org/api/v1/guardian/logs/123 \
  -H "X-Api-Key: YOUR_API_KEY"

Events catalog

Map API event names to the Google Business Profile fields we monitor.

Event	GBP Field
`hours_changed`	`regularHours`
`title_changed`	`title`
`phone_changed`	`phoneNumbers`
`address_changed`	`storefrontAddress`
`website_changed`	`websiteUri`
`description_changed`	`description`
`categories_changed`	`categories`
`special_hours_changed`	`specialHours`
`open_status_changed`	`openInfo`
`service_area_changed`	`serviceArea`
`appointment_url_changed`	`url_appointment`
`appointments_changed`	`offers_online_appointments`
`location_changed`	`latlng`
`additional_categories_changed`	`additional_categories`
`competitor_overtake`	`competitor_overtake`
`status_suspended`	`suspension`

Webhook payload

Each delivery is a JSON POST signed with HMAC-SHA256.

{
  "event": "hours_changed",
  "gbp_id": "YOUR_GBP_ID",
  "profile_id": 123,
  "old_value": "Mon-Fri 9am-6pm",
  "new_value": "Mon-Fri 9am-8pm",
  "detected_at": "2026-10-01T10:00:00"
}

Headers received

X-LocalEdge-Signature: <hmac-sha256>
X-LocalEdge-Event: hours_changed

Email digest (optional)

Pass notify_email on subscribe to also receive HTML alert emails via LocalEdge.

{
  "gbp_id": "YOUR_GBP_ID",
  "profile_id": 123,
  "webhook_url": "https://yourapp.com/webhook",
  "events": ["hours_changed","status_suspended"],
  "notify_email": "you@yourcompany.com"
}

Request API access

Thanks! We will contact you shortly.

Coming soon

More LocalEdge APIs are on the roadmap.

Heatmap API Coming Soon

GBP Score API Coming Soon

AVI Content API Coming Soon