"you_get": { // HTTP 200 application/json after payment
"output_schema":
{
"type": "object",
"properties": {
"skill": {
"type": "string"
},
"version": {
"type": "string"
},
"url": {
"type": "string"
},
"final_url": {
"type": "string"
},
"score": {
"type": "number"
},
"grade": {
"type": "string"
},
"subscores": {
"type": "object",
"properties": {
"technical": {
"type": "integer"
},
"content": {
"type": "integer"
},
"metadata": {
"type": "integer"
},
"structured_data": {
"type": "integer"
},
"aeo": {
"type": "integer"
}
}
},
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"category": {
"type": "string"
},
"pass": {
"type": "boolean"
},
"severity": {
"type": "string"
},
"points": {
"type": "number"
},
"max": {
"type": "integer"
},
"evidence": {
"type": "string"
},
"fix": {
"type": "object"
}
}
}
},
"top_fixes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"check_id": {
"type": "string"
},
"impact_points": {
"type": "number"
},
"summary": {
"type": "string"
}
}
}
},
"generated": {
"type": "object",
"properties": {
"meta_tags_html": {
"type": "string"
}
}
},
"reason": {
"type": "null"
},
"disclaimer": {
"type": "string"
}
},
"required": [
"skill"
]
}
"example":
{
"skill": "seo_v2",
"version": "2.0",
"url": "https://www.python.org/",
"final_url": "https://www.python.org/",
"score": 77.7,
"grade": "C",
"subscores": {
"technical": 80,
"content": 90,
"metadata": 62,
"structured_data": 83,
"aeo": 72
},
"checks": [
{
"id": "canonical",
"category": "technical",
"pass": false,
"severity": "medium",
"points": 0.0,
"max": 5,
"evidence": "no rel=canonical",
"fix": {
"summary": "Use exactly one absolute, self-referencing canonical on the same host.",
"snippet": "<link rel=\"canonical\" href=\"https://www.python.org/\">",
"snippet_lang": "html",
"effort": "S"
}
},
{
"id": "h1",
"category": "content",
"pass": false,
"severity": "medium",
"points": 3.0,
"max": 5,
"evidence": "5 H1 elements",
"fix": {
"summary": "Use exactly one H1 that states the page topic in the same words as the title.",
"snippet": "<h1>Functions Defined</h1>",
"snippet_lang": "html",
"effort": "S"
}
},
{
"id": "title",
"category": "metadata",
"pass": false,
"severity": "medium",
"points": 3.0,
"max": 6,
"evidence": "title 21 chars: 'Welcome to Python.org'",
"fix": {
"summary": "Use one <title> of 30-60 characters that names the page topic.",
"snippet": "<title>Welcome to</title>",
"snippet_lang": "html",
"effort": "S"
}
}
],
"top_fixes": [
{
"check_id": "canonical",
"impact_points": 5.0,
"summary": "Use exactly one absolute, self-referencing canonical on the same host."
},
{
"check_id": "title",
"impact_points": 3.0,
"summary": "Use one <title> of 30-60 characters that names the page topic."
},
{
"check_id": "meta_description",
"impact_points": 2.5,
"summary": "Write a 70-160 character meta description from the page's own text."
}
],
"generated": {
"meta_tags_html": "<title>Welcome to</title>\n<meta name=\"description\" content=\"Notice: This page displays a fallback because interactive scripts did not run.\">\n<link rel=\"canonical\" href=\"https://www.python.org/\">"
},
"reason": null,
"disclaimer": "Scores reflect technical checks only; no ranking or citation is guaranteed."
}
},