socialsfyi / Website Check API

Website Check API

De Website Check gebruiken in je eigen script of dashboard? Hieronder vind je het endpoint, voorbeelden en de spelregels.

Endpoint

Het endpoint

https://socials.fyi/sitecheck?api=analyze

De API retourneert JSON en analyseert een opgegeven website op onder meer SSL, DNS, redirects, security headers, SEO-basics en lichte performance-signalen.

Rate limits

Gebruik met mate

Website interface
1 check per 30 seconden per IP.
API gebruik
Advies: 5 requests per 5 minuten per IP, plus burst-beperking.
Geen bulk scraping
Deze API is bedoeld voor normaal gebruik, testen en integraties op kleine schaal.

Request

Hoe gebruik je de API?

POST request
curl -X POST "https://socials.fyi/sitecheck?api=analyze" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"url":"https://voorbeeld.nl"}'
Body
{ "url": "https://voorbeeld.nl" }

Zelf iets bouwen

Gebruik de uitkomst in je eigen project.

Je kunt de JSON-uitkomst bijvoorbeeld in een dashboard tonen of gebruiken in je eigen script. Houd rekening met de limieten en vang foutmeldingen netjes af.

Response

Voorbeeld van een succesvolle response

{ "ok": true, "input_url": "https://voorbeeld.nl", "checked_at": "2026-03-27 12:00:00", "summary": { "overall_score": 91, "security_score": 87, "seo_score": 100, "performance_score": 100, "setup_score": 81, "verdict": "Sterke technische basis met alleen kleine optimalisaties." }, "request": { "final_url": "https://voorbeeld.nl/", "host": "voorbeeld.nl", "status": 200, "redirect_count": 1, "http_version": "HTTP/2", "content_type": "text/html; charset=UTF-8", "compressed": true, "page_size": "10,1 KB", "timings": { "dns_ms": 5, "connect_ms": 18, "ssl_ms": 34, "ttfb_ms": 79, "total_ms": 126 } }, "cms": { "generator": null, "matches": [], "primary": null }, "ssl": { "ok": true, "subject": "voorbeeld.nl", "issuer": "R11", "valid_from": "2026-01-01 00:00", "valid_to": "2026-04-01 23:59", "days_left": 21, "san": "DNS:voorbeeld.nl, DNS:www.voorbeeld.nl" }, "dns": { "a": ["192.0.2.10"], "aaaa": ["2001:db8::10"], "mx": ["mail.voorbeeld.nl"], "ns": ["ns1.provider.tld", "ns2.provider.tld"], "txt": [], "spf": "v=spf1 include:_spf.provider.tld ~all", "dmarc": "v=DMARC1; p=quarantine;" }, "redirects": { "http_to_https": true, "host_consistent": true, "final_hosts": ["voorbeeld.nl"] }, "highlights": { "good": [], "improve": [] }, "checks": { "security": [], "seo": [], "performance": [], "setup": [] } }

Input

Verplichte parameter

url
Verplicht. Domein of volledige URL die je wilt analyseren.

Validatie

Wat wordt geblokkeerd?

Interne hosts
localhost, .local en private IP-ranges worden geweigerd.
Alleen HTTP/HTTPS
Andere schema’s worden niet ondersteund.
Publieke DNS only
De host moet resolve’en naar een publiek IP-adres.
Geen netwerk-speeltuin
SSRF-achtige invoer wordt bewust beperkt.

HTTP statuscodes

Foutafhandeling

200
Analyse succesvol uitgevoerd.
422
Ongeldige invoer of niet-toegestane host.
429
Rate limit bereikt. Wacht en probeer opnieuw.
502
Doelsite kon niet goed worden opgehaald of geanalyseerd.

Ideeën om mee verder te gaan

Wat kun je ermee bouwen?

Interne dashboards
Bijvoorbeeld voor klanten, projecten of periodieke technische controles.
Een eigen tool
Bijvoorbeeld een eigen overzicht met de resultaten van deze check.
Automatisering & monitoring
Bijvoorbeeld een geplande check of een melding als er iets verandert.

Goed om te weten

Belangrijk om te weten

Geen volledige audit
Dit is een snelle technische inspectie, geen diepgaande pentest of Lighthouse-vervanger.
Indicatief, niet absoluut
Gebruik de scores als eerste indruk. Als de tool een CMS herkent, is dat een inschatting en geen zekerheid.
Respecteer fair use
Niet bedoeld voor massascans, scraping op grote schaal of misbruik van publieke infrastructuur.

Vragen of ideeën?

Iets gebouwd met deze API? Leuk om te zien.

Ik vind het leuk om te zien wat anderen met deze tool maken. Heb je een idee, loop je tegen een fout aan of mis je iets in de uitkomst? Laat het gerust weten.

Voor hulp met websites, hosting of een eigen integratie kun je ook bij T-Unlimited terecht.