Deepline Native: Domain Health Check

Checking whether a company domain resolves, follows redirects to a canonical domain, returns 404/410, or is merely blocked by Cloudflare/Akamai before running.

Tool ID: domain_health_check

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'domain_health_check',
  {
    "domain": "example.com"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute domain_health_check --input '{
  "domain": "example.com"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "input_domain": "example.com",
  "input_url": "https://example.com",
  "status": "live",
  "http_status": 1,
  "final_url": "https://example.com",
  "final_domain": "example.com",
  "redirected": true,
  "canonical_url": "https://example.com",
  "page_title": "example",
  "response_server": "example",
  "protection_detected": true,
  "attempts": [
    {
      "method": "HEAD",
      "url": "https://example.com",
      "status": 1,
      "location": "example",
      "error": "example"
    }
  ]
}

Use deepline describe domain_health_check --json for the latest machine-readable contract.

Input reference

Check whether a domain resolves to a live website, follows redirects to a canonical domain, or returns a not-found/unreachable status. Use before company contact search to catch stale domains such as old .io domains that moved to .com.

Name	Type	Required	Default	Details
`payload.domain`	`string`	Yes	—	Domain or URL to probe. The action normalizes to a root hostname, tries HTTPS then HTTP, follows redirects, and refuses localhost/private IP targets. Minimum length: 1.
`payload.timeout_ms`	`integer`	No	`5000`	Per-request timeout in milliseconds. Minimum: 1000. Maximum: 10000.
`payload.fallback_get`	`boolean`	No	`false`	When true, retry with GET only when HEAD is explicitly unsupported (405/501). The probe never retries GET after Cloudflare/protection blocks.

Output reference

Domain health and redirect resolution result. final_domain is the value to prefer as canonical_domain when status is live or redirected.

Name	Type	Required	Default	Details
`result.input_domain`	`string`	Yes	—	—
`result.input_url`	`string`	Yes	—	—
`result.status`	`"live" \| "redirected" \| "not_found" \| "blocked" \| "server_error" \| "unreachable" \| "invalid"`	Yes	—	Allowed: `live`, `redirected`, `not_found`, `blocked`, `server_error`, `unreachable`, `invalid`.
`result.http_status`	`integer`	Yes	—	—
`result.final_url`	`string`	Yes	—	—
`result.final_domain`	`string`	Yes	—	—
`result.redirected`	`boolean`	Yes	—	—
`result.canonical_url`	`string`	Yes	—	—
`result.page_title`	`string`	Yes	—	—
`result.response_server`	`string`	Yes	—	—
`result.protection_detected`	`boolean`	Yes	—	True when response headers indicate Cloudflare, Akamai, or similar edge protection. Treat blocked protected domains as reachable, not as not-found.
`result.attempts`	`array`	Yes	—	—
`result.attempts[].method`	`"HEAD" \| "GET"`	Yes	—	Allowed: `HEAD`, `GET`.
`result.attempts[].url`	`string`	Yes	—	—
`result.attempts[].status`	`integer \| null`	Yes	—	—
`result.attempts[].location`	`string \| null`	Yes	—	—
`result.attempts[].error`	`string \| null`	Yes	—	—

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation