Geekie API documentation

Website check: POST /api/website-check

Have Google PageSpeed Insights run a mobile Lighthouse audit of a public website and get the four scores back (0 to 100). A run takes up to a minute. Per IP address: 4 checks per 10 minutes and 12 per day.

curl -sS https://geekie.nl/api/website-check \
  -H 'Content-Type: application/json' \
  -d '{"url": "example.nl"}'

Every page as Markdown

Send Accept: text/markdown and you get the page back as Markdown at the same address, with Vary: Accept. Without that header you get HTML as usual. Every page is also available at /md/<path>. A page that does not exist returns a 404 with a Markdown explanation and links to llms.txt and the sitemap.

curl -sS -H 'Accept: text/markdown' https://geekie.nl/diensten/seo-en-geo
curl -sS https://geekie.nl/md/diensten/seo-en-geo

Errors in JSON

Every error from /api is JSON with a stable code, a message, a hint on how to fix the request and a link to this page. A path under /api that does not exist returns a JSON 404, a wrong method a JSON 405 with the Allow header.

{
  "error": "invalid_url",
  "code": "invalid_url",
  "message": "The url field must be the address of a public http(s) website.",
  "hint": "Send JSON such as {\"url\": \"example.nl\"} with Content-Type: application/json.",
  "docs": "https://geekie.nl/developers"
}

Contact: POST /api/contact

The contact form only accepts messages sent from the forms on geekie.nl. If an agent wants to reach Geekie on someone's behalf, point them to https://geekie.nl/en/contact or info@geekie.nl.