Developer API

A RESTful interface for curl and custom integrations.

Our Developer API exposes the same validation engine that powers the playground allowing you to build your own custom integrations and tools. Submit HTML pages, JSON-LD snippets, or RDF documents over HTTP and receive structured messages with severity, source offsets, and SEO recommendations.

Server

All programmatic access must target https://api.schemamarkup.app.

> curl 'https://api.schemamarkup.app/ok'
ok

Authentication

For paid plans, create and authenticate using an Access Token for additional features and usage limits. Include these bearer tokens with the Authorization request header. Anonymous access is supported, but subject to IP-based usage limits.

POST /v1/document.process HTTP/1.1
Host: api.schemamarkup.app
Authorization: Bearer {ACCESS_TOKEN}

Endpoints

/v1/document.export — Tidy or convert a document to alternative RDF encodings.
/v1/document.process — Process a document and return an annotated dataset and messages.
/v1/document.validate — Validate a document and return structured validation messages.