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.
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.
| Field | Type | Required | Limits |
|---|---|---|---|
| url | string | Required | up 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.
| Field | Type |
|---|---|
| url | string |
| host | string |
| verdict | "listed" or "not_listed" |
| matches | list |
| feeds_checked | list |
| feeds_unavailable | list |
| disclaimer | string |
Response fields for Link Safety Check
What it costs
1 credit per URL checked (a check that cannot run is free).
| Case | Charge |
|---|---|
| Completed lookup, found or not | 1 credit |
| Repeat inside 1 day | 0 credits |
| Errors and invalid requests | 0 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.
Related
Still stuck? Write to hello@lookvalid.com.