v1 · https://blackeyes.info

Documentation

API BlackEyes.info

API officielle BlackEyes.info pour rechercher des fuites, services exposés, données Shodan, archives IntelX et sources OSINT. Toutes les routes sont versionnées sous /api/public/v1.

Base URL

https://blackeyes.info

Format clé

BLACKEYES-XXXX-XXXX-XXXX

Version

v1 · 2026

Authentification

Toutes les routes /api/public/v1/... requièrent une clé API au format Bearer. Vous pouvez aussi gérer vos clés sur votre page compte.

http

Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX
Content-Type: application/json
Accept: application/json

Codes de réponse

Code	Signification
200	Requête réussie
400	Paramètre invalide ou erreur de source externe
401	Clé API manquante ou invalide
403	Accès refusé ou protection Cloudflare
429	Trop de requêtes — réessayez plus tard
503	Source temporairement en maintenance

Filtres importants

Leak / Service

host:example.comRecherche par domaine ou hostname
ip:1.2.3.4Recherche par IPv4
port:443Filtre sur un port observé
protocol:httpsFiltre par protocole
vuln:CVE-2024-0001Recherche une CVE précise
+plugin:DotEnvConfigPluginFiltre un plugin Leak
country:FRFiltre par pays
asn:12345Filtre par ASN
has_vuln:trueServices avec vulnérabilité

Shodan

hostname:example.comRecherche par hostname
ip:"1.2.3.4"IP exacte
net:1.2.3.0/24Réseau CIDR
port:443Filtre par port
org:"Example Org"Filtre par organisation
country:FRFiltre par pays
vuln:CVE-2024-0001CVE
ssl:"Google"Certificats SSL

Cloud Logs

domainRecherche par domaine uniquement
machine_idRecherche par UUID machine uniquement

Buckets IntelX

Buckets supportés pour les téléchargements IntelX :

leaks.private.generalleaks.logswhoisdnsdarknet.tor

Fonctionnalités premium

• IntelX est réservé aux comptes premium.
• Newsletter et alertes (Telegram, forums, Twitter) via webhook Discord ou bot Telegram — premium uniquement, envoi manuel.
• Cloud Logs : champs sensibles masqués pour les non-premium, téléchargements premium uniquement.

Endpoints

POST/api/public/v1/search1 crédit

Recherche Leak / Service / Shodan

Endpoint principal pour rechercher des fuites, des services exposés ou des résultats Shodan selon le champ scope.

Exemple cURL

bash

curl -X POST 'https://blackeyes.info/api/public/v1/search' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "query": "host:example.com", "scope": "leak", "plugin": "DotEnvConfigPlugin", "severity": "all", "page": 0 }'

Réponse

json

{
  "results": [
    {
      "id": "example.com-443",
      "ip": "93.184.216.34",
      "host": "example.com",
      "port": 443,
      "protocol": "https",
      "plugin": "DotEnvConfigPlugin",
      "title": "HTTP title or service summary",
      "severity": "high",
      "country": "United States",
      "organization": "Example ASN",
      "summary": "Relevant extracted line",
      "retrievedAt": "2026-05-27T10:00:00.000Z",
      "raw": {}
    }
  ],
  "page": 0,
  "user": { "credits": 19 }
}

Corps JSON

json

{
  "query": "host:example.com",
  "scope": "leak",
  "plugin": "DotEnvConfigPlugin",
  "severity": "all",
  "page": 0
}

POST/api/public/v1/global-scan1 crédit

Global Scan

Analyse consolidée d'une IP ou d'un domaine via Leak, Service et Shodan. Retourne domaines liés, IP, ports, services, CVE, plugins et comptes trouvés.

Exemple cURL

bash

curl -X POST 'https://blackeyes.info/api/public/v1/global-scan' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "target": "example.com" }'

Réponse

json

{
  "scan": {
    "target": "example.com",
    "domains": ["example.com", "www.example.com"],
    "ips": ["93.184.216.34"],
    "ports": [80, 443],
    "services": ["http", "https"],
    "cves": ["CVE-2024-0001"],
    "leakPlugins": [
      {
        "plugin": "DotEnvConfigPlugin",
        "host": "example.com",
        "ip": "93.184.216.34",
        "port": 443,
        "severity": "high",
        "title": "Possible exposed environment configuration"
      }
    ],
    "accounts": [
      {
        "url": "https://example.com/login",
        "login": "user@example.com",
        "password": "redacted",
        "breachDate": "2025-01-01"
      }
    ],
    "counts": { "leak": 1, "service": 2, "shodan": 3 },
    "errors": {}
  },
  "user": { "credits": 18 }
}

Corps JSON

json

{ "target": "example.com" }

POST/api/public/v1/cloud-logsRecherche gratuite · téléchargement premium

Recherche Cloud Logs

L'API publique Cloud Logs accepte uniquement les recherches par domaine ou machine ID. Types acceptés: domain, machine_id.

Exemple cURL

bash

curl -X POST 'https://blackeyes.info/api/public/v1/cloud-logs' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "query": "example.com", "type": "domain", "limit": 20 }'

Réponse

json

{
  "results": [],
  "meta": { "rowsReturned": 0 }
}

Corps JSON

json

{
  "query": "example.com",
  "type": "domain",
  "limit": 20
}

GET/api/public/v1/shodan/custom-scans0 crédit

Liste des scans Shodan custom

Retourne les scans Shodan custom lancés par l'utilisateur API.

Exemple cURL

bash

curl -X GET 'https://blackeyes.info/api/public/v1/shodan/custom-scans' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json'

Réponse

json

{
  "scans": [
    { "id": 1, "target": "scanme.nmap.org", "ips": ["45.33.32.156"], "status": "created" }
  ]
}

POST/api/public/v1/shodan/custom-scan1 crédit

Créer un scan Shodan custom

Résout la cible en IP puis demande un scan Shodan.

Exemple cURL

bash

curl -X POST 'https://blackeyes.info/api/public/v1/shodan/custom-scan' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "target": "scanme.nmap.org" }'

Réponse

json

{
  "scan": {
    "target": "scanme.nmap.org",
    "ips": ["45.33.32.156"],
    "scan": { "id": "SCAN_ID" }
  }
}

Corps JSON

json

{ "target": "scanme.nmap.org" }

GET/api/public/v1/shodan/custom-scans/:id0 crédit

Détail d'un scan Shodan custom

Retourne le statut et les détails d'un scan custom.

Exemple cURL

bash

curl -X GET 'https://blackeyes.info/api/public/v1/shodan/custom-scans/:id' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json'

Réponse

json

{
  "scan": { "id": 1, "target": "scanme.nmap.org", "status": "done", "hostResults": [] }
}

DELETE/api/public/v1/shodan/custom-scans/:id0 crédit

Supprimer un scan Shodan custom

Supprime l'entrée du scan côté utilisateur.

Exemple cURL

bash

curl -X DELETE 'https://blackeyes.info/api/public/v1/shodan/custom-scans/:id' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json'

Réponse

json

{ "ok": true }

GET/api/public/v1/shodan/host/:ip0 crédit

Vue Shodan host

Retourne la vue détaillée Shodan pour une IPv4.

Exemple cURL

bash

curl -X GET 'https://blackeyes.info/api/public/v1/shodan/host/:ip' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json'

Réponse

json

{
  "host": { "ip_str": "1.1.1.1", "ports": [80, 443], "vulns": {}, "data": [] }
}

GET/api/public/v1/intelx/downloads0 crédit

Historique IntelX

Liste les téléchargements Intelligence X associés à l'utilisateur.

Exemple cURL

bash

curl -X GET 'https://blackeyes.info/api/public/v1/intelx/downloads' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json'

Réponse

json

{
  "downloads": [
    { "id": 1, "systemId": "uuid", "bucket": "leaks.private.general", "status": "done" }
  ]
}

POST/api/public/v1/intelx/download5 crédits

Téléchargement IntelX

Initie un téléchargement Intelligence X. Le bucket par défaut est leaks.private.general. Buckets disponibles: leaks.private.general, leaks.logs, whois, dns, darknet.tor. Accepte systemId/system_id ou storageId/storage_id.

Exemple cURL

bash

curl -X POST 'https://blackeyes.info/api/public/v1/intelx/download' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "systemId": "63ce5be9-cbb9-4281-a316-309cf662a0df", "bucket": "leaks.logs" }'

Réponse

json

{
  "download": { "id": 815, "systemId": "uuid", "status": "processing" },
  "cached": false
}

Corps JSON

json

{
  "systemId": "63ce5be9-cbb9-4281-a316-309cf662a0df",
  "bucket": "leaks.logs"
}

GET/api/public/v1/intelx/downloads/:id/file0 crédit

Fichier IntelX

Renvoie immédiatement le fichier binaire si le téléchargement est prêt. Si IntelX n'a pas encore exposé le fichier, l'API renvoie 202 FILE_NOT_READY avec Retry-After au lieu d'un 404 brut.

Exemple cURL

bash

curl -X GET 'https://blackeyes.info/api/public/v1/intelx/downloads/:id/file' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json'

Réponse

json

Binary file stream (200) — ou JSON 202 { "code": "FILE_NOT_READY", "status": "processing" | "queued" | "unknown" }

GET/api/public/v1/intelx/downloads/:id/status0 crédit

Statut fichier IntelX

Retourne le statut exact du téléchargement depuis l'historique IntelX: processing, cached ou failed.

Exemple cURL

bash

curl -X GET 'https://blackeyes.info/api/public/v1/intelx/downloads/:id/status' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json'

Réponse

json

{ "download": { "id": 815, "status": "failed", "errorMessage": "Le fichier IntelX n'est plus disponible" } }

DELETE/api/public/v1/intelx/downloads/:id0 crédit

Masquer un téléchargement IntelX

Masque une entrée dans l'historique IntelX.

Exemple cURL

bash

curl -X DELETE 'https://blackeyes.info/api/public/v1/intelx/downloads/:id' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json'

Réponse

json

{ "ok": true }

POST/api/public/v1/osint/search1 crédit

Recherche OSINT

Recherche multi-critères via les modules OSINT selon un type comme email, username, domain, ip, hash ou telegram.

Exemple cURL

bash

curl -X POST 'https://blackeyes.info/api/public/v1/osint/search' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{ "type": "domain", "query": "example.com" }'

Réponse

json

{
  "results": {
    "entries": [
      { "email": "user@example.com", "database_name": "Example breach" }
    ]
  },
  "downloadAvailable": false
}

Corps JSON

json

{ "type": "domain", "query": "example.com" }

GET/api/public/v1/osint/sources0 crédit

Sources OSINT supportées

Liste les catégories et modules OSINT supportés.

Exemple cURL

bash

curl -X GET 'https://blackeyes.info/api/public/v1/osint/sources' \
  -H 'Authorization: Bearer BLACKEYES-XXXX-XXXX-XXXX' \
  -H 'Accept: application/json'

Réponse

json

{
  "dataWells": [
    { "name": "Example breach", "entries": 1000000, "addedAt": "2026-01-01" }
  ]
}