Reference
API documentation
Every endpoint is served from /api/public/v1 and requires an approved API key. Create one from the dashboard.
Authentication
Send your key as a bearer token. x-api-key and ?key= are also accepted.
curl https://your-domain/api/public/v1/filters \ -H "Authorization: Bearer lll_your_key_here"
Limits
- 60 requests per minute per key.
- Up to 5 active keys per account.
- Free web checker: 20 links per run, 200 links per hour per IP.
Endpoints
/api/public/v1/filtersReturns every filter id available for checks, plus its display name and category.
{
"filters": [
{ "id": "cleanbrowsing", "name": "CleanBrowsing", "kind": "dns" }
]
}/api/public/v1/live/:siteLightSpeed Live Intelligence. Returns a single verdict per site: DETECTED or Not Detected.
curl "https://your-domain/api/public/v1/live/example.com" \
-H "Authorization: Bearer lll_your_key_here"
{
"site": "example.com",
"verdict": "Not Detected",
"ms": 74
}/api/public/v1/liveBatch LightSpeed Live Intelligence: up to 50 sites per request, one verdict each.
curl -X POST "https://your-domain/api/public/v1/live" \
-H "Authorization: Bearer lll_your_key_here" \
-H "Content-Type: application/json" \
-d '{"sites":["example.com","another-site.org"]}'
{
"results": [
{ "site": "example.com", "verdict": "Not Detected", "ms": 74 },
{ "site": "another-site.org", "verdict": "DETECTED", "ms": 91 }
],
"rejected": []
}/api/public/v1/check/:filter/:siteChecks one site against one filter.
{
"site": "example.com",
"filter": "cleanbrowsing",
"status": "unblocked",
"category": null,
"ms": 82
}/api/public/v1/bulkChecks many sites against many filters in one call (max 50 sites × 10 filters).
curl -X POST https://your-domain/api/public/v1/bulk \
-H "Authorization: Bearer lll_your_key_here" \
-H "Content-Type: application/json" \
-d '{"links":["example.com"],"filters":["cleanbrowsing","quad9"]}'/api/public/v1/check-all/:siteChecks a site against every filter. Streams server-sent events by default; append ?mode=static for a single JSON response.
curl -N "https://your-domain/api/public/v1/check-all/example.com?key=lll_your_key_here" curl "https://your-domain/api/public/v1/check-all/example.com?mode=static" \ -H "Authorization: Bearer lll_your_key_here"
/api/public/v1/gen-api-keyOwner keys only. Mints a new API key and attaches the requester's details, so a third-party bot can hand out keys. Every mint is logged.
curl -X POST https://your-domain/api/public/v1/gen-api-key \
-H "Authorization: Bearer lll_owner_key" \
-H "Content-Type: application/json" \
-d '{"discord_id":"1234567890","username":"someone","email":"someone@example.com"}'/api/public/v1/meReturns the account behind a key: weekly quota, key tier, and the linked Discord account (ID, username, email and every server the user is in). When no Discord account is connected the response includes a connect_url to start linking.
curl https://your-domain/api/public/v1/me \ -H "Authorization: Bearer lll_your_key_here"
/api/public/v1/discord/:idOwner keys only. Looks up a linked Discord account by Discord ID, username or account email — useful for bots that need to resolve who a key belongs to.
curl https://your-domain/api/public/v1/discord/1234567890 \ -H "Authorization: Bearer lll_owner_key"
Connect Discord
- 1. Sign in and open your dashboard.
- 2. Press “Link your Discord” and approve the Discord consent screen.
- 3. We store your Discord ID, username, email and server list — readable through
/api/public/v1/me.
API calls are mirrored to the owner’s Discord log channel; owner-tier accounts are never logged.
/logoThe LLLogan mark as a raw PNG — safe to hotlink in embeds and bots.
https://your-domain/logo
Errors
401— missing, invalid or revoked key.403— account not approved yet.429— rate limit exceeded.
Filter catalogue (201)
1hosts.liteabuse.ch.threatfoxadawayadguard.familyadguardalienvaultaristotlebarracudablocksi.aiblocksi.guardianblocksiblp.abuseblp.cryptoblp.drugsblp.fraudblp.gamblingblp.malwareblp.phishingblp.piracyblp.pornblp.ransomwareblp.redirectblp.scamblp.trackingciraciscocleanbrowsing.adultcleanbrowsing.familycleanbrowsingcleanbrowsing.securitycloudflarecontentkeepercontrold.familydan.pollockdeledaodisconnect.addisconnect.malvertisingdisconnect.trackingdnsfilterfadeMind.2o7netfadeMind.riskfadeMind.spamforcepointforcepointaifortiguardfortinetgagglegoguardian.aigoguardian.v1goguardian.v2goodbyeadsgoogleSafeBrowsinghagezi.lighthagezi.multihagezi.prohagezi.pro.plushagezi.tifhagezi.ultimatehaparaibosslanschool.airlanschoollightspeedlinewizeltslinkmitchellkrogza.pornmvpsnetsweepernextdnsnotrackingoisd.bigoisd.nsfwopendns.familyshieldopendnsopenphishpaloaltopgl.yoyophishingarmy.extendedphishingarmyphishtankpulsedivequad9questitoqustodiorouterruckussafednssafesurfer.dohsafesurfersecurlysensosmoothwallsophosspam404stevenblack.basestevenblack.fakenews-gamblingstevenblack.fakenewsstevenblack.gamblingstevenblack.pornstevenblack.socialsucuritrellixtrendmicrotrustedsource.epwctrustedsourcetrustedsource.sm42trustedsource.smxltrustedsource.swgcloudtrustedsource.swggtitrustedsource.swgonpremumbrellaunifiurlhaus.domainsurlhaus.hostsurlhausurlscanvt.0xsi_f33dvt.abusixvt.acronisvt.adminuslabsvt.ailabs_monitorappvt.alphamountain_aivt.alphasocvt.antiy_avlvt.arcsight_threat_intelligencevt.autoshunvt.aviravt.benkow_ccvt.bfore_ai_precrimevt.bitdefendervt.bkavvt.bluelivvt.certegovt.chong_lua_daovt.cins_armyvt.cluster25vt.cmc_threat_intelligencevt.crdfvt.criminal_ipvt.crowdsecvt.cyanvt.cyblevt.cyradarvt.desenmascara_mevt.dns8vt.dr_webvt.emergingthreatsvt.emsisoftvt.ermesvt.esetvt.estsecurityvt.forcepoint_threatseekervt.fortinetvt.g_datavt.greensnowvt.gridinsoftvt.heimdal_securityvt.ipsumvt.juniper_networksvt.k7antivirusvt.kasperskyvt.levelbluevt.lionicvt.lumuvt.malwaredvt.malwarepatrolvt.malwares_com_url_checkervt.netcraftvt.openphishvt.phishfortvt.phishing_databasevt.phishlabsvt.prebytesvt.precisionsecvt.quick_healvt.qutteravt.safetoopenvt.scantitanvt.scumware_orgvt.seclookupvt.securebrainvt.securolyticsvt.segasecvt.snort_ip_sample_listvt.socradarvt.spam404vt.stopforumspamvt.threathivevt.urlqueryvt.viettel_threat_intelligencevt.viprevt.viribackvt.vx_vaultvt.xcitium_verdict_cloudvt.yandex_safebrowsingvt.zerocertwatchguardwebrootwindowsspyblocker.extrawindowsspyblocker.spyzscaler