apyhub
DATA EXTRACTION · DATA VALIDATION

Validate Schema API

What it does

Schema Validator checks a webpage for structured data and returns the markup it finds, along with a validation summary. Send a single url in the request body and get back the page URL plus structured signals you can inspect in your own tooling.

The response can include json_ld, microdata, meta_tags, open_graph, and twitter_card, so you can compare different metadata formats without scraping the page twice. The summary object gives you counts and health indicators such as warnings, critical_errors, types_found, total_entities, overall_score, and rich_results_eligible.

Use Schema Validator when you need to audit a marketing page, check whether product pages expose the right schema types, or spot structured-data issues before they affect search appearance. It is a fit for SEO checks, content QA, and automated page audits where you only need the validated metadata and a concise result set.

The service only accepts an HTTP or HTTPS webpage URL, and the output is focused on what was discovered on that page rather than a broad crawl or a full document parse.

POST
Validate Schema (Structured Data)
https://api.eu.apyverse.com/chisleroff/validate-schema-structured-data

QUICKSTART

GUIDE

Quickstart

Send a webpage URL to extract and validate its structured data.

curl -X POST "https://api.eu.apyverse.com/chisleroff/validate-schema-structured-data" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

What you'll get back

Returns a JSON object with these top-level fields when present: url and source_url are strings; json_ld and microdata are arrays of objects; meta_tags, open_graph, and twitter_card are objects; and summary is an object with warnings, overall_score, total_entities, and critical_errors numbers, plus types_found and rich_results_eligible arrays of strings.

{
  "url": "https://example.com",
  "json_ld": [],
  "summary": {
    "warnings": 0,
    "types_found": [],
    "overall_score": 0,
    "total_entities": 0,
    "critical_errors": 0,
    "rich_results_eligible": []
  },
  "meta_tags": {},
  "microdata": [],
  "open_graph": {},
  "source_url": "https://example.com",
  "twitter_card": {}
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
URL of the webpage to extract, audit, or validate content from (http/https only).

About this endpoint

What it does

Validates and extracts structured data from a webpage URL. It returns the source URL along with any discovered JSON-LD, meta tags, microdata, Open Graph data, Twitter card data, and a summary object.

Request Body

ParameterTypeMandatoryDescription
urlStringYesURL of the webpage to extract, audit, or validate content from (http/https only). Must be a URI.

Response

Returns a JSON object with url and source_url string fields, json_ld and microdata array fields, summary as an object, and meta_tags, open_graph, and twitter_card object fields. The response shape is defined by the schema; no additional fields are specified.

ParameterTypeMandatoryDescription
urlStringNoString value returned by the API.
json_ldObject ArrayNoArray of JSON-LD objects. Each item is an object; additional properties are allowed.
summaryObjectNoSummary object containing the schema-defined fields: warnings (integer), types_found (string array), overall_score (number), total_entities (integer), critical_errors (integer), and rich_results_eligible (string array).
meta_tagsObjectNoObject containing meta tag data. Additional properties are allowed.
microdataObject ArrayNoArray of microdata objects. Each item is an object; additional properties are allowed.
open_graphObjectNoObject containing Open Graph data. Additional properties are allowed.
source_urlStringNoString value returned by the API.
twitter_cardObjectNoObject containing Twitter card data. Additional properties are allowed.

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.