Overview

An interactive visual representation of the knowledge graph formed by your site’s structured data. Built with D3.js, it shows entities as nodes and their relationships as edges, making it easy to understand and optimize your semantic structure.

How It Works

1. All validated schemas are aggregated into a unified entity graph
2. Entities become nodes (sized by importance/frequency)
3. Relationships become edges (typed by Schema.org property)
4. The D3.js visualization allows:
– Zoom, pan, and filter
– Click nodes to see entity details
– Highlight relationship paths
– Identify disconnected clusters

Tier Availability

| Tier | Available |
|——|———–|
| Enterprise | Yes |

Related Features

– AI Entity Graph Analyzer: AI-oriented analysis of this graph
– Orphan Entity Detector: Find disconnected nodes
– Entity Coverage Map: Tabular view of entity distribution

Mini-Tutorial

Visualizing and Optimizing Your Knowledge Graph

1. Fetch the graph data in D3.js format:

   GET /validgraph/v1/entity-graph?site_id=abc123
   

2. Render the visualization using D3.js with the returned nodes and links data

3. Analyze the graph structure:
– Large central nodes = hub entities (Organization, WebSite)
– Small isolated nodes = orphan entities
– Thick edges = strong relationship patterns
– Sparse areas = entities with few connections

4. Identify optimization opportunities:
– Isolated Article nodes → connect via author to Organization
– Product nodes without brand reference → add brand relationship
– Missing connections between related entities

5. Update schemas to add missing relationships and re-validate

Technical Details

Graph Construction and Rendering

1. Node Creation:
– Extracted from all validated pages
– Identified by @id (preferred), url, or normalized name
– Properties: type, label, size (based on appearance frequency), color (by schema type)

2. Edge Creation:
– Built from reference properties: author, publisher, brand, offers, location, creator, mainEntity, parentOrganization, parentCompany, subOrganization
– Directional: from source entity to referenced entity
– Labeled with property name

3. D3.js Visualization:
– Force-directed layout for organic positioning
– Zoom/pan capabilities
– Click-to-inspect entity details
– Hover-to-highlight relationship paths

4. Graph Metrics:
– Node centrality scores
– Path analysis between entities
– Cluster detection

REST API Example

Request:

GET /validgraph/v1/entity-graph?format=d3js

Response:

{
  "nodes": [
    {
      "id": "https://example.com/org",
      "label": "Acme Corp",
      "type": "Organization",
      "size": 5,
      "color": "#FF6B6B"
    },
    {
      "id": "https://example.com/article/widget-guide",
      "label": "Widget Buyer's Guide",
      "type": "Article",
      "size": 2,
      "color": "#4ECDC4"
    }
  ],
  "links": [
    {
      "source": "https://example.com/article/widget-guide",
      "target": "https://example.com/org",
      "property": "author",
      "strength": 1.0
    }
  ],
  "statistics": {
    "total_nodes": 42,
    "total_edges": 38,
    "density": 0.042,
    "avg_degree": 1.81
  }
}

References

– D3.js Documentation
– Knowledge Graph Visualization Best Practices
– Schema.org Reference Properties