URL Safety Checker API
Category: security
Check if a URL is safe by analyzing HTTPS, TLD reputation, IP usage, and querying the URLhaus malware database.
Endpoint
POST
https://anythingtext.com/api/tools/urlcheck
Authentication Required
Content-Type: application/json
Authentication
This API requires an API key. Generate one from the API Keys section in your dashboard settings.
Include the X-API-Key header in all API requests:
X-API-Key: atk_your_api_key_here
Rate Limiting
API requests are limited to 60 requests per minute per user. If you exceed this limit, the API returns a 429 Too Many Requests response.
Every response includes rate limit headers:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 42
When rate limited, the response body contains:
{ "error": "Rate limit exceeded. Maximum 60 requests per minute.", "retryAfter": 42, "limit": 60 }
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
url
|
String | Required |
The URL to check for safety
Example: https://example.com
|
Response
Content-Type: application/json
Safety assessment with warnings
{
"safety": "safe",
"https": true,
"urlhaus": "no_results",
"warnings": []
}
Error Responses
| Status | Description | Body |
|---|---|---|
401 |
Not authenticated | {"error": "Please log in..."} |
400 |
Bad request / Missing required params | {"error": "... is required"} |
500 |
Internal server error | {"error": "Failed to ..."} |
cURL Example
curl -X POST https://anythingtext.com/api/tools/urlcheck \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{"url": "https://example.com"}'
Code Samples
const response = await fetch('https://anythingtext.com/api/tools/urlcheck', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'your_api_key_here'
},
body: JSON.stringify({"url": "https://example.com"})
});
const data = await response.json();
console.log('Result:', data);
import requests
import json
response = requests.post(
'https://anythingtext.com/api/tools/urlcheck',
json={'url': 'https://example.com'},
headers={'X-API-Key': 'your_api_key_here'}
)
data = response.json()
print('Result:', data)
import java.net.URI;
import java.net.http.*;
HttpClient client = HttpClient.newHttpClient();
String json = "{\"url\": \"https://example.com\"}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://anythingtext.com/api/tools/urlcheck"))
.header("Content-Type", "application/json")
.header("X-API-Key", "your_api_key_here")
.POST(HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request,
HttpResponse.BodyHandlers.ofString());
System.out.println("Response: " + response.body());