Schema.org JSON-LD

---

Valid schema.org JSON-LD is the single biggest miss on most agent sites — and the easiest fix that actually moves AI citation odds.

Definition of Valid JSON-LD

What "valid" means here: a top-level @graph declaring at minimum RealEstateAgent (or Person), LocalBusiness, and — if you have any reviews — aggregateRating with a real ratingCount. URLs resolve. Phone numbers are E.164. Service area is geocoded. No nested entities referring to ids that don't exist.

Common Issues with AI SEO Plugins

The thing most "AI SEO" plugins ship is invalid JSON-LD: missing @type, fabricated ratingCount, schema for entities the page doesn’t actually describe. Models penalize those pages quietly — they read it as low-trust authorship.

Example of Valid JSON-LD

Realtor Maps emits a hand-built graph from src/lib/schema-jsonld.ts:buildAgentSchema(), which is part of why those pages tend to be the cited surface. See ai/chatgpt-citation-signals for what the model actually does with it.