Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Schema.org website screenshot

Schema.org

Schema.org is a collaborative, community-driven project that creates and maintains a shared vocabulary for structured data on the web. Founded by Google, Microsoft, Yahoo, and Yandex in 2011, it provides types and properties that developers and webmasters use to annotate content in formats like JSON-LD, RDFa, and Microdata, enabling search engines and applications to better understand web content. The vocabulary currently consists of 800+ Types, 1500+ Properties, and covers domains including commerce, healthcare, organizations, events, creative works, and more. The Schema.org WebAPI type provides a standardized vocabulary for describing APIs in structured data.

human only

Limited machine-readable signal and partial portal coverage — documentation a human can read, but little a machine or agent can consume without scraping.

Kin Score

API Evangelist profiles Schema.org the way a machine reads it — 93 machine-readable artifacts across 4 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.

Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — Schema.org scores 40.7/100 (thin), with a separate agent-readiness read of 7/100 (human only). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.

Kin Score

This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 40.7/100 · thin
Contract Quality 5.2 / 25
Developer Ergonomics 3.0 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.1 / 13
Governance 10.4 / 12
Discoverability 10.0 / 10
Agent readiness — 7/100 · human only
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3

How we profile Schema.org

Each block below is one kind of artifact we hold for Schema.org. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.

APIs 4

Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.

Individual APIs this provider publishes, each with its own machine-readable definition.

Schema.org Vocabulary

Schema.org is a collaborative, community-driven vocabulary for structured data on the internet. It provides a collection of shared vocabularies that webmasters and developers ca...

Schema.org JSON-LD Context

The Schema.org JSON-LD Context provides the canonical JSON-LD context file for the Schema.org vocabulary. This context file maps Schema.org terms to their full IRIs, enabling JS...

Schema.org Markup Validator

The Schema.org Markup Validator tests and validates structured data markup against the Schema.org vocabulary. It supports JSON-LD, Microdata, and RDFa formats and helps ensure s...

Schema.org WebAPI Type

The Schema.org WebAPI type defines a Web API accessible over Web and Internet technologies. It provides standardized properties for describing APIs including documentation URL, ...

Pricing Plans 1

Pricing is part of the interface. Machine-readable plans tell you what a tier costs and includes before you commit — one of the six things the Kin Score reads for commercial clarity.

Published pricing tiers and plan structures.

Rate Limits 1

Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.

Documented rate limits and quota policies.

Schema Org Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals let a buyer model the financial operations of an API before it's live. We profile them for the same reason we profile pricing: the money is part of the contract.

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts give the data shared meaning across APIs. We profile them because semantics are what let a machine reconcile 'customer' here with 'customer' somewhere else.

JSON-LD contexts and semantic vocabularies used across these APIs.

Schema Org Context

0 classes · 8 properties

JSON-LD

Spectral Rules 2

Governance rulesets we run against this provider's specs — the automated checks behind parts of the score. Profiling them makes the quality bar explicit and re-runnable, not a matter of opinion.

Schema.org API Rules

6 rules · 4 warnings

SPECTRAL

Schema.org API Rules

10 rules · 5 errors · 5 warnings

SPECTRAL

JSON Schema 40

Standalone JSON Schema definitions describe the data models behind the API. We profile them so the shapes are validatable on their own — useful long after a single request is forgotten.

Standalone JSON Schema definitions for this provider's data models.

Schema.org Action

17 properties

JSON SCHEMA

Schema.org AggregateRating

8 properties

JSON SCHEMA

Schema.org Article

26 properties

JSON SCHEMA

Schema.org BlogPosting

20 properties

JSON SCHEMA

Schema.org Book

21 properties

JSON SCHEMA

Schema.org BreadcrumbList

6 properties

JSON SCHEMA

Schema.org ContactPoint

13 properties

JSON SCHEMA

Schema.org Course

23 properties

JSON SCHEMA

Schema.org CreativeWork

41 properties

JSON SCHEMA

Schema.org Drug

31 properties

JSON SCHEMA

Schema.org Event

30 properties

JSON SCHEMA

Schema.org FAQPage

12 properties

JSON SCHEMA

Schema.org GeoCoordinates

8 properties

JSON SCHEMA

Schema.org HowTo

18 properties

JSON SCHEMA

Schema.org ImageObject

22 properties

JSON SCHEMA

Schema.org Invoice

18 properties

JSON SCHEMA

Schema.org ItemList

8 properties

JSON SCHEMA

Schema.org JobPosting

26 properties

JSON SCHEMA

Schema.org LocalBusiness

29 properties

JSON SCHEMA

Schema.org MediaObject

20 properties

JSON SCHEMA

Schema.org MedicalCondition

21 properties

JSON SCHEMA

Schema.org MedicalProcedure

19 properties

JSON SCHEMA

Schema.org Offer

31 properties

JSON SCHEMA

Schema.org Order

22 properties

JSON SCHEMA

Schema.org Organization

33 properties

JSON SCHEMA

Schema.org Person

31 properties

JSON SCHEMA

Schema.org Place

26 properties

JSON SCHEMA

Schema.org PostalAddress

15 properties

JSON SCHEMA

Schema.org Product

35 properties

JSON SCHEMA

Schema.org PropertyValue

12 properties

JSON SCHEMA

Schema.org QuantitativeValue

10 properties

JSON SCHEMA

Schema.org Review

15 properties

JSON SCHEMA

Schema.org SearchAction

9 properties

JSON SCHEMA

Schema.org Service

24 properties

JSON SCHEMA

Schema.org SoftwareApplication

31 properties

JSON SCHEMA

Schema.org Thing

13 properties

JSON SCHEMA

Schema.org VideoObject

27 properties

JSON SCHEMA

Schema.org WebAPI

12 properties

JSON SCHEMA

Schema.org WebPage

22 properties

JSON SCHEMA

Schema.org WebSite

11 properties

JSON SCHEMA

Scroll within the panel for all 40 ·

JSON Structure 40

JSON Structure captures the data shapes in a form built for tooling — a complement to JSON Schema that keeps the model machine-legible.

JSON Structure definitions describing this provider's data shapes.

Schema Org Action

17 properties

JSON STRUCTURE

Schema Org Aggregate Rating

8 properties

JSON STRUCTURE

Schema Org Article

26 properties

JSON STRUCTURE

Schema Org Blog Posting

19 properties

JSON STRUCTURE

Schema Org Book

21 properties

JSON STRUCTURE

Schema Org Breadcrumb List

6 properties

JSON STRUCTURE

Schema Org Contact Point

13 properties

JSON STRUCTURE

Schema Org Course

23 properties

JSON STRUCTURE

Schema Org Creative Work

39 properties

JSON STRUCTURE

Schema Org Drug

30 properties

JSON STRUCTURE

Schema Org Event

30 properties

JSON STRUCTURE

Schema Org Faq Page

12 properties

JSON STRUCTURE

Schema Org Geo Coordinates

8 properties

JSON STRUCTURE

Schema Org How To

18 properties

JSON STRUCTURE

Schema Org Image Object

22 properties

JSON STRUCTURE

Schema Org Invoice

18 properties

JSON STRUCTURE

Schema Org Item List

8 properties

JSON STRUCTURE

Schema Org Job Posting

25 properties

JSON STRUCTURE

Schema Org Local Business

29 properties

JSON STRUCTURE

Schema Org Media Object

20 properties

JSON STRUCTURE

Schema Org Medical Condition

21 properties

JSON STRUCTURE

Schema Org Medical Procedure

17 properties

JSON STRUCTURE

Schema Org Offer

30 properties

JSON STRUCTURE

Schema Org Order

22 properties

JSON STRUCTURE

Schema Org Organization

33 properties

JSON STRUCTURE

Schema Org Person

31 properties

JSON STRUCTURE

Schema Org Place

26 properties

JSON STRUCTURE

Schema Org Postal Address

15 properties

JSON STRUCTURE

Schema Org Product

35 properties

JSON STRUCTURE

Schema Org Property Value

11 properties

JSON STRUCTURE

Schema Org Quantitative Value

9 properties

JSON STRUCTURE

Schema Org Review

15 properties

JSON STRUCTURE

Schema Org Search Action

9 properties

JSON STRUCTURE

Schema Org Service

20 properties

JSON STRUCTURE

Schema Org Software Application

30 properties

JSON STRUCTURE

Schema Org Thing

13 properties

JSON STRUCTURE

Schema Org Video Object

27 properties

JSON STRUCTURE

Schema Org Web Api

12 properties

JSON STRUCTURE

Schema Org Web Page

21 properties

JSON STRUCTURE

Schema Org Web Site

11 properties

JSON STRUCTURE

Scroll within the panel for all 40 ·

Examples 2

Real request and response payloads are what turn a spec from abstract into obvious — and they're one of the twelve things an agent needs to call an API correctly on the first try.

Example request and response payloads for these APIs.

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Schema Org Domain Security

TLSv1.3 · DMARC

SECURITY

Resources

Every other property we hold for Schema.org — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.

Documentation 1

Reference material describing how the API behaves

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Access & Security 1

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Company 2

The organization behind the API

← All providers · Data indexed from github.com/api-evangelist/schema-org · machine-readable index on apis.io