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/: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 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
...