{ "openapi": "3.0.1", "info": { "title": "SEO Audit + AI Visibility · Are You Citable by ChatGPT?", "description": "Technical SEO audit plus the question no other audit answers: can AI systems cite you? Checks which AI crawlers your robots.txt allows (only retrieval agents can cite you), flags pages that are empty without JavaScript, and diffs against your previous run. Plus fixes you can paste.", "version": "0.1", "x-build-id": "f7fk7nJC4ro6xcy9b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/siccscha~seo-health-auditor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-siccscha-seo-health-auditor", "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/siccscha~seo-health-auditor/runs": { "post": { "operationId": "runs-sync-siccscha-seo-health-auditor", "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/siccscha~seo-health-auditor/run-sync": { "post": { "operationId": "run-sync-siccscha-seo-health-auditor", "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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Website to audit", "type": "array", "description": "One or more start URLs. The Actor crawls all internal pages from here (same host) and audits each one: technical SEO findings, broken links, AI citability, a 0–100 score and ready-to-paste fixes per page.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxPages": { "title": "Maximum pages to audit", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper bound on audited pages. You are only charged per page actually audited. Raise it for a full-site audit — at 25 pages a run costs $1.25.", "default": 25 }, "checkExternalLinks": { "title": "Verify external links too", "type": "boolean", "description": "Also test links pointing to OTHER domains (slower, but finds outbound link rot). Internal links are always verified.", "default": true }, "auditStructuredData": { "title": "Audit structured data (JSON-LD)", "type": "boolean", "description": "Validate every JSON-LD block against what Google actually requires for a rich result — not just \"does it parse\": syntax errors with their position, missing @type, and missing required fields for 18 schema.org types (an Article without a headline is valid JSON and earns nothing).", "default": true }, "maxCrawlDepth": { "title": "Maximum crawl depth", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many clicks away from the start URL to follow. 0 = only the start URLs.", "default": 10 }, "includeHealthyPages": { "title": "Include pages without issues in the dataset", "type": "boolean", "description": "When off, only pages with at least one finding are pushed (cheaper, report-style output). The site summary item is always pushed.", "default": true }, "checkCertificate": { "title": "Check the TLS certificate", "type": "boolean", "description": "One TLS handshake per host to read issuer and expiry date. Flags certificates expiring within 30 days.", "default": true }, "detectOrphanPages": { "title": "Detect orphan pages", "type": "boolean", "description": "Compare sitemap.xml against the internal link graph and report pages that no page on the site links to.", "default": true }, "traceRedirectChains": { "title": "Trace redirect chains", "type": "boolean", "description": "Follow redirects hop by hop to reveal chains and loops instead of only the endpoint. Costs one request per hop, capped at 300 URLs.", "default": true }, "emitFixes": { "title": "Emit ready-to-paste fixes", "type": "boolean", "description": "Add a `fixes` array per page with the exact markup to insert or replace — shortened titles, drafted meta descriptions, canonical/viewport/hreflang tags.", "default": true }, "compareWithPreviousRun": { "title": "Compare with the previous run", "type": "boolean", "description": "Store a baseline per site and report in `changes` which pages got worse, which improved, and which are new. This is what makes a schedule useful.", "default": true }, "auditAiVisibility": { "title": "Audit AI visibility", "type": "boolean", "description": "Check whether AI systems can reach and cite you: which AI crawlers robots.txt allows (training vs. retrieval — only retrieval agents can cite you), llms.txt quality, and which pages carry no text without JavaScript.", "default": true } } }, "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 } } }, "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 } } } } } } } } } }