{ "openapi": "3.0.1", "info": { "title": "SEO Audit & Broken Link Checker: Site Crawler, 404s, Redirects", "description": "Technical SEO site audit crawler (SEO spider): broken links and 404s, redirect chains, missing or duplicate titles and meta descriptions, noindex and canonical problems, and orphan sitemap pages. 37 checks per page, a health score, and alerts on what changed since the last run. Obeys robots.txt.", "version": "0.1", "x-build-id": "RfrFfuh3tsDk3bWDc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stellalytics~seo-site-audit/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stellalytics-seo-site-audit", "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/stellalytics~seo-site-audit/runs": { "post": { "operationId": "runs-sync-stellalytics-seo-site-audit", "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/stellalytics~seo-site-audit/run-sync": { "post": { "operationId": "run-sync-stellalytics-seo-site-audit", "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": "Websites to audit", "type": "array", "description": "One website or start page per line (bare domains get https:// added). The Actor crawls each site from this page and its sitemap, staying on the same site (www. and non-www count as one site). At most 100 sites per run.", "items": { "type": "string" } }, "maxPagesPerSite": { "title": "Maximum pages per site", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop crawling a site after this many pages. Each audited page is one charged result. Up to 10,000.", "default": 200 }, "checkExternalLinks": { "title": "Check external links", "type": "boolean", "description": "Also check links to other websites (one HEAD request each, after that site's robots.txt allows it). Servers that refuse bots (401, 403, 429, 999) are reported as unverified, not broken.", "default": true }, "maxLinkChecks": { "title": "Maximum link checks per site", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Links that are not crawled as pages (external links, files such as PDFs, and internal pages beyond the page limit) are checked with a lightweight request, up to this many per site. Internal links are checked first. Link checks are not charged.", "default": 1000 }, "useSitemap": { "title": "Use the XML sitemap", "type": "boolean", "description": "Read the sitemaps listed in robots.txt (or /sitemap.xml) to find pages no link reaches, flag orphan pages, and check that sitemap URLs return 200 and are indexable.", "default": true }, "includeSubdomains": { "title": "Include subdomains", "type": "boolean", "description": "Also crawl subdomains such as blog.example.com when auditing example.com.", "default": false }, "excludeUrlPatterns": { "title": "Skip URLs containing", "type": "array", "description": "Skip pages whose URL contains any of these texts, for example /tag/ or ?sort=. Useful for shops with filter pages.", "items": { "type": "string" } }, "trackChanges": { "title": "Compare with the previous run", "type": "boolean", "description": "Remember each site's pages and issues in a named key-value store in your Apify account, and report new issues, fixed issues and alerts (for example a page that now returns 404, or became noindex) on the next run. Made for scheduled runs.", "default": true }, "historyName": { "title": "History name", "type": "string", "description": "Keep separate histories for different schedules or clients. Letters, digits, '-' and '_'.", "default": "default" }, "maxConcurrency": { "title": "Parallel requests per site", "minimum": 1, "maximum": 8, "type": "integer", "description": "Requests in flight to the audited site at once. Requests start at most about 6 per second, and a Crawl-delay in robots.txt (up to 10 seconds) is honored.", "default": 4 } } }, "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 } } } } } } } } } }