Structured Data
developer/v1/domain/structured-dataExtracts and validates structured data markup (JSON-LD, Microdata) from web pages. Identifies schema.org types used and validates against specifications.
What It Does
Parses HTML for JSON-LD 1.1 script blocks and Microdata markup. Identifies schema.org types (Organization, Product, Article, etc.), validates required properties, and checks for common errors.
Why It's Useful
Structured data enables rich search results (stars, prices, FAQs in search). Proper implementation improves click-through rates and search visibility.
Use Cases
Rich Results Optimization
Audit structured data to maximize rich result eligibility in search.
Improve search result appearance and click-through rates.
Competitive Analysis
Analyze competitor structured data to understand their rich result strategy.
Identify schema types to implement for competitive advantage.
Implementation Validation
Verify JSON-LD implementation before deploying to production.
Catch structured data errors before they affect search visibility.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Required | Domain or full URL — accepts `example.com` or `https://example.com/path`.Example: https://example.com |
Response Fields
| Field | Type | Description |
|---|---|---|
domain | string | The queried domain (bare hostname). |
url | string | Full URL that was fetched, echoing the protocol used in the request. |
hasStructuredData | boolean | Whether any structured data was found |
jsonLd | array | Parsed JSON-LD objects with validation results |
schemaTypes | array | Schema.org types found |
richResultsEligibility | array | Per-type Google Search Gallery eligibility (ready, missingRequired, missingRecommended, googleSearchGalleryUrl). Tells you whether each markup block will ACTUALLY get rich results — not just whether the JSON-LD parses. |
strategicGaps | object | High-leverage SERP features commonly missing: missingBreadcrumbList (SERP breadcrumbs), missingOrganization (brand knowledge panel), missingWebSite + missingSiteSearchAction (SERP sitelinks search box). Each is a small JSON-LD block that produces immediate, visible SERP changes. |
microdata | array | Microdata items found |
summary | object | Summary of structured data analysis |
errors | array | Validation issues detected |
score | number | Quality score (0-100) |
grade | string | Letter grade (A+ to F) based on score |
recommendations | array | Improvement suggestions |
Code Examples
curl "https://api.edgedns.dev/v1/domain/structured-data" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "domain=https://example.com"const response = await fetch(
'https://api.edgedns.dev/v1/domain/structured-data?domain=https%3A%2F%2Fexample.com',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/domain/structured-data',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
'domain': 'https://example.com'
}
)
data = response.json()
print(data)Read the full Structured Data guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.
Try This Endpoint
Test the Structured Data endpoint live in the playground.