Blacklist Checker — API REST

Présentation

L'API Blacklist Checker permet de vérifier si une adresse IP ou un domaine apparaît dans des listes noires DNS (DNSBL/RBL). Pour un domaine, l'API vérifie également les enregistrements MX et les IPs associées.

Endpoint

CORS activé — l'API est appelable depuis n'importe quel domaine.

Requête

En POST : Content-Type: application/json, paramètres dans le corps JSON.
En GET : paramètres dans la query string (ex. ?target=8.8.8.8&show_urls=true).

Exemples de requête

• cURL
• Python
• JavaScript
• PHP

# GET — Vérifier une IP (query string)
curl "https://www.blackcheck.eu/api/check-dnsbl?target=203.0.113.42"

# GET — Vérifier un domaine avec liens de délistage
curl "https://www.blackcheck.eu/api/check-dnsbl?target=example.com&show_urls=true"

# POST — Vérifier une IP
curl -X POST https://www.blackcheck.eu/api/check-dnsbl \
  -H "Content-Type: application/json" \
  -d '{"target": "203.0.113.42"}'

# POST — Vérifier un domaine avec liens de délistage
curl -X POST https://www.blackcheck.eu/api/check-dnsbl \
  -H "Content-Type: application/json" \
  -d '{"target": "example.com", "show_urls": true}'

import requests

response = requests.post(
    "https://www.blackcheck.eu/api/check-dnsbl",
    json={"target": "203.0.113.42", "show_urls": True}
)
data = response.json()

print(f"Listé dans {data['sections'][0]['data']['listed_count']} blacklists")

const response = await fetch("https://www.blackcheck.eu/api/check-dnsbl", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ target: "203.0.113.42", show_urls: true })
});

const data = await response.json();
console.log(data);

$response = file_get_contents("https://www.blackcheck.eu/api/check-dnsbl", false,
    stream_context_create([
        "http" => [
            "method"  => "POST",
            "header"  => "Content-Type: application/json",
            "content" => json_encode(["target" => "203.0.113.42"])
        ]
    ])
);

$data = json_decode($response, true);

Structure de la réponse

Champs d'un élément results[]

Exemple de réponse

{
  "target": "203.0.113.42",
  "is_ip": true,
  "sections": [
    {
      "title": "IP 203.0.113.42",
      "type": "ip",
      "data": {
        "ip": "203.0.113.42",
        "ip_version": "ipv4",
        "total_checked": 52,
        "listed_count": 1,
        "timeout_count": 2,
        "results": [
          {
            "name": "Spamhaus ZEN",
            "listed": true,
            "reason": "203.0.113.42 was listed (response: 127.0.0.2)",
            "severity": 5,
            "type": "composite",
            "response_time": 18,
            "error": "",
            "url": "https://www.spamhaus.org/zen/",
            "lookup_url": "https://check.spamhaus.org/"
          }
        ]
      }
    }
  ],
  "elapsed_ms": 4210,
  "cached": false,
  "cached_at": 1708254000,
  "cache_ttl": 3600
}

Codes de retour