Loopwise Docs
Guides

Storefront content API

Read a Loopwise storefront's catalog — courses, posts, events, downloads, plans, lecturers — as agent-friendly markdown, and find the machine-readable OpenAPI spec.

Every Loopwise storefront exposes its public catalog as agent-friendly markdown, so an AI agent can read a course or lecturer page without parsing HTML. All paths are served per storefront origin — substitute the storefront's host below.

Markdown content endpoints

GET https://school.example/api/md/{resource}
PathContent
/api/md/homeHomepage
/api/md/faqFAQ
/api/md/coursesCourse index
/api/md/courses/{slug}A course
/api/md/posts/{slug}A post
/api/md/events/{slug}An event
/api/md/digital-downloads/{slug}A digital download
/api/md/plans/{slug}A membership plan
/api/md/categories/{slug}A category
/api/md/lecturersLecturer index
/api/md/lecturers/{slug}A lecturer profile

Each returns text/markdown with YAML frontmatter.

Content negotiation

The same markdown is available on the equivalent HTML page by sending an Accept: text/markdown header — no separate URL needed:

curl -H "Accept: text/markdown" https://school.example/courses/my-course

On enterprise-training storefronts the HTML content pages are authentication-gated before the markdown rewrite runs, so this content-negotiation form can return a login redirect for an anonymous agent. The /api/md/* endpoints above bypass that gate and stay readable without a session — prefer them when you may be anonymous.

Bulk index

  • GET /llms.txt — a compact, linked index of the storefront's content and its developer/agent resources.
  • GET /llms-full.txt — a single-document bundle of the content.

Machine-readable spec

The authoritative, per-origin description of these endpoints (plus the OAuth 2.0 / OpenID Connect endpoints) is published as OpenAPI 3.0:

GET https://school.example/openapi.json

Its servers[].url is the requested origin, so the spec is directly usable against the storefront it was fetched from. To discover this and every other agentic resource from one place, start at the AI Catalog.

On this page