With this API you can integrate your system with FoolDNS.

It expose a REST interface that you can query via HTTP calls. Down here you can find the urls and small examples using cURL.

Enjoy! ;)

GET domains/blockeds

Retrieve the big list of all blocked domains.

curl -i http://api.fooldns.com/domains/blockeds | less

the response is a list of blocked domains separated by carriage returns (\n)

...
adservices.google.com
adservices.l.google.com
adserving.autotrader.com
adserving.eleven-agency.com
adserving03.epi.es
adservingcentral.com
...

GET domains/:domain/is_blocked

Search for one domain and get the status, see if it's blocked and why. Default format is JSON.

Example of a blocked domain:

curl -i http://api.fooldns.com/is_blocked/pagead.l.google.com | less

{"status":"blocked", "updated_at":"2009-07-06T19:25:23+02:00", "domain":"pagead.l.google.com", "list":"ADV_BigBrother", "user":null, "reason":null}

An unblocked (or non present) domain:

curl -i http://api.fooldns.com/domains/google.com/is_blocked | less

{"status":"unblocked","domain":"google.com"}

All available formats

HTML | JSON | Yaml | XML

GET domains/bl

Retrieve the big list of all blocked domains with associated list name (ready for dnsbl)

curl -i http://api.fooldns.com/domains/bl | less

note: the last part of the domain is the list name

...
a.tiscali.co.uk.ADV_mvpsADS
a.tomshardware.com.ADV_fooldns-base
a.total-media.net.ADV_mvpsADS
a.totalgambler.com.ADV_mvpsADS
a.ucoz.net.ADV_yoyoADS
a.ucoz.ru.ADV_yoyoADS
...

GET lists

Retrieve the names of all existing lists

curl -i http://api.fooldns.com/lists | less

adult
ADV_BigBrother
ADV_FlashCookies
ADV_fooldns-base
ADV_FoolDns20
ADV_mvpsADS
...