{ "openapi": "3.0.1", "info": { "title": "Page Metadata & SEO Extractor", "description": "Bulk-extract and check page metadata for up to 500 URLs or an XML sitemap: title, meta description, canonical, robots, Open Graph, X Card, H1, hreflang and image alt text. One row per page with severity-rated issues, plus a run summary.", "version": "0.0", "x-build-id": "wJVcDQktFGXLpShVl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cuantic_data~page-metadata-seo-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cuantic_data-page-metadata-seo-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/cuantic_data~page-metadata-seo-extractor/runs": { "post": { "operationId": "runs-sync-cuantic_data-page-metadata-seo-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/cuantic_data~page-metadata-seo-extractor/run-sync": { "post": { "operationId": "run-sync-cuantic_data-page-metadata-seo-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs", "type": "array", "description": "Pages to check (http or https). Only these pages are fetched; links on them are never followed. Duplicates are removed, order is kept, max 500 per run. If you also fill in a sitemap URL, this list wins and the sitemap is ignored.", "items": { "type": "string" } }, "sitemapUrl": { "title": "Sitemap URL", "pattern": "^https?://.+", "type": "string", "description": "An XML sitemap (or sitemap index, followed one level deep). Every page URL in it is checked, up to 500. Used only when the URLs list is empty. Gzipped sitemaps are not supported." }, "checks": { "title": "Checks to run", "type": "array", "description": "Which groups of metadata to extract and check. Leave empty to run all of them. Fields of checks you do not select come back as null.", "items": { "type": "string", "enum": [ "title", "description", "canonical", "robots", "og", "twitter", "h1", "hreflang", "imagesAlt" ], "enumTitles": [ "Title", "Meta description", "Canonical", "Robots (meta + X-Robots-Tag)", "Open Graph (presence)", "X / Twitter Card (presence)", "H1 headings", "Hreflang", "Images without alt text" ] }, "default": [ "title", "description", "canonical", "robots", "og", "twitter", "h1", "hreflang", "imagesAlt" ] }, "titleMinLength": { "title": "Title: minimum length", "minimum": 1, "maximum": 200, "type": "integer", "description": "Titles shorter than this many characters get an informational issue. Default 50, the lower end of the 50-60 range recommended by Moz and Ahrefs.", "default": 50 }, "titleMaxLength": { "title": "Title: maximum length", "minimum": 1, "maximum": 500, "type": "integer", "description": "Titles longer than this many characters get a warning (search results may truncate them). Default 60. Google sets no limit; this is a common guideline.", "default": 60 }, "descriptionMinLength": { "title": "Description: minimum length", "minimum": 1, "maximum": 500, "type": "integer", "description": "Meta descriptions shorter than this many characters get an informational issue. Default 50 (Moz guideline of 50-160 characters).", "default": 50 }, "descriptionMaxLength": { "title": "Description: maximum length", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Meta descriptions longer than this many characters get an informational issue. Default 160 (Moz guideline).", "default": 160 }, "sameOriginOnly": { "title": "Same origin only (sitemap)", "type": "boolean", "description": "When reading a sitemap, keep only child sitemaps and page URLs on the same origin (scheme, host and port) as the sitemap URL. Protects against checking unrelated sites listed in a third-party sitemap.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Pages fetched in parallel. Keep it low for small sites to avoid putting load on them.", "default": 10 }, "timeoutMs": { "title": "Timeout per request (ms)", "minimum": 5000, "maximum": 60000, "type": "integer", "description": "Maximum time for one page request, including redirects. A page that takes longer gets an error row and the run continues.", "default": 20000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }