Free checks (no API key)

Check one link, or every link in a message, for known abuse

Keyless and free. Returns the three signals that are immediate and carry no vendor cost: RelayShield's criminal IOC corpus, Google Safe Browsing, and domain registration age. Send url for one link, or urls for up to 25 at once -- the batch form deduplicates by domain and resolves the whole set in a single Safe Browsing request, so screening a mailbox costs one call rather than one per link.

It never answers safe. The best available verdict is unknown, meaning nothing is known against the domain, because an absence of evidence is not evidence of absence. Unauthenticated callers share a per-IP daily allowance and a batch counts once per URL; send an API key to lift it.

Billing. Free. This endpoint is not metered.

Note. No API key required. A key is still accepted and removes the per-IP daily allowance, which is what an integration serving many users should send.

post/v1/link-check

Request

  • Base URL: https://api.relayshield.net
  • URL: https://api.relayshield.net/v1/link-check
  • Auth: none required

Request body

urlstring

A single link. Must start with http:// or https://. Omit when sending urls.

urlsstring[]

Up to 25 links to check in one call. Omit when sending url. Results come back in the order submitted, including duplicates.

sourcestring

Optional integration identifier, recorded so a channel can be measured.

Example request

{
  "url": "https://example-shop.co/checkout",
  "source": "muse"
}

Response

Success. ok is true and data holds the result.

oktrue required

Changes

No recorded changes to this operation across all 1 revision of this API.