API

Tutti gli strumenti in JSON, da integrare nei tuoi script.

API pubblica degli strumenti DNS

Tutti gli strumenti del sito sono disponibili come API REST: richieste GET, risposte JSON, CORS abilitato.

Base URL: https://www.3load.com/api/v1

Limite: 100 punti ogni 10 minuti per indirizzo IP e al massimo 30 richieste al minuto; superato il limite: HTTP 429 con Retry-After. Costo: dns 1, reverse 1, whois 2, dnsbl 3, ssl 3, mail 5, propagation 5, scout 10. Con una chiave (header X-API-Key) il limite non si applica: richiedila ai contatti.

Formato delle risposte

{ "ok": true, "tool": "reverse", "query": { "ip": "8.8.8.8" }, "data": { ... }, "took_ms": 223 } { "ok": false, "error": { "code": "rate_limited", "message": "...", "retry_after": 120 } }

Codici HTTP: 200 ok, 400 parametro non valido, 404 strumento o dominio non trovato, 429 limite superato (header Retry-After), 503 servizio non disponibile. Ogni risposta riporta gli header X-RateLimit-Limit e X-RateLimit-Remaining.

Strumenti

`GET /api/v1/dns`

Record DNS di un dominio. Senza "type" restituisce tutti i record principali letti dal name server autorevole; con "type" interroga il resolver.

Parametri: domain, type (A,AAAA,CNAME,MX,NS,SOA,TXT,CAA,SRV,PTR,DS,DNSKEY,NAPTR,TLSA) · Costo: 1

curl "https://www.3load.com/api/v1/dns?domain=3load.com&type=A,MX"

Prova nel browser →

`GET /api/v1/reverse`

Reverse lookup di un IPv4/IPv6: PTR, verifica FCrDNS, AS, rete e paese.

Parametri: ip · Costo: 1

curl "https://www.3load.com/api/v1/reverse?ip=8.8.8.8"

Prova nel browser →

`GET /api/v1/whois`

Whois di un dominio di qualsiasi estensione (whois o RDAP, con il registrar) o di un IPv4. Per i domini indica anche availability: available, registered, reserved o unknown.

Parametri: domain | ip · Costo: 2

curl "https://www.3load.com/api/v1/whois?domain=alice.pizza"

Prova nel browser →

`GET /api/v1/dnsbl`

Controllo su 79 blacklist DNS. Con "domain" controlla anche l'IP del primo server MX.

Parametri: ip | domain · Costo: 3

curl "https://www.3load.com/api/v1/dnsbl?ip=127.0.0.2"

Prova nel browser →

`GET /api/v1/ssl`

Certificato e catena TLS/SSL per il web (HTTPS) o la posta. Per i servizi di posta su un dominio individua automaticamente i server via MX (SMTP in ingresso) o record SRV (IMAP/POP/submission). Restituisce validità, scadenza, corrispondenza host, attendibilità, catena, chiave e firma.

Parametri: host | domain, service (https, smtp, smtp25, smtps, imap, imaps, pop3, pop3s) · Costo: 3

curl "https://www.3load.com/api/v1/ssl?host=3load.com&service=https"

Prova nel browser →

`GET /api/v1/mail`

Diagnostica posta: SPF, DKIM (selettori comuni + quello indicato), DMARC, MX, policy di trasporto (MTA-STS, TLS-RPT, BIMI) e reputazione in uscita (DNSBL) degli IP degli MX e del dominio. I test SMTP attivi (open relay, verifica casella) non sono esposti via API.

Parametri: domain, selector (selettore DKIM opzionale) · Costo: 5

curl "https://www.3load.com/api/v1/mail?domain=3load.com"

Prova nel browser →

`GET /api/v1/propagation`

Propagazione DNS: interroga i DNS pubblici della nazione e confronta A, MX e TXT con i record autorevoli.

Parametri: domain, country (it, us, de, ...), limit (1-50) · Costo: 5

curl "https://www.3load.com/api/v1/propagation?domain=3load.com&country=it&limit=10"

Prova nel browser →

`GET /api/v1/scout`

Analisi DNS completa: record, posta (SPF/DMARC/DKIM), SRV, sottodomini comuni, AXFR, reverse lookup.

Parametri: domain, sections (records,email,srv,subdomains,axfr,ptr) · Costo: 10

curl "https://www.3load.com/api/v1/scout?domain=3load.com&sections=records,email"

Prova nel browser →

Esempio con chiave API

curl -H "X-API-Key: LA_TUA_CHIAVE" "https://www.3load.com/api/v1/propagation?domain=example.com&country=de"