Data Freshness Check

Check whether a URL is reachable, how recently its domain was updated, and whether its TLS certificate is about to expire.

⚡ 5 credits per call

Uses these tools

Why use this

Agents frequently operate on stale data. This circuit checks recency signals without requiring the agent to make multiple calls or parse raw WHOIS data. Four signals in one round trip: URL reachability, domain update date, TLS certificate expiry, and content word count.

Flags

Flag	Meaning
`url_unreachable`	HTTP probe returned an error or status ≥ 400
`ssl_expiring_soon`	TLS certificate expires within 30 days

A partial: true field is added if one or more signals failed. signals_checked tells you how many actually ran.

API Reference

Endpoint

POST https://api.lightningapi.tools/circuits/data-freshness-check

Required headers

Authorization: Bearer <apiKey>
Content-Type: application/json

Example request

{
  "url": "https://example.com"
}

Example response

{
  "signals": {
    "url_reachable": true,
    "domain_updated": "2025-06-01T00:00:00Z",
    "ssl_days_remaining": 180,
    "ssl_valid_to": "2026-12-31T00:00:00Z",
    "word_count": 1842
  },
  "flags": [],
  "anomaly_count": 0,
  "signals_checked": 4
}