Integrate our comprehensive security threat detection system into your applications
GET https://remindsecure.com/api/v1/security/blocklist
The RemindSecure Security Blocklist API provides real-time access to our database of malicious domains and security threats. This API is RESTful and returns data in JSON format.
No API key is required for public endpoints. Rate limiting applies to prevent abuse.
Basic access to the API is available without authentication, subject to rate limiting.
You can start using the API immediately for basic queries without any authentication.
For higher rate limits and advanced features, use API key authentication:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://remindsecure.com/api/v1/security/blocklistconst response = await fetch(url, {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});headers = {
'Authorization': 'Bearer YOUR_API_KEY'
}
response = requests.get(url, headers=headers)GET https://remindsecure.com/api/v1/security/blocklist
Returns a paginated list of all blocked domains.
{
"success": true,
"metadata": {
"lastUpdated": "2024-02-01T00:00:00Z",
"version": "1.0.0"
},
"pagination": {
"total": 1234,
"page": 1,
"pages": 13,
"limit": 100
},
"data": [
{
"domain": "malicious-example.com",
"category": "phishing",
"dateAdded": "2024-01-15T00:00:00Z",
"risk": "high"
}
]
}GET https://remindsecure.com/api/v1/security/blocklist/search/{query}
Search for specific domains in the blocklist.
{
"success": true,
"count": 1,
"data": [
{
"domain": "malicious-example.com",
"category": "phishing",
"dateAdded": "2024-01-15T00:00:00Z",
"risk": "high"
}
]
}GET https://remindsecure.com/api/v1/security/blocklist/check/{domain}
Check if a specific domain is in the blocklist.
{
"success": true,
"domain": "example.com",
"isBlocked": true,
"details": {
"category": "phishing",
"dateAdded": "2024-01-15T00:00:00Z",
"risk": "high"
}
}// Check if a domain is blocked
async function checkDomain(domain) {
try {
const response = await fetch(
`https://remindsecure.com/api/v1/security/blocklist/check/${domain}`
);
const data = await response.json();
if (data.success && data.isBlocked) {
console.log(`Warning: ${domain} is a known threat!`);
return true;
}
return false;
} catch (error) {
console.error('Error checking domain:', error);
return false;
}
}import requests
def check_domain(domain):
try:
response = requests.get(
f'https://remindsecure.com/api/v1/security/blocklist/check/{domain}'
)
data = response.json()
if data['success'] and data['isBlocked']:
print(f"Warning: {domain} is a known threat!")
return True
return False
except Exception as e:
print(f"Error checking domain: {e}")
return Falsefunction checkDomain($domain) {
try {
$response = file_get_contents(
"https://remindsecure.com/api/v1/security/blocklist/check/" . urlencode($domain)
);
$data = json_decode($response, true);
if ($data['success'] && $data['isBlocked']) {
echo "Warning: {$domain} is a known threat!";
return true;
}
return false;
} catch (Exception $e) {
error_log("Error checking domain: " . $e->getMessage());
return false;
}
}To ensure fair usage, the API implements the following rate limits:
Exceeding these limits will result in a 429 Too Many Requests response.
Request completed successfully
{
"success": true,
"data": {
"domain": "example.com",
"isBlocked": false
}
}Invalid request parameters
{
"success": false,
"error": {
"code": "INVALID_DOMAIN",
"message": "Invalid domain format"
}
}Rate limit exceeded
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded",
"retryAfter": 300
}
}Our API uses URL versioning to ensure compatibility as we add new features and improvements.
https://remindsecure.com/api/v1/...
Always specify the API version in your requests to ensure stability.
https://test-api.remindsecure.com/v1/security/blocklist
Use our test environment for development and integration testing. The test environment has higher rate limits but may include synthetic data.
test-malicious.remindsecure.com
test-safe.remindsecure.com
Test credentials and additional test domains are available upon request.
Our API supports Cross-Origin Resource Sharing (CORS) for secure client-side requests from browsers.
{
"allowed_origins": ["*"],
"allowed_methods": ["GET", "POST", "OPTIONS"],
"allowed_headers": ["Content-Type", "Authorization"],
"max_age": 86400
}Receive real-time notifications about new threats and updates to the blocklist through webhooks.
{
"webhook_url": "https://your-domain.com/webhook",
"events": ["new_threat", "threat_update", "threat_removed"],
"secret": "your_webhook_secret"
}{
"event": "new_threat",
"timestamp": "2024-02-02T12:00:00Z",
"data": {
"domain": "malicious-example.com",
"threat_type": "phishing",
"severity": "high",
"detection_method": "ai_analysis"
}
}Always verify webhook signatures to ensure the authenticity of received payloads.