{"uid":"cap_fJ2LhDAp70p8kkAllCckz","slug":"structured-data-contract-audit-0e568d17","name":"Structured Data Contract Audit","description":"Audit the JSON-LD a supplied page declares against a contract the caller states. Entities inside @graph and nested inside other entities are flattened first, because reading only the top level misses every entity a real page declares that way. Reports required types absent, required properties missing per entity, unmentioned types when unknown types are forbidden, entities with no @type, and blocks with no @context. Only JSON-LD is read, and that is stated rather than treated as conformant.","url":"https://api.zfinia.com/x402/v1/structured-data-contract-audit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"html":{"type":"string","maxLength":262144},"contract":{"type":"object","properties":{"required_types":{"type":"array","items":{"type":"string","maxLength":128},"maxItems":50,"minItems":1},"required_properties":{"type":"object"},"forbid_unknown_types":{"type":"boolean"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.13","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.13/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.13","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.13","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S8D258v3Kh8eLOHndkw4o","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.13","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits JSON-LD structured data on a webpage against a caller-defined contract, reporting missing types, missing properties, unknown types, and untyped/contextless blocks after flattening nested and @graph entities.","exampleAgentPrompt":"Can you audit the JSON-LD structured data on https://example.com/product-page and check that it includes the types Product and Organization, that Product has name, price, and description properties, and that no unknown types are allowed?","exampleUseCases":[{"title":"SEO structured data compliance check","prompt":"Audit the JSON-LD on https://shop.example.com/shoes/running for me — I need it to have Product and BreadcrumbList types, with Product including name, sku, and offers properties, and flag anything that isn't one of those types."},{"title":"News article markup validation","prompt":"Check the structured data on this news article page https://news.example.com/article/123 and make sure it declares a NewsArticle type with headline, datePublished, and author properties — and let me know if there are any blocks missing @context."},{"title":"Local business listing audit","prompt":"I'm pasting in the HTML for our local business homepage — can you verify the JSON-LD has LocalBusiness with name, address, and telephone, and that there are no unknown types sneaking in? Here's the HTML: <html>...</html>"}],"resultDescription":"A structured audit report listing: required types that are absent from the page's JSON-LD; required properties that are missing per matched entity type; unknown or unmentioned types when forbidden; entities that have no @type declared; and JSON-LD blocks that have no @context. Entities nested inside @graph or other entities are flattened before evaluation so nothing is missed.","failureModes":["Page URL is unreachable or returns non-200 — audit cannot proceed","HTML exceeds 262144 character limit — payload rejected","No JSON-LD blocks found on the page — nothing to audit","contract.required_types is empty or missing — validation has nothing to check against","Malformed JSON-LD on the page — blocks may be partially skipped","Network timeout fetching the supplied URL"],"whenToPreferThis":"Choose this endpoint when you need to programmatically enforce a specific JSON-LD contract on a webpage — especially when entities may be nested inside @graph or other entities that a shallow top-level check would miss. It is ideal for SEO pipelines, CMS publishing gates, or automated QA workflows that need to assert exact type presence, required property coverage, and type allowlists. Prefer it over generic HTML validators or Schema.org linters when you need contract-driven, caller-defined rules rather than general well-formedness checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:47:09.518Z","isFirstParty":false,"canonicalSlug":"structured-data-contract-audit-0e568d17"}