Live POST /v1/watch 1 credit per check

Set It Once.
Know the Moment Anything Changes.

Register any URL with a schedule. When the content changes — a price update, a new product, a policy revision — CrawlHQ fires your webhook instantly. Diff included.

terminal 
curl -X POST https://api.crawlhq.dev/v1/watch \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://competitor.com/pricing",
    "schedule": "0 9 * * *",
    "webhook": "https://yourapp.com/hooks/crawlhq",
    "watch_selector": ".pricing-table"
  }'
response 
{
  "event": "content_changed",
  "url": "https://competitor.com/pricing",
  "changed_at": "2026-03-28T09:02:11Z",
  "diff": "- $49/mo
+ $59/mo"
}
200 OK 1 credit per check

What makes it production-grade

Every module is built for pipelines that run without you watching.

⏰

Cron Scheduling

Set any cron schedule — hourly, daily, weekly, or every 5 minutes. CrawlHQ handles the infrastructure. You just get the webhook.

🎯

Selector-Level Watching

Watch a specific CSS selector, not the whole page. Ignore nav changes, footer updates, and cookie banners. Alert only on what matters.

📊

Structured Diffs

Change notifications include a structured diff — exactly what text was added, removed, or modified. Not just 'something changed'.

🔔

Webhook + Email

Deliver change alerts to any webhook endpoint, Slack channel, or email address. Multiple delivery targets per watch.

📈

Change History

Every version of a watched page is stored. Query the change history via API to see how content evolved over time.

🧩

Extract on Change

Combine with extract — when a watched page changes, automatically extract structured data from the new version and push to your database.

Use Cases

What teams build with watch

Competitor Pricing Alerts

Watch competitor pricing pages. The moment they update their plans, change a price, or add a new tier — you know before your sales team does.

Post-Nomination Candidate Monitoring

Watch a nominated candidate's news coverage daily. Track sentiment shifts, detect controversies before they go national.

Regulatory Change Tracking

Watch 40 government and regulatory pages. When policy changes, your compliance team gets an immediate alert with the exact diff.

Hiring Signal Detection

Watch target company career pages. When they post a 'Head of AI' role, your SDR pipeline fires automatically.

Product Launch Monitoring

Watch competitor product and changelog pages. Detect new features, deprecated tools, and pricing changes as they happen.

E-Commerce Price Changes

Watch competitor product pages at the SKU level. Auto-reprice when competitors move, before customers notice the gap.

Frequently asked questions

What's the minimum check interval?
Every 5 minutes on Growth plan and above. Daily on Free tier. Hourly on Starter. Every 5 minutes on Growth. Real-time (push-on-change) on Scale.
Am I charged if nothing changed?
Yes — 1 credit per check, regardless of whether content changed. This covers the cost of fetching and comparing the page. You're only paying ₹0.40 per check at standard credit rates.
What's included in the diff?
Text additions and removals (unified diff format), plus structured change summary: which sections changed, word count delta, and — when used with a schema — which specific fields changed and their old/new values.
Can I watch pages that require login?
Yes. Pass session cookies when registering the watch. CrawlHQ will include them on every check, allowing monitoring of authenticated pages, dashboards, and subscriber-only content.
How long is change history stored?
90 days on Free and Starter plans. 1 year on Growth. Unlimited on Scale. All historical snapshots are queryable via the API.
Can I trigger an extract when a change is detected?
Yes. Set extract_on_change: true with a schema in your watch registration. When the page changes, CrawlHQ automatically runs an extraction and includes the structured data in the webhook payload.

Start using watch in minutes

2,500 free credits. No credit card. One API key for all 9 modules.

Get API Key Free →