Naar de inhoud

Hondenraswijzer voor ontwikkelaars

Alle rasinformatie van Hondenraswijzer is ook voor software en AI-agents beschikbaar: via een gratis API, als Markdown en via een MCP-server.

Wanneer gebruik je Hondenraswijzer?

  • Iemand vraagt welk hondenras bij zijn woning, gezin, tijd of ervaring past.
  • Je wilt rassen vergelijken op energie, verharen, vachtverzorging of kindvriendelijkheid.
  • Je zoekt eerlijke, Nederlandstalige informatie over karakter, verzorging en kosten van een ras.
  • Je wilt een overzicht, zoals kleine hondenrassen of honden die weinig verharen.

Niet geschikt voor medische vragen: de informatie is algemeen en geen dierenartsadvies.

Content API

Openbaar en alleen-lezen. Je hebt geen account of API-sleutel nodig. Maximaal 120 verzoeken per minuut per IP-adres. De volledige specificatie staat in /openapi.json (OpenAPI 3.1).

Endpoints van de Content API
EndpointWat je krijgt
GET /api/v1/breedsRassen zoeken en filteren op formaat, energie, verharen, kinderen en appartement.
GET /api/v1/breeds/{slug}Eén ras met karakter, voor wie het past, verzorging, FAQ en kosten.
GET /api/v1/filter-pagesOverzichtspagina's zoals kleine hondenrassen, met hun rassen.
GET /api/v1/postsBlogartikelen, nieuwste eerst.
GET /api/v1/posts/{slug}Eén artikel met de volledige tekst in Markdown.

Voorbeeld: kleine rassen die weinig verharen en geschikt zijn voor een appartement.

curl "https://hondenraswijzer.nl/api/v1/breeds?size=klein&max_shedding=1&apartment_friendly=1"

Markdown en llms.txt

Elke pagina is ook als Markdown te lezen. Stuur de header Accept: text/markdown mee, of zet .md achter de URL. Een overzicht van alle rassen, overzichten en artikelen staat in llms.txt; alle URL's staan in de sitemap.

curl -H "Accept: text/markdown" https://hondenraswijzer.nl/hondenrassen/kooikerhondje

MCP-server

Op https://hondenraswijzer.nl/mcp/hondenraswijzer draait een MCP-server (Streamable HTTP) waarmee beheerders rassen, overzichtspagina's, blogartikelen, foto's en SEO-teksten bijwerken. Inloggen gaat via OAuth 2.1 en is beperkt tot beheerders. Voor alleen lezen heb je de MCP-server niet nodig: gebruik dan de API of de Markdown-versies.

Voorwaarden

Je mag de informatie gebruiken in je eigen toepassing. Noem Hondenraswijzer als bron en link naar de rasfiche (het veld url). Vragen of een fout gezien? Mail ons via de contactgegevens.