Skip to main content
Webhooks are coming soon! This feature will be available alongside our API launch.

​
What Are Webhooks?

Webhooks allow you to receive real-time HTTP notifications when events occur in SEO Crawler. Instead of polling for updates, webhooks push data to your server immediately when something happens.

​
Planned Events

EventDescription
crawl.startedA crawl has begun
crawl.completedA crawl finished successfully
crawl.failedA crawl encountered an error
domain.verifiedDomain verification succeeded
ssl.expiringSSL certificate expiring soon
ssl.expiredSSL certificate has expired
issues.newNew issues discovered
issues.resolvedPreviously detected issues fixed

​
Example Payload

Here’s what a webhook payload will look like: 
{
  "id": "evt_123abc",
  "event": "crawl.completed",
  "created_at": "2024-12-02T15:04:23Z",
  "data": {
    "crawlId": "456e4567-e89b-12d3-a456-426614174100",
    "domain": "example.com",
    "health_score": 78,
    "summary": {
      "total_urls": 847,
      "broken_links": 12,
      "redirects": 45,
      "seo_issues": 34
    }
  }
}

​
Security

All webhook requests will include a signature header for verification: 
X-SEO-Signature: sha256=abc123...

​
Availability

Webhooks will be available on Pro and Agency plans.

Join API Waitlist

Get notified when webhooks are available.

Email Notifications

Use email notifications in the meantime.