{ "openapi": "3.0.1", "info": { "title": "SEO Page Audit: On-Page Checker, Meta, Headings, Schema", "description": "Audit pages for on-page SEO: title and meta description length and duplicates, canonical, noindex, headings, alt text, broken images, Open Graph, structured data and mixed content, with an issue list and a 0-100 score. Crawl a site, a sitemap or a URL list.", "version": "0.0", "x-build-id": "fiZ0yAj3elf1z1Bbg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/charlesmarkette~seo-page-audit-on-page-checker-meta-headings-schema/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-charlesmarkette-seo-page-audit-on-page-checker-meta-headings-schema", "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/charlesmarkette~seo-page-audit-on-page-checker-meta-headings-schema/runs": { "post": { "operationId": "runs-sync-charlesmarkette-seo-page-audit-on-page-checker-meta-headings-schema", "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/charlesmarkette~seo-page-audit-on-page-checker-meta-headings-schema/run-sync": { "post": { "operationId": "run-sync-charlesmarkette-seo-page-audit-on-page-checker-meta-headings-schema", "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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Pages to audit, one per line. Each URL becomes one output row. With 'Crawl the site' on, these are also where the crawl starts.", "items": { "type": "string" } }, "crawl": { "title": "Crawl the site", "type": "boolean", "description": "Off: only the URLs you list (and sitemap pages) are audited. On: links found on audited pages are followed too, staying on the same sites as the start URLs (www. and non-www count as one site), up to 'Max pages' and 'Max crawl depth'.", "default": false }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 5000, "type": "integer", "description": "When crawling or reading sitemaps, no new pages are added once this many URLs are queued (start URLs and sitemap pages count). Start URLs and dataset URLs you give yourself are always audited.", "default": 50 }, "maxDepth": { "title": "Max crawl depth", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many clicks away from a start URL the crawl goes. 0 = only the start URLs, 1 = pages they link to, and so on.", "default": 2 }, "sitemapUrls": { "title": "Sitemap URLs", "type": "array", "description": "Optional. XML sitemaps, sitemap indexes or plain-text sitemaps (gzipped is fine). Their page URLs are audited, up to 'Max pages'.", "items": { "type": "string" } }, "datasetId": { "title": "Dataset to audit", "type": "string", "description": "Optional. A dataset from another run that has page URLs (a sitemap run, a crawler's results…). Each item's URL is audited and the audit columns are added next to the item's fields. Use {{resource.defaultDatasetId}} in an integration." }, "urlField": { "title": "URL field", "type": "string", "description": "The item field that holds the page URL. Dotted paths work (page.url). Default: url." }, "keepItemFields": { "title": "Keep the item's original fields", "type": "boolean", "description": "On: each output row is the original item plus the audit columns (audit columns win if a name clashes). Off: only the audit columns.", "default": true }, "checkImages": { "title": "Check images", "type": "boolean", "description": "Sends a HEAD request to up to 30 images per page to find broken images (HTTP 4xx/5xx or unreachable) and images over 500 KB. Each image is checked once per run.", "default": true }, "checkLinks": { "title": "Check internal links", "type": "boolean", "description": "Sends a HEAD request to up to 50 same-site links per page to find broken internal links. Each link is checked once per run. Off by default because it adds requests to the site.", "default": false }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "On (recommended): pages robots.txt disallows for bots get a free 'robots-blocked' row instead of being fetched. If robots.txt can't be read because the site is down or overloaded (HTTP 429 or 5xx), the site is treated as off-limits, as RFC 9309 says. Either way, each row reports whether robots.txt allows the page for Googlebot.", "default": true }, "concurrency": { "title": "Parallel pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages to audit at the same time (1–20).", "default": 5 }, "perHostConcurrency": { "title": "Parallel requests per site", "minimum": 1, "maximum": 10, "type": "integer", "description": "At most this many requests to the same host at a time (1–10), image and link checks included, to stay polite to each site.", "default": 2 }, "timeoutSecs": { "title": "Timeout per request (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long one request may take (5–120). A page, with its redirects and retries, gets at most twice this long.", "default": 30 }, "maxResults": { "title": "Max output rows", "minimum": 1, "type": "integer", "description": "Optional cap on output rows (each row is one URL, audited or not)." } } }, "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 } } } } } } } } } }