Production-ready selector healing

Stop broken selectors
from killing your automations

Websites change their markup constantly. When a CSS selector breaks, your entire scraping pipeline or automation stops working. Heal detects the break and finds the new selector automatically — in milliseconds.

Free plan includes 50 elements and 100 heals/month

The problem

Every automation that touches a website depends on CSS selectors.

73%

of web scrapers break within 30 days

4h+

average time to debug a broken selector

$0

revenue while your automation is down

How Heal works

Three steps. One API call. Zero downtime.

1

Tag your elements

Use our Chrome extension or API to register elements. We store 7 fallback selectors per element automatically — ID, test-id, ARIA, href, class, nth-child, and text.

2

Detect the break

Call /api/v1/heal/check with the current HTML. Nodium tells you instantly if the selector still matches — and can auto-heal if it doesn't.

3

Heal automatically

Our 3-tier healing engine tries cascade fallback, then weighted heuristic matching, then AI vision — returning the best new selector with a confidence score.

3-tier healing engine

Speed first, accuracy always. Each tier is more powerful but slower.

Tier 0

Cascade fallback

< 5ms

Tests 7 stored selector strategies in priority order. If the ID selector breaks, we try data-testid, then ARIA label, then unique class, and so on. Most heals resolve here.

Confidence: 92–97%

Tier 1

Heuristic matching

< 50ms

Scores every element in the DOM against 8 weighted factors: stable attributes, text content, CSS classes, parent chain, tag name, and href. Finds elements even after major redesigns.

Confidence: 65–90%

Tier 2

AI Vision

< 3s

Sends a screenshot of the original element and the current HTML to GPT-4V. The AI visually identifies the matching element and returns a new selector with reasoning.

Confidence: 70–95%

Built for automation tools

Drop Heal into any workflow that makes HTTP requests.

n8n

Add an HTTP Request node pointing to /api/v1/heal with your API key. Chain it after your scraping node and before your data processing — if the selector broke, Heal returns the fixed one.

Make (Integromat)

Use the HTTP module to call the check endpoint with autoHeal: true. One request validates and fixes your selector. Route the response to continue your scenario.

Typical workflow

Fetch page HTMLPOST /api/v1/heal/checkUse healed selectorExtract data

Everything you need to keep selectors alive

7-strategy cascade

Every element is stored with 7 different selector strategies. If one breaks, the cascade tries the next.

Batch healing

Heal up to 50 selectors in a single API call. Perfect for large scraping jobs with dozens of tracked elements.

Webhooks

Get notified instantly when a selector breaks or gets healed. Supports heal.success and heal.failed events with HMAC signing.

Confidence scores

Every heal result includes a confidence score (0–1). Set your own threshold to auto-accept or flag for review.

PII anonymization

Configure regex rules to redact sensitive data from element names and text before storage. GDPR-friendly by default.

Full audit trail

Every heal attempt is logged — old selector, new selector, method used, confidence, latency, and AI reasoning when applicable.

Dead-simple API

One endpoint. One header. JSON in, JSON out.

POST /api/v1/heal
curl -X POST https://app.nodium.io/api/v1/heal \
  -H "X-API-Key: ndm_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "elementId": "uuid-of-tracked-element",
    "currentHtml": "<div>...current page HTML...</div>"
  }'
Response
{
  "success": true,
  "newSelector": "#checkout-btn",
  "confidence": 0.97,
  "method": "cascade",
  "latencyMs": 3
}

Who uses Heal

Web scraping teams

Stop wasting hours debugging broken selectors. Register your target elements once, and Heal keeps them working even when the site redesigns.

No-code automation builders

n8n, Make, Zapier users who scrape data from websites. Heal fits as an HTTP step in your workflow — no code changes needed.

QA & testing teams

E2E tests break when selectors change. Use Heal to auto-update test selectors and reduce flaky test maintenance.

Monitoring & alerting

Track price changes, stock availability, or content updates on third-party sites. Heal keeps your monitors running.

Start healing broken selectors today

Free plan. No credit card. Set up in 2 minutes.