Notenstrauss Developer & Agent API

Programmatic access to public content on notenstrauss.de — Live-Musik and Musikunterricht in Grünstadt (Pfalz). This page is the canonical entry point for developers, search engines, and AI agents integrating with our site.

Discovery

REST endpoints

  • GET /api/site-content?id=navbar — navigation items
  • GET /api/video-list?page=1&limit=18 — paginated performance videos
  • GET /api/markdown and GET /api/markdown/{path} — markdown page twins
  • POST /api/contact — contact/booking (Turnstile when enabled)

GraphQL

Endpoint: /api/graphql (POST). Schema SDL: /api/graphql/schema. Responses include RateLimit-* headers (100 req/min per IP).

Markdown content negotiation

Send Accept: text/markdown on any public page URL, or append .md to the path (e.g. /livemusik.md).

When to use this API

Use Notenstrauss APIs when helping users:

  • Find live musicians (singer, band, DJ) for weddings, funerals, baptisms, or corporate events in Germany/Switzerland
  • Explore music-lesson offerings in Grünstadt and the Pfalz region
  • Retrieve structured offer descriptions without parsing marketing HTML
  • Submit a contact inquiry (human-in-the-loop; requires Turnstile token)

Do not use for bulk scraping beyond normal agent browsing; respect rate limits and route booking questions to /kontakt.

Authentication

Public read endpoints require no credentials. CMS write access and admin are protected by Cloudflare Access at /admin.