API reference

Classify one URL. Returns the verdict plus the full evidence trace.

curl -X POST https://api.linkintel.dev/v1/check \
  -H 'authorization: Bearer li_live_xxx' \
  -H 'content-type: application/json' \
  -d '{
    "url": "https://shop.com/old-product",
    "includeRaw": false      // attach the full raw fetch payload (large)
  }'

{
  "url": "https://shop.com/old-product",
  "finalUrl": "https://shop.com/old-product",
  "status": "dead",              // alive | moved | parked | out_of_stock | dead
  "confidence": 0.99,
  "method": "heuristic",         // or "llm_tiebreak"
  "reachable": true,             // false = we couldn't fetch it (≠ dead)
  "signals": { "http": 404, "heuristic": { … } },
  "evidence": {
    "engineVersion": "0.1.0",
    "fetch": { "finalUrl": …, "httpStatus": 404, "durationMs": 512 },
    "page": { "title": "Page Not Found", "canonical": null, "contentHash": "…", "bodyExcerpt": "…" },
    "signals": { … },
    "decision": { "method": "heuristic", "confidence": 0.99, "reachable": true }
    // "raw": { … }  ← only when includeRaw=true
  }
}

Classify, and if broken, find the best live replacement within allowedDomains. Fail-open cascade: confident replacement → your fallbackUrl → the original.

curl -X POST https://api.linkintel.dev/v1/heal \
  -H 'authorization: Bearer li_live_xxx' \
  -H 'content-type: application/json' \
  -d '{
    "url": "https://shop.com/old-shoe",
    "allowedDomains": ["shop.com"],
    "context": "old running shoe",
    "fallbackUrl": "https://shop.com/shoes"
  }'

{
  "status": "dead", "healed": true,
  "href": "https://shop.com/products/old-shoe-v2",
  "hrefSource": "replacement",   // replacement | fallback | original
  "resolveConfidence": 0.93,
  "coverage": { "shop.com": "sitemap" },
  "evidence": { … }
}

Check up to 50 URLs in one call. Each item carries its own verdict + evidence; one bad URL never fails the batch.

curl -X POST https://api.linkintel.dev/v1/batch \
  -H 'authorization: Bearer li_live_xxx' \
  -H 'content-type: application/json' \
  -d '{ "urls": ["https://a.com/1", "https://a.com/2"] }'
# → { "count": 2, "results": [ { "url": …, "ok": true, "result": { … } }, … ] }

What this deployment supports — features and classifications. Introspect instead of guessing.

{
  "version": "v1", "engineVersion": "0.1.0",
  "features": { "check": true, "heal": true, "batch": true,
                "includeRaw": true, "jsRendering": true },
  "classifications": ["alive", "moved", "parked", "out_of_stock", "dead"]
}