How each product works

How to use Link Safety Check

What Link Safety Check takes in, which fields it returns and how credits are charged for each lookup.

Last updated 2026-10-22

What it does

Checks the domain of a URL against the CERT Polska Warning List of malicious domains, whose licence allows commercial use, and reports whether the domain or a parent domain is listed and the date of the list. A URL on no list is not proof it is safe: the list only holds domains that have already been reported, and it checks the domain, not the page.

What you send

Send these fields in the JSON body of the request.

Request fields for Link Safety Check
FieldTypeRequiredLimits
urlstringRequiredup to 2,048 characters

Request fields for Link Safety Check

What you get back

The data object of a successful response carries these fields. Every response also lists its sources, the credits_charged and whether it was a cache_hit.

Each field is described in the API reference.

Response fields for Link Safety Check
FieldType
urlstring
hoststring
verdict"listed" or "not_listed"
matcheslist
feeds_checkedlist
feeds_unavailablelist
disclaimerstring

Response fields for Link Safety Check

What it costs

1 credit per URL checked (a check that cannot run is free).

What each outcome costs
CaseCharge
Completed lookup, found or not1 credit
Repeat inside 1 day0 credits
Errors and invalid requests0 credits

What each outcome costs

Run it

You can try it without an account in the free tool. The free tools share a limit per visitor.

From code, send a POST request to https://YOUR_API_HOST/v1/link-safety with your API key.

curl -X POST https://YOUR_API_HOST/v1/link-safety \
  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

A request to Link Safety Check

Full parameters and response fields are in the API reference. To run a list of values, use a bulk CSV job.

Good to know

  • A repeat of the same lookup within 1 day is served from your cache and costs 0 credits.
  • Every completed lookup is charged, whether or not it finds something.
  • Invalid input and errors are never charged.
  • The API allows 200 requests per 10 seconds per key.

Still stuck? Write to hello@lookvalid.com.